REST Resource: channels
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Ressource: Channel
Ein Benachrichtigungskanal, der verwendet wird, um nach Ressourcenänderungen zu suchen.
JSON-Darstellung |
{
"params": {
string: string,
...
},
"payload": boolean,
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": string,
"type": string,
"address": string,
"kind": string
} |
Felder |
params |
map (key: string, value: string)
Zusätzliche Parameter zur Steuerung des Verhaltens des Auslieferungskanals. Optional. Ein Objekt, das eine Liste von "key": value -Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" } .
|
payload |
boolean
Ein boolescher Wert, der angibt, ob eine Nutzlast gewünscht wird. Optional.
|
id |
string
Eine UUID oder ein ähnlicher eindeutiger String, der diesen Channel identifiziert.
|
resourceId |
string
Eine intransparente ID, die die auf diesem Kanal überwachte Ressource identifiziert. Stabil über verschiedene API-Versionen hinweg.
|
resourceUri |
string
Eine versionsspezifische Kennung für die überwachte Ressource.
|
token |
string
Ein beliebiger String, der mit jeder Benachrichtigung, die über diesen Kanal gesendet wird, an die Zieladresse übermittelt wird. Optional.
|
expiration |
string (int64 format)
Datum und Uhrzeit des Ablaufs des Benachrichtigungschannels als Unix-Zeitstempel in Millisekunden. Optional.
|
type |
string
Der Typ des für diesen Channel verwendeten Bereitstellungsmechanismus. Gültige Werte sind „web_hook“ oder „webhook“.
|
address |
string
Die Adresse, an die Benachrichtigungen für diesen Kanal gesendet werden.
|
kind |
string
Gibt an, dass dies ein Benachrichtigungskanal ist, der verwendet wird, um Änderungen an einer Ressource zu beobachten, die api#channel ist.
|
Methoden |
|
Die Wiedergabe von Ressourcen über diesen Kanal wird beendet. |
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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/v2/channels/stop) | Stops watching resources through this channel. |"]]