Outlook Calendar

Outlook Calendar連携に関するアクション一覧です。

GetOutlookCalendarEvents

概要

GetOutlookCalendarEvents は、自身のアカウントで管理されているOutlook Calendarに登録されている予定情報を取得することができます。予定の取得対象期間はfrom、toで設定します。また、queryを設定することで任意の入力値と予定に含まれる情報からフィルタすることができます。返却されるレスポンスはデフォルトで最大250件ですが、パラメータの設定によって最大 1000 件まで取得することが可能です。

パラメーター

*は、必須パラメーター

名前 型 概要 例
provider* 文字列 Outlook Calendarから予定情報を取得するのに必要なプロバイダーID outlookcalendar_xxxxxxxx
calendarId* 文字列 Outlook CalendarのID AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA=
from 文字列 取得期間の開始日時。取得対象かどうかはカレンダーに登録されている各予定の終了時刻で判定されます。 例えば、指定期間が2021年1月1日の10:30〜17:00で2021年1月1日の10:00〜11:00の予定が登録されている場合、予定の開始時刻は10:00で指定期間外ですが、終了時刻が11:00で指定期間内ですのでこの予定は取得対象となります。タイムゾーンオフセットが必須。以下の形式のみ有効です。YYYY:MM:DDT:hh:mm+09:00 2020-08-15T12:00:00+09:00(日本標準時)
to 文字列 取得期間の終了日時。取得対象かどうかはカレンダーに登録されている各予定の開始時刻で判定されます。 例えば、指定期間が2021年1月1日の10:30〜17:00で2021年1月1日の16:30〜17:30の予定が登録されている場合、予定の終了時刻は17:30で指定期間外ですが、開始時刻が16:30で指定期間内ですのでこの予定は取得対象となります。タイムゾーンオフセットが必須。以下の形式のみ有効です。YYYY:MM:DDT:hh:mm+09:00 2020-08-18T12:00:00+09:00(日本標準時)
query 文字列 検索ワード。任意の入力値に一致する用語を含むイベントを検索します 定例MTG
maxResults 数値 リクエストで返されるデータの数。最大で、1000件。 250 (デフォルト値)

アウトプット

タイプ 型 概要 例
JSON オブジェクト JSONレスポンス ＊使用例を参照

使用例

# Outlookカレンダーから予定を取得
+get_outlook_calendar_events_1:
  action>: GetOutlookCalendarEvents
  display_name>: 'Outlookカレンダーから予定を取得'
  provider: outlookcalendar_xxxxxxxx
  calendarId: 'AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA='
  from: '2025-07-16T12:00:00+09:00'
  to: '2025-07-16T13:00:00+09:00'
  keyword: 'Test Event'
  maxResults: 250
  private: false
  meta:
    display:
      provider:
        type: chip
        label: 'Outlook Calendar (taro.yamada@example.com)'
        icon: outlookcalendar
    action:
      disabled: false

# {
#   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('outlook_xxxxxxxx%40outlook.com')/calendars('AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA%3D')/calendarView",
#   "value": [
#     {
#       "@odata.etag": "W/\"XBSDaKUpAk6q95+EulsVeQAEZ/mI/w==\"",
#       "id": "AQMkADAwATMwMAItMzQ4NC1hYQA0Ny0wMAItMDAKAEYAAAPrI59o-JW5RbsqK3Erv802BwBcFINopSkCTqr3n4S6WxV5AAACAQ0AAABcFINopSkCTqr3n4S6WxV5AARoAYvLAAAA",
#       "createdDateTime": "2025-07-16T09:34:48.8877604Z",
#       "lastModifiedDateTime": "2025-07-16T09:36:51.1857553Z",
#       "changeKey": "XBSDaKUpAk6q95+EulsVeQAEZ/mI/w==",
#       "categories": [],
#       "transactionId": null,
#       "originalStartTimeZone": "Asia/Tokyo",
#       "originalEndTimeZone": "Asia/Tokyo",
#       "iCalUId": "040000008200E00074C5B7101A82E008000000008D86ACDF34F6DB01000000000000000010000000437FC25CDD48CB4A95B7B91BB789D453",
#       "uid": "040000008200E00074C5B7101A82E008000000008D86ACDF34F6DB01000000000000000010000000437FC25CDD48CB4A95B7B91BB789D453",
#       "reminderMinutesBeforeStart": 15,
#       "isReminderOn": true,
#       "hasAttachments": false,
#       "subject": "Test Event",
#       "bodyPreview": "This is a test event",
#       "importance": "normal",
#       "sensitivity": "normal",
#       "isAllDay": false,
#       "isCancelled": false,
#       "isOrganizer": true,
#       "responseRequested": true,
#       "seriesMasterId": null,
#       "showAs": "busy",
#       "type": "singleInstance",
#       "webLink": "https://outlook.live.com/owa/?itemid=AQMkADAwATMwMAItMzQ4NC1hYQA0Ny0wMAItMDAKAEYAAAPrI59o%2FJW5RbsqK3Erv802BwBcFINopSkCTqr3n4S6WxV5AAACAQ0AAABcFINopSkCTqr3n4S6WxV5AARoAYvLAAAA&exvsurl=1&path=/calendar/item",
#       "onlineMeetingUrl": null,
#       "isOnlineMeeting": false,
#       "onlineMeetingProvider": "unknown",
#       "allowNewTimeProposals": true,
#       "occurrenceId": null,
#       "isDraft": false,
#       "hideAttendees": false,
#       "responseStatus": {
#         "response": "organizer",
#         "time": "0001-01-01T00:00:00Z"
#       },
#       "body": {
#         "contentType": "html",
#         "content": "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n<meta name=\"Generator\" content=\"Microsoft Exchange Server\">\r\n<!-- converted from text -->\r\n<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style></head>\r\n<body>\r\n<font size=\"2\"><span style=\"font-size:11pt;\"><div class=\"PlainText\">This is a test event</div></span></font>\r\n</body>\r\n</html>\r\n"
#       },
#       "start": {
#         "dateTime": "2025-07-16T03:00:00.0000000",
#         "timeZone": "UTC"
#       },
#       "end": {
#         "dateTime": "2025-07-16T04:00:00.0000000",
#         "timeZone": "UTC"
#       },
#       "location": {
#         "displayName": "",
#         "locationType": "default",
#         "uniqueIdType": "unknown",
#         "address": {},
#         "coordinates": {}
#       },
#       "locations": [],
#       "recurrence": null,
#       "attendees": [],
#       "organizer": {
#         "emailAddress": {
#           "name": "taro yamada",
#           "address": "outlook_xxxxxxxx@outlook.com"
#         }
#       },
#       "onlineMeeting": null
#     }
#   ]
# }

CreateOutlookCalendarEvent

概要

CreateOutlookCalendarEvent は、Outlook Calendar に新しいイベントを作成するためのアクションです。タイトルや日時、ゲストの追加、Microsoft Teams の会議リンクの作成などが可能です。

パラメーター

*は、必須パラメーター

名前 型 概要 例
provider* 文字列 Outlook Calendar にイベントを作成するのに必要なプロバイダー ID outlookcalendar_xxxxxxxx
calendarId* 文字列 Outlook Calendar の ID AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA=
event_title 文字列 イベントのタイトル Test Event
all_day* 真偽値 終日イベントかどうかを指定します (デフォルト: false) false
start* 文字列 イベントの開始日時(YYYY-MM-DDTHH:mm:ss+09:00)。終日イベントの場合、YYYY-MM-DD形式で日付を指定します。 2025-03-17T12:00:00+09:00(日本標準時)
end* 文字列 イベントの終了日時(YYYY-MM-DDTHH:mm:ss+09:00)。終日イベントの場合、YYYY-MM-DD形式で日付を指定します 2025-03-17T13:00:00+09:00(日本標準時)
resources 文字列 予定に関連するリソース。リソースの追加方法は"Outlook Calendarのリソースの追加方法"の項をご確認ください。 room@bizsf.onmicrosoft.com
description 文字列 イベントの詳細説明 This is a test event
add_microsoft_team* 真偽値 Microsoft Teams の会議リンクを追加するかどうか (デフォルト: false) true
guests 文字列 招待するゲストのメールアドレスをカンマ区切りで指定します hanako.sato@example.com

アウトプット

タイプ 型 概要 例
JSON オブジェクト JSON レスポンス ＊使用例を参照

使用例

# Outlookカレンダーに予定を作成
+create_outlook_calendar_event_1:
  action>: CreateOutlookCalendarEvent
  display_name>: 'Outlookカレンダーに予定を作成'
  provider: outlookcalendar_xxxxxxxx
  calendarId: 'AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA='
  event_title: 'Test Event'
  all_day: false
  start: '2025-07-16T12:00:00+09:00'
  end: '2025-07-16T13:00:00+09:00'
  resources: ''
  description: 'This is a test event'
  add_microsoft_team: false
  guests: ''
  private: false
  meta:
    display:
      provider:
        type: chip
        label: 'Outlook Calendar (taro.yamada@example.com)'
        icon: outlookcalendar
    action:
      disabled: false

# {
#   "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#users('outlook_xxxxxxxx%40outlook.com')/calendars('AQMkADAwADMwMDEtZmZmZi1iYTAwLTAwMDAtMDAwMDAwMDAwMDAwAAEGAARsB1cAAGxB1cAAAEdD6AAA%3D')/events/$entity",
#   "@odata.etag": "W/\"XBSDaKUpAk6q95+EulsVeQAEZ/mJFA==\"",
#   "id": "AQMkADAwATMwMAItMzQ4NC1hYQA0Ny0wMAItMDAKAEYAAAPrI59o-JW5RbsqK3Erv802BwBcFINopSkCTqr3n4S6WxV5AAACAQ0AAABcFINopSkCTqr3n4S6WxV5AARoAYvMAAAA",
#   "createdDateTime": "2025-07-16T09:38:46.2201574Z",
#   "lastModifiedDateTime": "2025-07-16T09:38:46.285163Z",
#   "changeKey": "XBSDaKUpAk6q95+EulsVeQAEZ/mJFA==",
#   "categories": [],
#   "transactionId": null,
#   "originalStartTimeZone": "Asia/Tokyo",
#   "originalEndTimeZone": "Asia/Tokyo",
#   "iCalUId": "040000008200E00074C5B7101A82E008000000003265226D35F6DB010000000000000000100000008FFF3B91A8C6F44998636A641FB5A543",
#   "uid": "040000008200E00074C5B7101A82E008000000003265226D35F6DB010000000000000000100000008FFF3B91A8C6F44998636A641FB5A543",
#   "reminderMinutesBeforeStart": 15,
#   "isReminderOn": true,
#   "hasAttachments": false,
#   "subject": "Test Event",
#   "bodyPreview": "This is a test event",
#   "importance": "normal",
#   "sensitivity": "normal",
#   "isAllDay": false,
#   "isCancelled": false,
#   "isOrganizer": true,
#   "responseRequested": true,
#   "seriesMasterId": null,
#   "showAs": "busy",
#   "type": "singleInstance",
#   "webLink": "https://outlook.live.com/owa/?itemid=AQMkADAwATMwMAItMzQ4NC1hYQA0Ny0wMAItMDAKAEYAAAPrI59o%2FJW5RbsqK3Erv802BwBcFINopSkCTqr3n4S6WxV5AAACAQ0AAABcFINopSkCTqr3n4S6WxV5AARoAYvMAAAA&exvsurl=1&path=/calendar/item",
#   "onlineMeetingUrl": null,
#   "isOnlineMeeting": false,
#   "onlineMeetingProvider": "unknown",
#   "allowNewTimeProposals": true,
#   "occurrenceId": null,
#   "isDraft": false,
#   "hideAttendees": false,
#   "responseStatus": {
#     "response": "organizer",
#     "time": "0001-01-01T00:00:00Z"
#   },
#   "body": {
#     "contentType": "html",
#     "content": "<html><head><meta http-equiv=\"Content-Type\" content=\"text/html; charset=utf-8\">\r\n<meta name=\"Generator\" content=\"Microsoft Exchange Server\">\r\n<!-- converted from text -->\r\n<style><!-- .EmailQuote { margin-left: 1pt; padding-left: 4pt; border-left: #800000 2px solid; } --></style></head>\r\n<body>\r\n<font size=\"2\"><span style=\"font-size:11pt;\"><div class=\"PlainText\">This is a test event</div></span></font>\r\n</body>\r\n</html>\r\n"
#   },
#   "start": {
#     "dateTime": "2025-07-16T12:00:00.0000000",
#     "timeZone": "Asia/Tokyo"
#   },
#   "end": {
#     "dateTime": "2025-07-16T13:00:00.0000000",
#     "timeZone": "Asia/Tokyo"
#   },
#   "location": {
#     "displayName": "",
#     "locationType": "default",
#     "uniqueIdType": "unknown",
#     "address": {},
#     "coordinates": {}
#   },
#   "locations": [],
#   "recurrence": null,
#   "attendees": [],
#   "organizer": {
#     "emailAddress": {
#       "name": "taro yamada",
#       "address": "outlook_xxxxxxxx@outlook.com"
#     }
#   },
#   "onlineMeeting": null
# }

Outlook Calendarのリソース追加方法

Outlook Calendarのリソースを管理するには、組織の管理者（Admin）権限が必要です。個人アカウントではご利用いただけません。

リソースの追加は、リソース管理画面から、＋ボタンを押す、リソースの詳細情報をご入力ください。

現在の Microsoft Graph API の仕様では、リソースピッカーに表示されるのは「会議室」のみとなっており、備品など他のリソースは対象外です。

results matching ""

    No results matching ""