ACL リソースの変更を監視します。
リクエストする
HTTP リクエスト
POST https://www.googleapis.com/calendar/v3/calendars/calendarId/acl/watch
パラメータ
パラメータ名 | 値 | 説明 |
---|---|---|
パスパラメータ | ||
calendarId |
string |
カレンダーの ID。カレンダー ID を取得するには、calendarList.list メソッドを呼び出します。現在ログインしているユーザーのメイン カレンダーにアクセスするには、「primary 」を使用します。できます。
|
承認
このリクエストには、次のスコープによる認証が必要です。
スコープ |
---|
https://www.googleapis.com/auth/calendar |
詳細については、認証と認可のページをご覧ください。
リクエスト本文
リクエストの本文には、以下の構造を使用してデータを指定してください。
{ "id": string, "token": string, "type": string, "address": string, "params": { "ttl": string } }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
id |
string |
このチャンネルを識別する UUID または一意の文字列。 | |
token |
string |
このチャンネル経由で通知と一緒に対象のアドレスに配布される任意の文字列。省略可。 | |
type |
string |
このチャンネルで使用される配信方法の種類。有効な値は「web_hook 」です(「webhook 」)を入力します。どちらの値も、メッセージの配信に HTTP リクエストを使用するチャネルを表します。 |
|
address |
string |
このチャンネルの通知が配信されるアドレス。 | |
params |
object |
配信チャンネルの操作を制御する追加のパラメータ。省略可。 | |
params.ttl |
string |
通知チャンネルの有効期間(秒)。デフォルトは 604,800 秒です。 |
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "kind": "api#channel", "id": string, "resourceId": string, "resourceUri": string, "token": string, "expiration": long }
プロパティ名 | 値 | 説明 | メモ |
---|---|---|---|
kind |
string |
リソース「api#channel 」の変更を監視するために使用される通知チャンネルであることを指定します。 |
|
id |
string |
このチャンネルを識別する UUID または一意の文字列。 | |
resourceId |
string |
このチャンネルで監視するリソースを識別する不透明な ID。異なる API バージョンでも安定しています。 | |
resourceUri |
string |
監視対象のリソースのバージョン固有の ID。 | |
token |
string |
このチャンネル経由で通知と一緒に対象のアドレスに配布される任意の文字列。省略可能。 | |
expiration |
long |
通知チャンネルの有効期限。Unix のタイムスタンプでミリ秒単位で表示されます。省略可。 |