Stay organized with collections Save and categorize content based on your preferences.
Note: This method applies to the Object Change Notification feature, which is not the recommended way to create notifications for Cloud Storage. Instead, use Pub/Sub Notifications for Cloud Storage, which are faster, more flexible, easier to set up, and more cost-effective.Watch for changes on all objects in a bucket.
Required permissionsThe authenticated user must have the storage.buckets.update IAM permission to use this method.
POST https://storage.googleapis.com/storage/v1/b/bucket/o/watch
In addition to standard query parameters, the following query parameters apply to this method.
To see an example of how to include query parameters in a request, see the JSON API Overview page.
Parameters Parameter name Value Description Path parametersbucket string Name of the bucket in which to look for objects. Optional query parameters delimiter string This parameter is not implemented for the watchAll method. endOffset string This parameter is not implemented for the watchAll method. includeTrailingDelimiter integer This parameter is not implemented for the watchAll method. maxResults integer This parameter is not implemented for the watchAll method. pageToken string This parameter is not implemented for the watchAll method. prefix string This parameter is not implemented for the watchAll method. projection string This parameter is not implemented for the watchAll method. startOffset string This parameter is not implemented for the watchAll method. versions boolean This parameter is not implemented for the watchAll method. Request body
In the request body, supply data with the following structure:
{
"kind": "api#channel",
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": "long",
"type": string,
"address": string,
"payload": boolean,
"params": {
(key): string
}
} Property name Value Description Notes kind string Identifies this as a notification channel used to watch for changes to a resource. This value is always "api#channel". 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 long1 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. This value is always "WEBHOOK". address string The address where notifications are delivered for this channel. params object Additional parameters controlling delivery channel behavior. Optional. params.(key) string Declares a new parameter by name. payload boolean A Boolean value to indicate whether payload is wanted. Optional. 1 This property is a string formatted as the specified value type. Response
If successful, this method returns a response body with the following structure:
{
"kind": "api#channel",
"id": string,
"resourceId": string,
"resourceUri": string,
"token": string,
"expiration": "long",
"type": string,
"address": string,
"payload": boolean,
"params": {
(key): string
}
} Property name Value Description Notes kind string Identifies this as a notification channel used to watch for changes to a resource. This value is always "api#channel". 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 long1 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. address string The address where notifications are delivered for this channel. params object Additional parameters controlling delivery channel behavior. Optional. params.(key) string Declares a new parameter by name. payload boolean A Boolean value to indicate whether payload is wanted. Optional. 1 This property is a string formatted as the specified value type.
For information about status and error codes returned by this API, see the reference page.
Try it!Use the APIs Explorer below to call this method on live data and see the response.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-07 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[],[]]
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4