SubscriptionChannel

用於監控資源變更的通知管道。

JSON 表示法
{
  "id": string,
  "token": string,
  "expiration": string,
  "type": string,
  "address": string,
  "payload": boolean,
  "params": {
    string: string,
    ...
  },
  "resourceId": string,
  "resourceUri": string,
  "kind": string
}
欄位
id

string

用於識別這個管道的 UUID 或類似的專屬字串。

token

string

系統會將任意字串傳送至目標地址,並透過這個管道傳送每則通知。選填。

expiration

string (int64 format)

通知管道到期日期和時間,以 Unix 時間戳記 (以毫秒為單位) 表示。選填。

type

string

這個管道使用的放送機制類型。

address

string

這個管道會將通知傳送至這個位址。

payload

boolean

布林值,用於指出是否需要酬載。選填。

params

map (key: string, value: string)

控制提交管道行為的其他參數。選用設定。舉例來說,params.ttl 會以秒為單位指定通知管道的存留時間,預設值為 2 小時,最大 TTL 為 2 天。

這個物件中包含 "key": value 組合的清單,範例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

resourceId

string

這個不易解讀的 ID 可識別這個管道中正在監控的資源。在不同 API 版本中皆穩定運作。

resourceUri

string

受監控資源的版本專屬 ID。

kind

string

指出這是用於監控資源 (api#channel) 變更的通知管道。