REST Resource: channels

Resource: Channel

A notification channel used to watch for resource changes.

JSON representation
 { 
 "payload" 
 : 
 boolean 
 , 
 "id" 
 : 
 string 
 , 
 "resourceId" 
 : 
 string 
 , 
 "resourceUri" 
 : 
 string 
 , 
 "token" 
 : 
 string 
 , 
 "expiration" 
 : 
 string 
 , 
 "type" 
 : 
 string 
 , 
 "address" 
 : 
 string 
 , 
 "params" 
 : 
 { 
 string 
 : 
 string 
 , 
 ... 
 } 
 , 
 "kind" 
 : 
 string 
 } 
Fields
payload

boolean

A Boolean value to indicate whether payload is wanted. Optional.

id

string

A UUID or similar unique string that identifies this channel.

resourceId

string

An opaque ID that identifies the resource being watched on this channel. Stable across different API versions.

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

string ( int64 format)

Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional.

type

string

The type of delivery mechanism used for this channel. Valid values are "web_hook" or "webhook".

address

string

The address where notifications are delivered for this channel.

params

map (key: string, value: string)

Additional parameters controlling delivery channel behavior. Optional.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

kind

string

Identifies this as a notification channel used to watch for changes to a resource, which is api#channel .

Methods

stop

Stops watching resources through this channel.