メインコンテンツへスキップ

​
概要

Outlook カレンダー ツールを使用すると、イベントの作成、検索、更新、削除など、Outlook カレンダーに関するさまざまなタスクを Microsoft Graph API を使って自動化できます。

​
主な機能

  • OUTLOOK_CALENDAR_FIND_EVENT
    • 指定した期間内でイベントを検索、または検索クエリでイベントを検索
  • OUTLOOK_CALENDAR_CREATE_EVENT
    • 指定したカレンダーに新しいイベントを作成
  • OUTLOOK_CALENDAR_UPDATE_EVENT
    • 既存のイベントを新しい詳細情報で更新
  • OUTLOOK_CALENDAR_DELETE_EVENT
    • Outlook カレンダーからイベントを削除

​
認証

Outlook カレンダー API を使用するには、Jinba シークレットダッシュボード にアクセスし、Microsoft アカウントで認証してください。これにより、新しい OAuth トークンが生成されます。 注意：API キーは機密情報として扱い、公開リポジトリにコミットしないでください。 詳細については、こちらをクリックしてください。

​
例：イベントの作成、更新、検索、削除

- id: find_before
  tool: OUTLOOK_CALENDAR_FIND_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: timezone
      value: "+09:00"
    - name: time_min
      value: 2025-01-01T00:00:00Z
    - name: time_max
      value: 2025-01-31T23:59:59Z
    - name: query
      value: テストイベント

- id: create_event
  tool: OUTLOOK_CALENDAR_CREATE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: summary
      value: テストイベント
    - name: description
      value: これはテストイベントです
    - name: timezone
      value: "+09:00"
    - name: start
      value: 2025-01-15T14:00:00
    - name: end
      value: 2025-01-15T15:00:00
    - name: attendees
      value: ""
    - name: content_type
      value: HTML

- id: update_event
  tool: OUTLOOK_CALENDAR_UPDATE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: event_id
      value: "{{steps.create_event.result.event.id}}"
    - name: summary
      value: テストイベント（更新済み）
    - name: description
      value: このイベントは更新されました
    - name: timezone
      value: "+09:00"
    - name: start
      value: 2025-01-15T15:00:00
    - name: end
      value: 2025-01-15T16:00:00
    - name: content_type
      value: HTML

- id: find_after_update
  tool: OUTLOOK_CALENDAR_FIND_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: calendar_id
      value: default
    - name: timezone
      value: "+09:00"
    - name: time_min
      value: 2025-01-01T00:00:00Z
    - name: time_max
      value: 2025-01-31T23:59:59Z
    - name: query
      value: "テストイベント（更新済み）"

- id: delete_event
  tool: OUTLOOK_CALENDAR_DELETE_EVENT
  config:
    - name: token
      value: "{{secrets.MICROSOFT_GRAPH_OUTLOOK_CALENDAR}}"
  input:
    - name: event_id
      value: "{{steps.create_event.result.event.id}}"

​
ツール詳細

​
OUTLOOK_CALENDAR_FIND_EVENT

指定した期間内または検索クエリで Outlook カレンダーのイベントを検索します。 入力パラメータ:
  • calendar_id - カレンダー ID（デフォルト: “default”）
  • query - 検索クエリ（イベントタイトルの部分一致）
  • timezone - タイムゾーン（必須、例: “Z”, “UTC”, “+09:00”）
  • time_min - 開始時刻（RFC3339 形式）
  • time_max - 終了時刻（RFC3339 形式）
  • top - 返すイベントの最大数（1-50、デフォルト: 10）
出力:
  • events - マッチしたイベントの配列（id、subject、start、end、organizer、location、webLink を含む）

​
OUTLOOK_CALENDAR_CREATE_EVENT

Outlook カレンダーに新しいイベントを作成します。 入力パラメータ:
  • calendar_id - カレンダー ID（デフォルト: “default”）
  • summary - イベントタイトル（必須）
  • description - イベント説明（オプション）
  • timezone - タイムゾーン（必須、例: “Z”, “UTC”, “+09:00”）
  • start - イベント開始時刻（RFC3339 形式、必須）
  • end - イベント終了時刻（RFC3339 形式、必須）
  • attendees - メールアドレスのカンマ区切りリスト（オプション）
  • content_type - 説明のコンテンツタイプ: “HTML” または “Text”（デフォルト: “HTML”）
出力:
  • event - 作成されたイベント（id と webLink を含む）

​
OUTLOOK_CALENDAR_UPDATE_EVENT

Outlook カレンダーの既存イベントを更新します。 入力パラメータ:
  • event_id - 更新するイベント ID（必須）
  • summary - 新しいイベントタイトル（オプション）
  • description - 新しいイベント説明（オプション）
  • timezone - タイムゾーン（必須、例: “Z”, “UTC”, “+09:00”）
  • start - 新しいイベント開始時刻（RFC3339 形式、オプション、end が必要）
  • end - 新しいイベント終了時刻（RFC3339 形式、オプション、start が必要）
  • attendees - 新しい参加者リスト（オプション、既存の参加者を置き換える）
  • content_type - 説明のコンテンツタイプ: “HTML” または “Text”
出力:
  • event - 更新されたイベント（id と webLink を含む）

​
OUTLOOK_CALENDAR_DELETE_EVENT

Outlook カレンダーからイベントを削除します。 入力パラメータ:
  • event_id - 削除するイベント ID（必須）
出力:
  • status - 削除リクエストの HTTP ステータスコード