REST Resource: channels
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Ресурс: Канал
Канал уведомлений, используемый для отслеживания изменений ресурсов.
JSON-представление |
---|
{
"params": {
string: string,
...
},
"payload": boolean,
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"kind": string
} |
Поля |
---|
params | map (key: string, value: string) Дополнительные параметры, управляющие поведением канала доставки. Необязательно. Объект, содержащий список пар "key": value . Пример: { "name": "wrench", "mass": "1.3kg", "count": "3" } . |
payload | boolean Логическое значение, указывающее, нужна ли полезная нагрузка. Необязательно. |
id | string UUID или аналогичная уникальная строка, идентифицирующая этот канал. |
resourceId | string Непрозрачный идентификатор, идентифицирующий ресурс, просматриваемый на этом канале. Стабилен в разных версиях API. |
resourceUri | string Идентификатор версии отслеживаемого ресурса. |
token | string Произвольная строка, отправляемая на целевой адрес с каждым уведомлением, доставленным по этому каналу. Необязательно. |
expiration | string ( int64 format) Дата и время истечения срока действия канала уведомлений, выраженные в виде временной метки Unix в миллисекундах. Необязательно. |
type | string Тип механизма доставки, используемый для этого канала. Допустимые значения: «web_hook» или «webhook». |
address | string Адрес, на который доставляются уведомления для этого канала. |
kind | string Определяет это как канал уведомлений, используемый для отслеживания изменений ресурса, то есть api#channel . |
Методы |
---|
| Прекращает просмотр ресурсов через этот канал. |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 2025-07-25 UTC."],[],[],null,["# REST Resource: channels\n\n- [Resource: Channel](#Channel)\n - [JSON representation](#Channel.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Channel\n-----------------\n\nA notification channel used to watch for resource changes.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"params\": { string: string, ... }, \"payload\": boolean, \"id\": string, \"resourceId\": string, \"resourceUri\": string, \"token\": string, \"expiration\": string, \"type\": string, \"address\": string, \"kind\": string } ``` |\n\n| Fields ||\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `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\" }`. |\n| `payload` | `boolean` A Boolean value to indicate whether payload is wanted. Optional. |\n| `id` | `string` A UUID or similar unique string that identifies this channel. |\n| `resourceId` | `string` An opaque ID that identifies the resource being watched on this channel. Stable across different API versions. |\n| `resourceUri` | `string` A version-specific identifier for the watched resource. |\n| `token` | `string` An arbitrary string delivered to the target address with each notification delivered over this channel. Optional. |\n| `expiration` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Date and time of notification channel expiration, expressed as a Unix timestamp, in milliseconds. Optional. |\n| `type` | `string` The type of delivery mechanism used for this channel. Valid values are \"web_hook\" or \"webhook\". |\n| `address` | `string` The address where notifications are delivered for this channel. |\n| `kind` | `string` Identifies this as a notification channel used to watch for changes to a resource, which is `api#channel`. |\n\n| Methods ------- ||\n|------------------------------------------------------------------|------------------------------------------------|\n| ### [stop](/workspace/drive/api/reference/rest/v3/channels/stop) | Stops watching resources through this channel. |"]]