REST Resource: changes
Stay organized with collections
Save and categorize content based on your preferences.
Resource: Change
A change to a file or shared drive.
| JSON representation |
{
"kind": string,
"removed": boolean,
"file": {
object (File)
},
"fileId": string,
"time": string,
"driveId": string,
"type": string,
"teamDriveId": string,
"teamDrive": {
object (TeamDrive)
},
"changeType": string,
"drive": {
object (Drive)
}
} |
| Fields |
kind |
string
Identifies what kind of resource this is. Value: the fixed string "drive#change".
|
removed |
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 which has changed.
|
time |
string
The time of this change (RFC 3339 date-time).
|
driveId |
string
The ID of the shared drive associated with this 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.
|
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 |
|
|
Gets the starting pageToken for listing future changes. |
|
|
Lists the changes for a user or shared drive. |
|
|
Subscribes 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-18 UTC.
[null,null,["Last updated 2025-04-18 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\nA change to a file or shared drive.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"removed\": boolean, \"file\": { object (/workspace/drive/api/reference/rest/v3/files#File) }, \"fileId\": string, \"time\": string, \"driveId\": string, \"type\": string, \"teamDriveId\": string, \"teamDrive\": { object (/workspace/drive/api/reference/rest/v3/teamdrives#TeamDrive) }, \"changeType\": string, \"drive\": { object (/workspace/drive/api/reference/rest/v3/drives#Drive) } } ``` |\n\n| Fields ||\n|--------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#change\"`. |\n| `removed` | `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/v3/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 which has changed. |\n| `time` | `string` The time of this change (RFC 3339 date-time). |\n| `driveId` | `string` The ID of the shared drive associated with this 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/v3/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| `drive` | `object (`[Drive](/workspace/drive/api/reference/rest/v3/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| ### [getStartPageToken](/workspace/drive/api/reference/rest/v3/changes/getStartPageToken) | Gets the starting pageToken for listing future changes. |\n| ### [list](/workspace/drive/api/reference/rest/v3/changes/list) | Lists the changes for a user or shared drive. |\n| ### [watch](/workspace/drive/api/reference/rest/v3/changes/watch) | Subscribes to changes for a user. |"]]
