SubscribeToFileChanges
Creates a webhook to receive real-time notifications when a specific file is modified in Drive.
Input
| Name | Type | Description |
| FileId | String | The unique identifier of the file in Google Drive to subscribe to for change notifications. This field is required. |
| SupportsAllDrives | Boolean | If the value is 'true', the subscription applies to both My Drives and shared drives. |
| Id | String | A required string that uniquely identifies the notification channel within your project. Used to distinguish among multiple channels. |
| Address | String | A required HTTPS URL where the Drive API will deliver change notifications. This is your webhook callback endpoint. |
| ChannelToken | String | An optional token string used to help identify or verify the origin of the notification channel. |
| Expiration | String | An optional Unix timestamp (in milliseconds) indicating when the notification channel should automatically expire. |
| ResourceId | String | An optional opaque identifier for the resource being watched. This is typically returned by the Drive API during subscription setup. |
| ResourceURI | String | An optional version-specific URI that identifies the particular revision or version of the file being monitored. |
| Payload | Boolean | If the value is 'true', the notification will include a data payload. If 'false', only metadata will be sent. |
| AdditionalParameters | Object | An optional JSON object for setting advanced delivery channel options, such as retry behavior or custom headers. |
Result Set Columns
| Name | Type | Description |
| Success | Boolean | If the value is 'true', the subscription to file change notifications was successful. If 'false', the operation has failed. |
| Kind | String | The type of change event detected, such as a file upload or update. |
| Id | String | The identifier you originally specified for this channel. |
| ResourceId | String | The unique identifier of the resource being watched, returned in the subscription response. |
| ResourceUri | String | The version-specific URI of the resource being watched, returned as part of the notification response. |
| Token | String | The token string that was provided when the channel was created, if any. |
| Expiration | String | The actual expiration time of the channel, returned as a Unix timestamp in milliseconds if it was set during subscription. |