REST Resource: channels

资源:渠道

用于监控资源更改的通知渠道。

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

boolean

一个布尔值,用于指示是否需要载荷。可选。

id

string

用于标识此频道的 UUID 或类似的唯一字符串。

resourceId

string

用于标识在此频道上被监控的资源的不透明 ID。在不同 API 版本中稳定运行。

resourceUri

string

所监控资源的版本专用标识符。

token

string

随每条通过此渠道传送的通知一起传送到目标地址的任意字符串。可选。

expiration

string (int64 format)

通知渠道到期日期和时间,以 Unix 时间戳表示(以毫秒为单位)。可选。

type

string

此渠道使用的传送机制类型。有效值为“web_hook”或“webhook”。

address

string

此频道通知的传送地址。

params

map (key: string, value: string)

用于控制传送渠道行为的其他参数。可选。

包含一系列 "key": value 对的对象。示例:{ "name": "wrench", "mass": "1.3kg", "count": "3" }

kind

string

将其标识为用于监控资源更改的通知渠道(即 api#channel)。

方法

stop

停止通过此渠道观看资源。