MENU
    マイクロソフト・カレンダー・コネクター
    • 13 Jan 2025
    • 1 読む分
    • 寄稿者

    マイクロソフト・カレンダー・コネクター


    記事の要約

    To download the app, visit: Library

    マイクロソフトのカレンダー用グラフAPIとの統合

    はじめに

    Microsoft Calendar APIは、ユーザーがM365アカウントに設定された適切なアクセス権を使って、Microsoftカレンダーイベントを作成、閲覧、編集することを可能にします。このコネクタの目的は、HTTPコネクタを使用してMicrosoftのグラフAPI(v1.0)を使用してMicrosoftとTulipを統合し、インスタンスにインポートすることができるアウトオブボックスコネクタをお客様に提供することです。

    目的

    MicrosoftのGraph API(v1.0)にHTTPコールを行うことで構築できるさまざまなコネクタ機能を紹介し、Microsoftカレンダーイベントと対話することで、さまざまなユースケースで活用できるカレンダー上のさまざまな読み取り/書き込みアクションを紹介します。

    APIドキュメント

    Microsoft Graph API ドキュメント

    前提条件

    1. Microsoft 365 でアカウントを作成し、Microsoft Entra ID で OAuth 2.0 認証情報を設定する。
    2. Microsoft ポータルに必要なスコープで API を登録する。Azure - Entra ID

    Excel 用コネクタのセットアップ動画です:

    カレンダー コネクタも同じ手順で設定できます。

    チューリップ接続の詳細

    以下の情報を Tulip の

    コネクタ。

    1. 実行中:クラウド・コネクタ・ホスト
    2. ホスト:graph.microsoft.com
    3. ポート:443
    4. TLS: はい

    OAuth 2: 認証はすべてのコネクタ機能に引き継がれます。

    コネクタ機能

    1) すべてのカレンダーイベントを取得

    目的

    このコネクタは、M365カレンダーからすべてのカレンダーイベントを取得します。

    エンドポイント

    エンドポイントへのHTTP GETコール: https://graph.micrsoft.com:443/v1.0/me/events

    必要な入力

    入力不要

    出力エクストラクタ

    1. eventID: 他のタスクを実行するために使用されるイベントの一意識別子。
    2. eventSubject: イベントのサブジェクト:イベントの件名。
    3. eventContent: イベントの内容:イベントの内容。
    4. eventStartDate: イベントの開始日時:イベントの開始日時。
    5. eventEndDate: 終了日時:イベントの終了日時。
    6. eventLocation: イベントの場所:イベントの場所。
    7. eventAttendees: イベントの出席者:イベントの出席者。
    8. eventOrganizer: イベントの主催者:イベントの主催者。
    9. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含まれる。

    2) ユーザーミーティングのスケジュール取得

    目的

    このコネクタは、ユーザー、配布リスト、またはリソース(会議室または設備)のコレクションについて、指定された期間の空き/空き時間情報を取得します。

    エンドポイント

    エンドポイントへの HTTP GET コール -https://graph.microsoft.com:443/v1.0/me/calendar/getSchedule

    必要な入力

    リクエスト・ボディに渡すパラメータは以下のとおりです。

    1. メールアドレス:可用性情報を取得するユーザー、配布リスト、またはリソースの SMTP アドレスの集合。
    2. スケジュール開始日 時刻:期間を開始する日付、時刻、タイムゾーン。
    3. スケジュール終了日 時刻:期間が終了する日付、時刻、タイムゾーン。
    4. タイムゾーン:イベントのタイムゾーン。

    出力エクストラクタ

    1. scheduleUserId:スケジュールユーザーのメールアドレス。
    2. startTime: 期間が開始する日時とタイムゾーン。
    3. endTime: 期間が終了する日付、時間、タイムゾーン。
    4. timeZone: タイムゾーン。
    5. scheduleStatus: スケジュールステータス:ユーザースケジュールの応答ステータス。
    6. scheduleSubject:スケジュールされたイベントの件名。
    7. scheduleLocation:スケジュールされたイベントの場所。
    8. scheduleStartDateTime: スケジュールされたイベントの開始日時。
    9. scheduleEndDateTime: スケジュールされたイベントの終了日時。

    3) イベントの作成

    目的

    1. ユーザーは、イベントの件名、内容、開始日時、終了日時、およびその他のパラメータを入力として渡すことができます。APIのレスポンスは、カレンダーイベントのメタデータとさまざまなプロパティになります。これはさらに、イベントの取得と更新に使用できます。
    2. このコネクタは、ユーザーのデフォルト・カレンダー、または特定のユーザー、グループ・ユーザー、または複数のユーザーの指定されたカレンダーにイベントを作成できます。
    3. 情報は、Microsoft Graph V1.0 APIから取得され、Tulipアプリ、Tulipテーブル、または他のコネクタ関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    エンドポイントへのHTTP POSTコール: https://graph.microsoft.com:443/v1.0/me/events

    必要な入力

    リクエスト・ボディに渡すパラメータは以下のとおりです。

    1. イベントのサブジェクト:イベントの件名
    2. イベントの内容:イベントの内容
    3. イベント開始日時:イベントの開始日時
    4. イベントのタイムゾーンイベントのタイムゾーン
    5. イベント終了日時:イベントの終了日時
    6. イベントの場所:イベントの場所
    7. 参加者のメールアドレス参加者のメールアドレス

    出力抽出

    1. eventId:作成されたイベントID
    2. eventTimezone:イベントのタイムゾーン
    3. eventSubject:イベントの件名
    4. eventBody: イベントの本文:イベントの内容
    5. eventStartDateTime: イベントの開始日時
    6. eventEndDateTime: イベントの終了日時
    7. eventLocation: イベントの場所:イベントの場所
    8. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含まれる。

    4) 定期イベントの作成

    目的

    1. ユーザーは、イベントの件名、内容、開始日時、終了日時、およびその他のパラメータを入力として渡すことができます。APIのレスポンスは、カレンダーイベントのメタデータとさまざまなプロパティになります。これはさらに、イベントの取得と更新に使用できます。
    2. このコネクタは、ユーザーのデフォルト・カレンダーと、ユーザーまたはユーザー・グループの指定されたカレンダーに、繰り返しイベントを作成します。
    3. 情報は、Microsoft Graph V1.0 APIから取得され、Tulipアプリ、Tulipテーブル、または他のコネクタ関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    エンドポイント https://graph.microsoft.com:443/v1.0/me/events への HTTP POST コール。

    必要な入力

    リクエスト・ボディに渡されるパラメータは以下のとおりです。

    1. イベントのサブジェクト:イベントの件名
    2. イベントの内容:イベントの内容
    3. イベント開始日時:イベントの開始日時
    4. イベントのタイムゾーンイベントのタイムゾーン
    5. イベント終了日時:イベントの終了日時
    6. イベントの場所:イベントの場所
    7. 参加者のメールアドレス参加者のメールアドレス
    8. 再発イベントタイプ:再発イベントタイプ
    9. 再発の曜日再帰イベントの曜日
    10. 再帰開始日再帰イベント開始日
    11. 反復終了日:再帰イベント終了日

    出力抽出子

    1. eventId:作成されたイベントID
    2. eventTimezone:イベントのタイムゾーン
    3. eventSubject:イベントの件名
    4. eventBody: イベントの本文:イベントの内容
    5. eventStartDateTime: イベントの開始日時
    6. eventEndDateTime: イベントの終了日時
    7. eventLocation: イベントの場所:イベントの場所
    8. eventRecurrenceRangeStartDate: 再発範囲開始日:再帰イベントの開始日。
    9. eventRecurrenceRangeEndDate: 再来イベントの終了日:再帰イベントの終了日。
    10. eventAttendees: イベントの出席者:イベントの出席者。
    11. eventOrganizer: イベントの主催者:イベントの主催者。
    12. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含まれる。

    5) イベントの更新

    目的

    1. ユーザーは、イベントID、件名、コンテンツ、その他のパラメータを入力として渡すことができ、Tulipはカレンダー内のイベントを更新します。APIのレスポンスは、カレンダーイベントのメタデータとさまざまなプロパティになります。
    2. Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクタ関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    エンドポイントhttps://graph.microsoft.com:443/v1.0/me/events/{eventID}へのHTTP PATCHコール。

    必須入力

    リクエスト・ボディとして送信されるパラメータは以下のとおりです。

    1. イベントのサブジェクト:イベントの件名
    2. イベント・コンテンツ:イベントの内容
    3. Event Start Date Time: イベントの開始時刻。
    4. Event TimeZone: イベントのタイムゾーン
    5. イベント終了日時:イベントの終了日時
    6. イベントの場所:イベントの場所
    7. 参加者のメールアドレス参加者のメールアドレス

    出力抽出

    1. eventId:作成されたイベントID
    2. eventTimezone:イベントのタイムゾーン
    3. eventSubject:イベントの件名
    4. eventBody: イベントの本文:イベントの内容
    5. eventStartDateTime: イベントの開始日時
    6. eventEndDateTime: イベントの終了日時
    7. eventLocation: イベントの場所:イベントの場所
    8. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含まれる。

    6) イベントの削除

    目的

    1. イベントIDを入力すると、そのイベントを削除します。

    エンドポイント

    エンドポイントへのHTTP DELETEコール - https://graph.microsoft.com:443/v1.0/me/events/{eventID}

    必須入力

    リクエストボディとして送信されるパラメータは以下のとおりです。

    1. イベントID - イベントID

    その他の情報

    Microsoft Connectorに関する詳細情報をご覧ください。


    この記事は役に立ちましたか?