目次 x
    Googleカレンダー・コネクター
    • 03 Nov 2023
    • 1 読む分
    • 寄稿者
    • 印刷する
    目次

    Googleカレンダー・コネクター

    • 更新日 03 Nov 2023
    • 1 読む分
    • 寄稿者
    • 印刷する
    記事の要約

    Googleカレンダーコネクタ

    チューリップとGoogleカレンダーの連携

    はじめに

    GoogleカレンダーAPIは、ユーザーが自分のGoogleアカウントに設定された適切なアクセス権を使用して、Googleカレンダーのイベントを作成、読み取り、編集することができます。このコネクタの目的は、OAuth認証を使用し、HTTPコネクタを使用してTulipでGoogle Calendar V3 Apiと統合し、インスタンスにインポートできるアウトオブボックスコネクタをお客様に提供することです。

    目的

    このドキュメントでは、Google Calendar V3 API エンドポイントへの HTTP 呼び出しによって構築できる、さまざまな HTTP コネクタ関数について説明します。

    API ドキュメント

    1. Google Calendar

    前提条件

    1. Googleのクラウドコンソールでアカウントを作成し、OAuth 2.0の認証情報を設定する。詳細はGoogleのAPIドキュメントを参照。
    2. Google API ConsoleでGoogle Calendar APIを有効化します。

    チューリップ接続の詳細

    以下の情報をTulipのコネクタに設定する必要があります。

    1. 実行中: クラウド・コネクタ・ホスト
    2. ホスト:www.googleapis.com
    3. ポート:443
    4. TLS: はい
    5. コネクタ認証：OAuth2.0（管理者/オペレータ）
    6. 以下は、渡される必要があるスコープです：
    7. https://www.googleapis.com/auth/calendar
    8. https://www.googleapis.com/auth/calendar.events

    コネクタ機能

    すべてのカレンダーの取得

    目的

    このコネクタは、ユーザーの google カレンダーに存在するすべてのカレンダーを取得します。

    エンドポイント

    エンドポイントへのHTTP GETコール https://www.googleapis.com:443/calendar/v3/users/me/calendarList

    必要な入力

    入力不要

    必要な出力 抽出子

    1. カレンダーID：他のタスクを実行するために使用されるカレンダーの一意の識別子
    2. タイトル：カレンダーのタイトル
    3. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

    すべてのイベントを取得する

    目的

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

    エンドポイント

    エンドポイントへの HTTP GET コール -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events

    必須入力

    渡される URL パラメータは以下のとおりです。

    1. カレンダーID- カレンダーID/ カレンダーIDパラメータの値として "primary "を渡す。Primary "を指定すると、ユーザーのプライマリーカレンダーのすべてのイベントを取得します。

    必要な出力エクストラクタ

    1. カレンダーID：他のタスクを実行するために使用されるカレンダーの一意の識別子
    2. イベントID：特定のイベントに関する詳細を引き出すために使用されるイベントの一意の識別子。
    3. タイトル：イベントのタイトル
    4. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

    フィルタによるイベントの取得

    目的

    このコネクタは、クエリ・パラメータで指定された指定された日付範囲に該当するすべてのイベントをフェッチします。

    エンドポイント

    エンドポイントへの HTTP GET コール -https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events?maxResults={MaxResults}&orderBy=updated&timeMax={MaxTime}&timeMin={MinTime}&singleEvents=true

    必須入力

    渡されるURLパラメータは以下の通りです。

    1. カレンダーIDカレンダーID
    2. MaxResultsフェッチするレコード数
    3. MinTime: フェッチするイベントの開始日時
    4. MaxTime: フェッチするイベントの終了日時

    必要な出力エクストラクタ

    1. カレンダーID：他のタスクを実行するために使用されるカレンダーの一意の識別子
    2. イベントID：他のタスクを実行するために使用されるイベントの一意識別子
    3. タイトル：イベントのタイトル
    4. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

    シングル／グループ／複数ユーザの新規イベントの作成

    目的

    1. ユーザーはイベントタイトル、説明、開始日時、終了日時を入力として渡すことができ、Tulipは指定されたイベントタイトルで新しいイベントを作成します。APIのレスポンスには、ファイルのメタデータとさまざまなプロパティが返されます。
    2. Google Calendar V3 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクタ関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events エンドポイントへのHTTP POSTコール。

    必要な入力

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

    1. カレンダー ID - 選択されたカレンダー ID
    2. イベントタイトル - イベントタイトル
    3. 開始日時- イベント開始日時
    4. 終了日時- イベント終了日時
    5. タイムゾーン - イベントのタイムゾーン
    6. Attendees- イベントの参加者
    7. 場所 - イベントの場所
    8. Description - イベントの説明

    必要な出力エクストラクタ

    1. イベントID：他のタスクを実行するために使用されるイベントの一意の識別子
    2. イベントのタイトル：イベントのタイトル
    3. オーガナイザー：イベントのオーガナイザー名
    4. レスポンスと共に返される追加パラメータは、出力パラメータの一部として含めることができます。

    単一/グループ/複数ユーザー用の新規定期イベントの作成

    目的

    1. ユーザーは、イベントタイトル、説明、開始日時、終了日時、反復終了日時、反復タイプ、およびその他のパラメータを入力として渡すことができ、Tulipは指定されたイベントタイトルで新しいイベントを作成します。APIのレスポンスは、ファイルのメタデータと各種プロパティになります。
    2. Google Calendar V3 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events エンドポイントへのHTTP POSTコール。

    必要な入力

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

    1. カレンダー ID - 選択されたカレンダー ID
    2. イベントタイトル - イベントタイトル
    3. 開始日時- イベント開始日時
    4. 終了日時- イベント終了日時
    5. タイムゾーン - イベントのタイムゾーン
    6. Attendees- イベントの参加者
    7. Description - イベントの説明
    8. 場所 - イベントの場所
    9. Recurrence Rule- 再来ルールには、イベントがいつどのように再来するかという詳細が 含まれる。以下は、アプリ内で追加されたいくつかの再帰ルールのリストである(参考文献[RFC5545](https://tools.ietf.org/html/rfc5545

    セクション-3.8.5)を参照)：

    、毎日発生する：

    RRULE:FREQ=DAY;COUNT=の場合

    例:RRULE:FREQ=DAILY;COUNT=5

    例：RRULE:FREQ=DAYLY;COUNT=5 イベント開始日から5日間、同じ開始時刻と終了時刻にイベントが発生する。

    まで毎日：

    RRULE:FREQ=DAYALY;UNDER=まで。

    Ex:RRULE:FREQ=DAILY;UNTIL=20210924T000000Z

    イベント開始日から「2021年9月24日」まで、同じ開始時刻と終了時刻のイベントが毎日発生します。

    、毎週発生：

    RRULE:FREQ=毎週;COUNT=の場合。

    例：RRULE:FREQ=WEEKLY;COUNT=3

    イベント開始日の平日の同じ曜日で、同じ開始時刻と終了時刻のイベントが3週間ごとに発生します。

    まで毎週：

    RRULE:FREQ=WEEKLY;until= まで。

    Ex:RRULE:FREQ=WEEKLY;UNTIL=20210924T000000Z

    イベント開始日と同じ平日の同じ曜日で、同じ開始時刻と終了時刻のイベントが「2021年9月24日」まで毎週発生する。

    毎週火曜日、隔月:(これ)

    rrule:freq=monthly;interval=;byday=

    例：RRULE:FREQ=MONTHLY;INTERVAL=2;BYDAY=TU

    イベントは、同じ開始時刻と終了時刻で、隔月の火曜日に発生する。

    必要な出力エクストラクタ

    1. イベントID：他のタスクを実行するために使用されるイベントの一意識別子。
    2. イベントのタイトル：イベントのタイトル
    3. オーガナイザー：イベントのオーガナイザー名
    4. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができる。

    イベント・メタデータの更新

    目的

    1. ユーザーは、イベントのタイトル、説明、開始日時、終了日時、およびその他のパラメータを入力として渡すことができ、Tulipは提供された入力で既存のイベントを更新します。APIのレスポンスは、ファイルのメタデータと様々なプロパティになります。
    2. Google Calendar V3 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクタ関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*のエンドポイントへのHTTP PATCHコール。

    必須入力

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

    1. カレンダーID- 選択されたカレンダーID
    2. イベントID - 選択されたイベントID
    3. イベントタイトル - イベントタイトル
    4. 開始日時- イベント開始日時
    5. 終了日 時刻- イベント終了日 時刻
    6. Time Zone - イベントのタイムゾーン
    7. 場所-イベントの場所
    8. Description - イベントの説明

    必要な出力エクストラクタ

    1. イベントID：他のタスクを実行するために使用されるイベントの一意の識別子。
    2. イベントのタイトル：イベントのタイトル
    3. イベントの説明：イベントのタイトル
    4. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

    定期イベントの更新

    目的

    1. ユーザーは、イベントのタイトル、説明、開始日時、終了日時、再帰ルール、およびその他のパラメータを入力として渡すことができ、Tulipは提供された入力で既存のイベントを更新します。APIのレスポンスは、ファイルのメタデータとさまざまなプロパティになります。
    2. Google Calendar V3 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数のいずれかでさらに使用することができます。

    エンドポイント

    https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}?sendUpdates=all&fields=*のエンドポイントへのHTTP PATCHコール。

    必須入力

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

    1. カレンダーID- 選択されたカレンダーID
    2. イベントID - 選択されたイベントID
    3. イベントタイトル - イベントタイトル
    4. 開始日時- イベント開始日時
    5. 終了日 時刻- イベント終了日 時刻
    6. Time Zone - イベントのタイムゾーン
    7. 場所-イベントの場所
    8. Description- イベントの説明
    9. Recurrence Rule- 再来ルールには、イベントがいつどのように再来するかに関するすべての詳細が含まれます。再帰ルールの詳細については、前述のドキュメントに記載されている、アプリ内で追加されたいくつかの再帰ルールのリストを参照してください)

    必要な出力エキストラクター

    1. イベントID：他のタスクを実行するために使用されるイベントの一意の識別子。
    2. イベントのタイトル：イベントのタイトル。
    3. イベントの説明：イベントのタイトル
    4. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

    イベントの削除

    目的

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

    エンドポイント

    エンドポイント-https://www.googleapis.com:443/calendar/v3/calendars/{CalendarID}/events/{EventID}へのHTTP DELETEコール。

    必要な入力

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

    1. カレンダーID- 選択されたカレンダーID
    2. イベントID- 選択されたイベントID
    この記事は役に立ちましたか?
    What's Next
    プラットフォーム
    ライブラリ
    製品情報
    リソース
    既存ユーザー
    お問い合わせ
    営業担当
    • +1 833 468 8547
    • sales@tulip.co
    著作権 © Tulip Interfaces.無断転載禁止