REST Resource: changes
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Change
Representation of a change to a file or shared drive.
| JSON representation |
{
"id": string,
"deleted": boolean,
"file": {
object (File)
},
"fileId": string,
"modificationDate": string,
"kind": string,
"type": string,
"teamDriveId": string,
"teamDrive": {
object (TeamDrive)
},
"changeType": string,
"selfLink": string,
"driveId": string,
"drive": {
object (Drive)
}
} |
| Fields |
id |
string (int64 format)
The ID of the change.
|
deleted |
boolean
Whether the file or shared drive has been removed from this list of changes, for example by deletion or loss of access.
|
file |
object (File)
The updated state of the file. Present if the type is file and the file has not been removed from this list of changes.
|
fileId |
string
The ID of the file associated with this change.
|
modificationDate |
string
The time of this modification.
|
kind |
string
This is always drive#change.
|
type
(deprecated) |
string
Deprecated: Use changeType instead.
|
teamDriveId
(deprecated) |
string
Deprecated: Use driveId instead.
|
teamDrive
(deprecated) |
object (TeamDrive)
Deprecated: Use drive instead.
|
changeType |
string
The type of the change. Possible values are file and drive.
|
selfLink |
string
A link back to this change.
|
driveId |
string
The ID of the shared drive associated with this change.
|
drive |
object (Drive)
The updated state of the shared drive. Present if the changeType is drive, the user is still a member of the shared drive, and the shared drive has not been deleted.
|
Methods |
|
|
Deprecated: Use changes.getStartPageToken and changes.list to retrieve recent changes. |
|
|
Gets the starting pageToken for listing future changes. |
|
|
Lists the changes for a user or shared drive. |
|
|
Subscribe to changes for a user. |
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-04-03 UTC.
[null,null,["Last updated 2025-04-03 UTC."],[],[],null,["# REST Resource: changes\n\n- [Resource: Change](#Change)\n - [JSON representation](#Change.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Change\n----------------\n\nRepresentation of a change to a file or shared drive.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"id\": string, \"deleted\": boolean, \"file\": { object (/workspace/drive/api/reference/rest/v2/files#File) }, \"fileId\": string, \"modificationDate\": string, \"kind\": string, \"type\": string, \"teamDriveId\": string, \"teamDrive\": { object (/workspace/drive/api/reference/rest/v2/teamdrives#TeamDrive) }, \"changeType\": string, \"selfLink\": string, \"driveId\": string, \"drive\": { object (/workspace/drive/api/reference/rest/v2/drives#Drive) } } ``` |\n\n| Fields ||\n|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `id` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The ID of the change. |\n| `deleted` | `boolean` Whether the file or shared drive has been removed from this list of changes, for example by deletion or loss of access. |\n| `file` | `object (`[File](/workspace/drive/api/reference/rest/v2/files#File)`)` The updated state of the file. Present if the type is file and the file has not been removed from this list of changes. |\n| `fileId` | `string` The ID of the file associated with this change. |\n| `modificationDate` | `string` The time of this modification. |\n| `kind` | `string` This is always `drive#change`. |\n| `type` **(deprecated)** | `string` | This item is deprecated! Deprecated: Use `changeType` instead. |\n| `teamDriveId` **(deprecated)** | `string` | This item is deprecated! Deprecated: Use `driveId` instead. |\n| `teamDrive` **(deprecated)** | `object (`[TeamDrive](/workspace/drive/api/reference/rest/v2/teamdrives#TeamDrive)`)` | This item is deprecated! Deprecated: Use `drive` instead. |\n| `changeType` | `string` The type of the change. Possible values are `file` and `drive`. |\n| `selfLink` | `string` A link back to this change. |\n| `driveId` | `string` The ID of the shared drive associated with this change. |\n| `drive` | `object (`[Drive](/workspace/drive/api/reference/rest/v2/drives#Drive)`)` The updated state of the shared drive. Present if the changeType is drive, the user is still a member of the shared drive, and the shared drive has not been deleted. |\n\n| Methods ------- ||\n|-------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------|\n| ### [get](/workspace/drive/api/reference/rest/v2/changes/get) | Deprecated: Use `changes.getStartPageToken` and `changes.list` to retrieve recent changes. |\n| ### [getStartPageToken](/workspace/drive/api/reference/rest/v2/changes/getStartPageToken) | Gets the starting pageToken for listing future changes. |\n| ### [list](/workspace/drive/api/reference/rest/v2/changes/list) | Lists the changes for a user or shared drive. |\n| ### [watch](/workspace/drive/api/reference/rest/v2/changes/watch) | Subscribe to changes for a user. |"]]
