Settings: watch

Requires authorization 承認が必要

Watch for changes to Settings resources. 設定リソースへの変更を監視します。

Request要求

HTTP requestHTTPリクエスト

POST https://www.googleapis.com/calendar/v3/users/me/settings/watch

Parametersパラメーター

Parameter nameパラメータ名 Value Description説明

Authorization承認

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).この要求には、以下の範囲のうちの少なくとも1つを使用した許可が必要です(認証および許可について詳しく読む)。

Scope範囲
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.settings.readonly

Request bodyリクエストボディ

In the request body, supply data with the following structure:リクエストボディには、次の構造を持つデータを入力します。

{
  "id": string,
  "token": string,
  "type": string,
  "address": string,
  "params": {
    "ttl": string
  }
}
Property nameプロパティ名 Value Description説明 Notesノート
id string A UUID or similar unique string that identifies this channel.このチャンネルを識別するUUIDまたは類似の一意の文字列。
token string An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.このチャネルを介して配信される各通知とともにターゲットアドレスに配信される任意の文字列。オプションです。
type string The type of delivery mechanism used for this channel.このチャネルに使用される配信メカニズムのタイプ。
address string The address where notifications are delivered for this channel.このチャネルに対して通知が配信されるアドレス。
params object Additional parameters controlling delivery channel behavior. Optional.配信チャネルの動作を制御する追加パラメータ オプションです。
params.ttl string The time-to-live in seconds for the notification channel. Default is 3600 seconds.通知チャネルの存続時間(秒)。デフォルトは3600秒です。

Response応答

If successful, this method returns a response body with the following structure:成功した場合、このメソッドは以下の構造を持つレスポンスボディを返します。

{
  "kind": "api#channel",
  "id": string,
  "resourceId": string,
  "resourceUri": string,
  "token": string,
  "expiration": long
}
Property nameプロパティ名 Value Description説明 Notesノート
kind string Identifies this as a notification channel used to watch for changes to a resource. Value: the fixed string "api#channel".これをリソースへの変更を監視するために使用される通知チャネルとして識別します。値:固定文字列 " api#channel"。
id string A UUID or similar unique string that identifies this channel.このチャンネルを識別するUUIDまたは類似の一意の文字列。
resourceId string An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.このチャンネルで監視されているリソースを識別する不透明なID。さまざまなAPIバージョンにわたって安定しています。
resourceUri string A version-specific identifier for the watched resource.監視対象リソースのバージョン固有の識別子。
token string An arbitrary string delivered to the target address with each notification delivered over this channel. Optional.このチャネルを介して配信される各通知とともにターゲットアドレスに配信される任意の文字列。オプションです。
expiration long Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.通知チャネルの有効期限の日付と時刻(ミリ秒単位のUnixタイムスタンプ)。オプションです。

スポンサーリンク

関連記事

スポンサーリンク

:first-line 最初の1行にスタイルを指定する

ホームページ製作・web系アプリ系の製作案件募集中です。

上に戻る