ユーザー アカウントの権限

スケジューラを Google アカウントに接続する際に、Webex が権限を求めるときのスクリーンショット
Webex が要求する権限
表 1. 要求される権限と Webex での利用方法

権限

範囲

アクセスされるデータ

Webex での利用方法

アドオンの実行時にメール メッセージのメタデータを表示する

Gmail

件名行、日時、招待者リスト

Gmail で Webex ミーティングをスケジュールする際に、スケジューラがミーティングをスケジュールするために必要なこれらの情報を読み込みます。

Gmail アドオンとして実行する

Gmail

Webex スケジューラがユーザーの Gmail で実行できるようになります。

Google カレンダーで開くイベントを表示する

カレンダー

件名行、日時、招待者リスト

Google カレンダーでイベントを開く際、スケジューラがミーティングをスケジュールするために必要なこれらの情報を読み込みます。

Google カレンダーで開いたイベントを編集する

カレンダー

件名行

Webex 会議データ (カード UI/プロパティ) を現在開いているカレンダー イベントに追加します。

カレンダー アドオンとして実行する

カレンダー

Webex スケジューラをユーザーの Google カレンダーで実行できるようになります。

すべてのカレンダー上のイベントを表示および編集する

カレンダー

件名行、日時、招待者リストを読み取る

件名行を編集する

単一ユーザーのカレンダーでイベントを読み書きするのと同じように、共有されたカレンダー シナリオをサポートできるようになります。

カレンダー設定を表示する

カレンダー

Google OAuth 2.0 にはこの範囲が必要です。https://developers.google.com/calendar/api/guides/auth を参照してください。

ドメインのユーザーについての情報を表示する

Google Workspace 管理

Google ユーザー情報の Webex siteURL

Google ユーザー情報に Webex siteURL を設定している場合、この URL を読み取り、ユーザーのデフォルトとしてこのサイトにログインできます。

外部サービスに接続する

アプリ スクリプト

Webex サービスに接続する

スケジューラは、関連する Webex ミーティングの作成/更新/削除を要求するために Webex サービスに発信する必要があります。

不在時にこのアプリケーションの実行を許可する

アプリ スクリプト

Google トリガーに基づいて Google イベント オブジェクトにアクセスする

これにより、カレンダーでのミーティングの更新/削除など、不在時に Google をトリガーし、スケジューラを実行できます。https://developers.google.com/apps-script/guides/triggers/events を参照してください。

アプリケーションに関連するデータを表示および管理する

アプリ スクリプト

アプリケーションのキャッシュ

スケジューラは Google ストレージの一部の Webex 情報をキャッシュします。例: Webex サイト URL と Webex ミーティング テンプレート。

国、言語、タイムゾーンを表示する

アプリ スクリプト

ユーザーの現在の時刻

スケジューラがタイムゾーンを読み取り、関連する Webex ミーティングをスケジュールまたは更新します

プライマリ Google アカウント メール アドレスを表示する

その他

ユーザーの Gmail アカウント アドレス

スケジューラがユーザーのメール アドレスを読み取り、Webex アカウントにバインドします。

一般に公開した個人情報を含む、個人情報を表示する

その他

ユーザー名と優先言語 (デフォルト)

スケジューラがフルネーム、ユーザーのデフォルトとして使用する優先言語を含む、ユーザーの公開ユーザー情報を読み取ります。

Webex スケジューラのアーキテクチャ概要

アーキテクチャ図は Google Cloud、Webex Cloud、Google カレンダー クライアントを示し、番号付きの矢印で関連付けられています。
  1. サイト管理者はサイトの管理または Control Hub を使用して、Google Workspace の Webex アドオンを有効にします。

  2. 各ユーザーは Google Workspace の Webex アドオンの権限を承認し (管理者が認証していない場合)、Google アカウントを Webex アカウントに関連付けます。

  3. Webex は Google からのカレンダーの変更を許可します。

  4. ユーザーは Webex ミーティングを Google カレンダー イベントに追加したり、時間や議題を更新したり、イベントを別の日時にコピーしたりできます。

  5. Webex アドオン クライアントは Google カレンダーの通知を受け取り、Webex と同期します。

Webex スケジューラで使用される Google API

以下の表は Webex スケジューラで使用される Google API に関する情報を示しています。

ほとんどの場合、Webex スケジューラは Google App Script API を使用します。スケジューラは Google REST API を使用する場合もあります。通常、Google App Script API は関連付けられている Google REST API をラップします。参照 URL 列は Google App Script API を示していますが、必要に応じて Google REST API の参照 URL を参照してください。

表 2. Webex スケジューラで使用される Google App Script API

Google App Script API

概要

参照 URL

Calendar.getID 

ユーザー カレンダー ID を取得します。デフォルト カレンダーの ID はユーザーのメール アドレスです 

https://developers.google.com/apps-script/reference/calendar/calendar#getId()

カレンダー.getName 

カレンダーの名前を取得する 

https://developers.google.com/apps-script/reference/calendar/calendar#getName()

Calendar.getTimezone 

カレンダーのタイムゾーン  

https://developers.google.com/apps-script/reference/calendar/calendar#getTimeZone()

カレンダー.Events.list 

一部の 基準 に一致する 特定 のイベントを検索する

https://developers.google.com/calendar/api/v3/reference/events/list

Calendar.Events.patch 

特定の イベント メタデータを更新して  webex ミーティング情報 を保存する

https://developers.google.com/calendar/api/v3/reference/events/patch

CalendarEvent.attendees 

カレンダーの出席者にアクセスするためのプロパティ 

https://developers.google.com/calendar/api/v3/reference/events#resource

CalendarEvent.conferenceData 

イベント会議データにアクセスするためのプロパティ 

https://developers.google.com/calendar/api/v3/reference/events#resource

CalendarEvent.getTitle 

カレンダー イベントのトピックを取得する。 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getTitle()

CalendarEvent.getCreators 

 カレンダーイベントの作成者 を取得

https://developers.google.com/apps-script/reference/calendar/calendar-event#getCreators()

CalendarEvent.getStartTime 

イベントの開始時間を取得する 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getStartTime()

CalendarEvent.getEndTime 

イベントの終了時間を取得する 

https://developers.google.com/apps-script/reference/calendar/calendar-event#getEndTime()

CacheService.getUserCache 

 ユーザーのキャッシュを取得し、ユーザーの基本設定 設定を取得する 

https://developers.google.com/apps-script/reference/cache/cache-service#getUserCache()

Cache.get 

 特定の キーによるキャッシュ設定 を取得する

https://developers.google.com/apps-script/reference/cache/cache#get(String)

Cache.put 

 特定の キャッシュをキーで設定 

https://developers.google.com/apps-script/reference/cache/cache#put(String,String)

ConferenceDataService. newConferenceDataBuilder 

Google 特有のデータ構造を作成し、 webex ミーティング情報 を保存および表示する

https://developers.google.com/apps-script/reference/conference-data/conference-data-service#newConferenceDataBuilder()

ConferenceDataBuilder.build 

 webex ミーティング情報データ の生成

https://developers.google.com/apps-script/reference/conference-data/conference-data-builder#build()

GmailApp.getMessageById(GmailApp.getMessageById) 

特定の  gmail メッセージ を取得する

https://developers.google.com/apps-script/reference/gmail/gmail-app#getMessageById(String)

GmailApp.createDraft 

 webex メール本文 を含むGmailメッセージを作成する

https://developers.google.com/apps-script/reference/gmail/gmail-app#createDraft(String,String,String)

GmailMessage.getFrom 

Gmail送信者のメールを取得 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getFrom()

GmailMessage.getTo 

 gamil レシーバー 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getTo()

GmailMessage.getSubject 

Gmailのメッセージタイトルを取得 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getSubject()

GmailMessage.getDate 

Gmailメッセージの日付と時刻を取得する 

https://developers.google.com/apps-script/reference/gmail/gmail-message#getDate()

PropertiesService.getUserProperties 

persist user perference or setting にアクセスする

https://developers.google.com/apps-script/reference/properties/properties-service#getUserProperties()

プロパティ.getProperty 

keyで特定プロパティを取得する 

https://developers.google.com/apps-script/reference/properties/properties#getProperty(String)

Properties.setプロパティ 

key と value に新しいプロパティを設定する 

https://developers.google.com/apps-script/reference/properties/properties#setProperty(String,String)

Session.getEffectiveUser().getEmail 

現在のユーザーのメールを取得 

https://developers.google.com/apps-script/reference/base/user#getEmail()

ScriptApp.newTrigger(スクリプトアプリ.newTrigger) 

イベントの更新を処理する新しいトリガーをセットアップする 

https://developers.google.com/apps-script/reference/script/script-app#newTrigger(String)

UrlFetchApp.fetch 

このAPIを使用して Webex Addin Service またはGoogle API を呼び出してミーティングを作成/更新すると、他の 第三 者 サービス を呼び出すことはできません。

https://developers.google.com/apps-script/reference/url-fetch/url-fetch-app#fetch(String)

表 3. Webex スケジューラで使用される Google REST API

Google REST API

概要

参照 URL

POST https://accounts.google.com/o/oauth2/token

Google 認証トークンを取得する

https://developers.google.com/identity/protocols/oauth2/web-server#exchange-authorization-code

GET https://www.googleapis.com/admin/directory/v1/users/{userKey}

設定済みのユーザーの Webex サイトを取得する

https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get

よくある質問

Webex はどのようにインテグレーションを保護していますか?

アドオンは Google Cloud Platform サーバーで実行されます。Webex のバックエンドに保存され、スケジュールされたミーティングの終了後に削除される Webex ミーティング情報 (件名、招待者リスト) を除いて、保存される Google データはありません。

https://help.webex.com/ituhp0 を参照してください。

このインテグレーションから「プル」した顧客データはどのようにして保護できますか?

Webex では必要なデータのみを収集し、必要な限りにおいて保存します。

Webex ミーティング情報を収集し、Webex Cloud に保存します。ミーティング情報は ユーザーが Webex 保持ポリシーで管理する指定された期間が過ぎると削除されます。

パブリックまたはプライベート API を使用して Google サービスに関連付けられますか?

アドオンは Google Cloud Platform で実行し、Google の内蔵ライブラリに直接アクセスします。

https://developers.google.com/apps-script/overview を参照してください。