Google Calendar モジュール

Adobe Workfront Fusion シナリオでは、Google Calendar を使用するワークフローを自動化したり、複数のサードパーティアプリケーションやサービスに接続したりすることができます。

シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。

モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。

アクセス要件

この記事で説明している機能を使用するには、次のアクセス権が必要です。

Adobe Workfront プラン*
Pro 以降
Adobe Workfront ライセンス*
Plan、Work
Adobe Workfront Fusion ライセンス**

現在のライセンス要件:Workfront Fusion ライセンス要件なし。

または

従来のライセンス要件:Workfront Fusion for Work Automation and Integration

製品

現在の製品要件:Select または Prime Adobe Workfront プランがある場合、この記事で説明する機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

従来の製品要件:この記事で説明している機能を使用するには、Adobe Workfront Fusion と Adobe Workfrontを組織で購入する必要があります。

ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Google Calendar モジュールを使用するには、Google アカウントが必要です。

Google カレンダー API 情報

Google カレンダーコネクタは以下を使用します。

ベース URL
https://www.googleapis.com/calendar/v3
API バージョン
v3
API タグ
v5.4.5

Google Calendar モジュールとそのフィールド

Google Calendar モジュールを設定する際、Workfront Fusion に以下のフィールドが表示されます。これらに加えて、アプリまたはサービスのアクセスレベルなどの要因に応じて、追加の Google Calendar フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。

イベント

イベントを監視

このトリガーモジュールは、指定したカレンダーで新しいイベントが追加、更新、削除、開始、または終了された場合に、シナリオを実行します。このモジュールは、レコードに関連付けられたすべての標準フィールドと、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar
モジュールを使用するカレンダーを選択します。
Watch Events
イベントを「作成日」、「更新日」、「開始日」、「終了日」のどれで監視するかを選択します。
Show deleted events
削除されたイベントを含めるには、このオプションを有効にします。
Query
検索するテキストを入力します。
Limit
1 回のサイクル中に Workfront Fusion が処理する結果の最大数(シナリオ実行あたりの繰り返し数)を設定します。値が大きすぎると、指定されたサードパーティサービス側で接続が中断される可能性があります(タイムアウト)。Workfront Fusion はこれに影響しません。より小さい値を設定し、最大サイクル数としてより大きい値を定義するか、シナリオをより頻繁に実行することをお勧めします。

イベントを検索

このアクションモジュールは、選択したカレンダー内のイベントを検索します。

カレンダーと検索のパラメーターを指定します。

このモジュールは、イベントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続を作成 - 基本手順を参照してください。
Calendar ID
検索するカレンダーを選択します。
Start date

イベントが開始する日付を入力またはマッピングします。また、このモジュールは、この日付より前に開始し、入力された開始日にまだ発生しているイベントを取得します。

サポートされる日付と時刻の形式の一覧については、Adobe Workfront Fusion での型強制を参照してください。

End date

イベントが終了する日付を入力またはマッピングします。

サポートされる日付と時刻の形式の一覧については、Adobe Workfront Fusion での型強制を参照してください。

Single events
このオプションを有効にすると、繰り返しイベントが単一のインスタンスとして処理されます。例えば、週次ミーティングがあり、このオプションが有効な場合、モジュールは各週のミーティングを個別のイベントとして返します。
Query
検索する検索語を入力またはマッピングします。
Order by

結果で返されるイベントの順序を選択します。

  • Start Time:開始日時(昇順)で並べ替えます。これは、単一のイベントに対するクエリ時にのみ使用できます。
  • Updated Time:最終変更時間(昇順)で並べ替えます。
Limit
Workfront Fusion が 1 回の実行サイクルで返すイベントの数の上限を設定します。

イベントを取得

このアクションモジュールは、指定されたカレンダー内の 1 つのイベントのメタデータを返します。

カレンダーとイベントを指定します。

このモジュールは、イベントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
取得するイベントが含まれるカレンダーの ID を入力またはマッピングします。
Event ID
取得する既存の Google Calendar イベントのイベント ID を入力します。

イベントを作成

このアクションモジュールは、イベントを作成します。

イベントのカレンダーとパラメーターを指定します。

このモジュールは、イベントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続を作成 - 基本手順を参照してください。
Create an Event

イベントの作成方法を選択します。

  • In Detail

    このオプションを使用すると、イベントの詳細を設定できます。

  • Quickly

    必要なのは、カレンダーを選択し、イベントの名前を入力することだけです。名前に時間や場所の詳細を含めると、Google Calendar がその場所と時間にイベントをスケジュールします。

Calendar ID
イベントを表示するカレンダーを選択します。
Color
イベントがカレンダーに表示する色を選択します。
Event name

イベントの名前を入力またはマッピングします。

メモ:「Create an event」フィールドで Quick add を選択した場合は、イベントの日時を含めることができ、Workfront Fusion によってその日時のイベントが作成されます。例:Appointment at Capitol Hill on June 3rd 10am-10:25am。Quick add を選択し、イベント名に日時を含めない場合、イベントは現在の時刻から作成され、1 時間存続します。

All day event
イベントが終日イベントの場合は、このオプションを有効にします(開始時刻と終了時刻が不要)。
Start date

これが終日イベントの場合は、イベントの開始日を入力します。

サポートされる日付形式のリストについては、Adobe Workfront Fusion での型強制を参照してください。

End date

これが終日イベントの場合は、イベントの終了日を入力します。

サポートされる日付形式のリストについては、Adobe Workfront Fusion での型強制を参照してください。

Description
イベントの説明を入力またはマッピングします。このフィールドでは HTML がサポートされています。
Location
イベントの場所をテキスト形式で入力します。
Use the default reminder settings for this event
デフォルトのリマインダー設定を使用するには、このオプションを有効にします。「Reminder」フィールドにカスタムリマインダーを設定した場合、この値は「No」に設定されます。
Reminder
イベントのリマインダーを追加します。各リマインダーについて、リマインダーを設定するメソッドを選択し、リマインダーを設定するイベントまでの時間(分単位)を定義します。
Attendees
出席者をイベントに追加します。出席者ごとに、名前とメールアドレスを入力またはマッピングします。
Show me as
カレンダーを表示している人に、このイベント中に「忙しい」として表示するか「利用可能」として表示するかを選択します。
Visibility

このイベントの表示を選択します。

  • Default

    イベントには、カレンダー設定で設定した表示設定が含まれます。

  • Public

    カレンダーを共有している人は誰でも、このイベントを表示できます。

  • Private

    出席者のみがこのイベントを表示できます。

Send notification about the event creation

新しいイベントの作成に関する通知をすべてのゲストに送信するか、Google Calendar を使用していないゲストに送信するか、または誰にも送信しないかを選択します。

ヒント:None オプションは、移行のユースケースにのみ使用することをお勧めします。

Guests can modify the event
ゲストがこのイベントを変更できるようにする場合は、このオプションを有効にします。
Recurrence
このイベントに適用する繰り返しルールを追加します。各ルールには、繰り返しイベント用の RRULE、EXRULE、RDATE および EXDATE の各行のリストが必要です。DTSTART 行と DTEND 行は、このフィールドでは使用できません。イベントの開始時刻と終了時刻は、それぞれ「開始」フィールドと「終了」フィールドで指定します。このフィールドは、単一のイベントまたは繰り返しイベントのインスタンスでは省略されます。詳しくは、RFC5545 を参照してください。

イベントの更新

このアクションモジュールでは、既存のイベントを変更できます。

カレンダーとイベント ID を指定します。

このモジュールは、イベントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar
作業するカレンダーを選択します。
Event ID
前に作成した更新対象の Google Calendar イベントの ID を入力します。

目的のフィールドに新しい値を入力することで、イベント情報を更新できます。個々のフィールドについて詳しくは、イベントの作成を参照してください。

イベントの削除

このアクションモジュールでは、イベントを削除します。

カレンダーとイベント ID を指定します。

このモジュールは、イベントの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
削除するイベントを含むカレンダーを選択します。
Event ID
前に作成した削除対象の Google Calendar イベントの ID を入力します。
Send notification about the event deletion
イベントの削除に関する通知をすべてのゲストに送信するか、Google Calendar を使用しないすべてのゲストに送信するか、または誰にも送信しないかを選択します。

カレンダー

カレンダーをリスト

このアクションモジュールは、ユーザーのカレンダーリストのカレンダーを返します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Minimum access role

ユーザーの最小アクセス役割を選択します。モジュールは、この最小アクセス役割に基づいてカレンダーを返します。

  • Free Busy Reader:ユーザーは空き時間情報を読み取ることができます。
  • Owner:ユーザーはイベントの読み取りと変更を行い、コントロールリストにアクセスできます。
  • Reader:ユーザーはプライベートでないイベントを読み取ることができます。
  • Writer:ユーザーはイベントの読み取りと変更を行うことができます。
Show hidden calendars
モジュールが返すリストに非表示のカレンダーを含めるには、このオプションを有効にします。
Limit
Workfront Fusion が 1 回の実行サイクルで返すカレンダーの数の上限を設定します。

カレンダーを取得

このアクションモジュールは、カレンダーを取得します。

取得するカレンダーの ID を指定します。

このモジュールは、レコードの ID および関連するフィールドと共に、接続を介してアクセスされるカスタムフィールドとその値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
取得するカレンダーを選択します。

カレンダーを作成

このアクションモジュールは、新しいカレンダーを作成します。

カレンダーの名前を指定します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar name
新しいカレンダーの名前を入力します。

カレンダーを更新

このアクションモジュールは、カレンダーを更新します。

更新するカレンダーの ID を指定します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
更新するカレンダーを選択します。
Calendar name
カレンダーの新しい名前を入力します。

カレンダーを削除

このアクションモジュールは、カレンダーを削除します。

削除するカレンダーの ID を指定します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
削除するカレンダーの ID を入力またはマッピングします。

カレンダーを消去

このアクションモジュールは、アカウントのプライマリカレンダーからすべてのイベントを削除します。

消去するカレンダーを含むアカウントへの接続を指定します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。

アクセス制御ルール

アクセス制御ルールをリスト

このアクションモジュールは、カレンダーのアクセス制御リストのルールを返します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
取得するアクセス制御ルールを含むカレンダーを選択します。
Limit
Workfront Fusion が 1 回の実行サイクルで返す結果数の上限を設定します。

アクセス制御ルールを取得

このアクションモジュールは、アクセス制御ルールのメタデータを返します。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
取得するアクセス制御ルールを含むカレンダーを選択します。
Access control rule ID
取得するアクセス制御ルールを選択します。

アクセス制御ルールを作成

このアクションモジュールは、新しいアクセス制御ルールを作成します。

カレンダーの名前を指定します。

このモジュールは、アクセス制御ルールと関連するフィールドの ID と、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
アクセス制御ルールを作成するカレンダーを選択します。
Role

アクセスルールに割り当てる役割を選択します。

  • Free Busy Reader:ユーザーは空き時間情報を読み取ることができます。
  • Owner:ユーザーはイベントの読み取りと変更を行い、コントロールリストにアクセスできます。
  • Reader:ユーザーはプライベートでないイベントを読み取ることができます。
  • Writer:ユーザーはイベントの読み取りと変更を行うことができます。
Type

スコープのタイプを選択します。

  • Default:パブリックスコープ。これはデフォルト値です。
  • User:範囲を 1 人のユーザーに制限します。
  • Group:範囲をグループに制限します。
  • Domain:範囲をドメインに制限します。

注意:Default、またはパブリック、範囲に付与された権限は、認証済みまたは未認証のユーザーに適用されます。

Value
範囲のタイプに応じて、ユーザーまたはグループのメールアドレス、またはドメインの名前を入力します。
Send notifications

アクセスの変更に関する通知を送信するには、このオプションを有効にします。

メモ:アクセスの削除に関する通知はありません。

アクセス制御ルールを更新

このアクションモジュールは、アクセス制御ルールを更新します。

カレンダーの名前を指定します。

このモジュールは、アクセス制御ルールと関連するフィールドの ID と、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
更新するアクセス制御ルールを含むカレンダーを選択します。
Access control rule ID
更新するアクセス制御ルールを選択します。
Role

アクセスルールに割り当てる役割を選択します。

  • None:この役割はアクセス権を提供しません。
  • Free Busy Reader:ユーザーは空き時間情報を読み取ることができます。
  • Owner:ユーザーはイベントの読み取りと変更を行い、コントロールリストにアクセスできます。
  • Reader:ユーザーはプライベートでないイベントを読み取ることができます。
  • Writer:ユーザーはイベントの読み取りと変更を行うことができます。
Send notifications

アクセスの変更に関する通知を送信するには、このオプションを有効にします。

メモ:アクセスの削除に関する通知はありません。

アクセス制御ルールを削除

このアクションモジュールは、アクセス制御ルールを削除します。

カレンダーの名前を指定します。

このモジュールは、アクセス制御ルールと関連するフィールドの ID と、接続がアクセスするカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
Calendar ID
削除するアクセス制御ルールを含むカレンダーの ID を選択またはマッピングします。
Access control rule ID
削除するアクセス制御ルールの ID を選択またはマッピングします。

イテレーター(廃止)

添付ファイルを反復モジュールと参加者を反復モジュールは非推奨になりました。添付ファイルまたは出席者を反復するには、フロー制御/イテレーターモジュールを使用してください。詳しくは、 Adobe Workfront Fusion のイテレーターモジュールを参照してください。

その他

API 呼び出しの実行

このモジュールでは、カスタム API 呼び出しを実行できます。

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順については、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください。
URL
https://www.googleapis.com/calendar からの相対パスを入力します。例: /v3/users/me/calendarList
Method
Headers
標準の JSON オブジェクトの形式でリクエストのヘッダーを追加します(例:{"Content-type":"application/json"})。認証ヘッダーは Workfront Fusion によって追加されます。
Query String
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

空き時間情報の取得

このアクションモジュールは、一連のカレンダーの空き時間情報を返します。

このモジュールは、カレンダーの ID や関連するフィールドのほか、接続を介してアクセスされるカスタムフィールドおよび値を返します。この情報は、シナリオ内の後続のモジュールにマッピングできます。

このモジュールを設定する際には、次のフィールドが表示されます。

Connection
Google Calendar アカウントを Workfront Fusion に接続する手順について詳しくは、Adobe Workfront Fusion への接続の作成 - 基本手順を参照してください
Minimum time

情報を取得する間隔の開始点を入力します。

サポートされる日付と時刻の形式の一覧について詳しくは、Adobe Workfront Fusion での型強制を参照してください。

Maximum time

情報を取得する間隔の終了点を入力します。

サポートされる日付と時刻の形式の一覧について詳しくは、Adobe Workfront Fusion での型強制を参照してください。

Calendars
情報を取得する各カレンダーで、「追加」をクリックして、カレンダー ID を入力またはマッピングします。

イベント前のシナリオのトリガー

標準の Google Calendar メールリマインダーと Webhook/カスタムメールフックモジュールを利用して、イベントの指定時間前にシナリオをトリガーできます。

  1. Google Calendar/イベントを更新モジュールを使用して、イベントにメールリマインダーを追加します。

  2. Webhooks/カスタムメールフックモジュールから新しいシナリオを作成します。

    1. メールフックのメールアドレスをコピーします。
    2. シナリオを保存し、実行します。
  3. Gmail で、Google Calendar メールリマインダーをメールフックのメールアドレスにリダイレクトします。

    1. Gmail設定 ​を開きます。

    2. 転送と POP/IMAP」タブを開きます。

    3. 転送先アドレスを追加」をクリックします。

    4. コピーしたメールフックのメールアドレスをペーストして、「次へ」をクリックします。ポップアップウィンドウで「続行」を押して確定し、「OK」をクリックします。

    5. Workfront Fusion で、新しいシナリオに切り替えると、確認メールを受信して実行が完了します。

    6. モジュールの上のバブルをクリックして、モジュールの出力を調べます。

    7. Text 項目を展開して、確認コードをコピーします。

    8. Gmail で、編集ボックスに確認コードをペーストして、「検証」をクリックします。

    9. フィルターとブロック済みアドレス」タブを開きます。

    10. 新規フィルターを作成」をクリックします。

    11. calendar-notification@google.com から送信されるすべてのメールに対してフィルターを設定して、「フィルターを作成」をクリックします。

    12. 転送先」を選択して、メールフックのメールアドレスをリストから選択します。

    13. フィルターを作成」をクリックして、フィルターを作成します。

  4. (オプション)Workfront Fusion で、Webhooks/カスタムメールフックモジュールの後に、テキストパーサー/一致パターンモジュールを追加して、メールの HTML コードを使用して必要な情報を取得します。

    例えば、モジュールを次のように設定して、イベントの ID を取得できます。

    パターン<meta itemprop="eventId/googleCalendar" content="(?<evenitID>.*?)"/>

    テキスト:Webhook/カスタムメールフックモジュールから出力された HTML content 項目。

recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43