# REST Resource: changes

- [Resource: Change](https://developers.google.com/workspace/drive/api/reference/rest/v2/changes#Change)
  - [JSON representation](https://developers.google.com/workspace/drive/api/reference/rest/v2/changes#Change.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/workspace/drive/api/reference/rest/v2/changes#METHODS_SUMMARY)

## Resource: Change

Representation of a change to a file or shared drive.

| JSON representation |
|---|
| ``` { "id": string, "deleted": boolean, "file": { object (`https://developers.google.com/workspace/drive/api/reference/rest/v2/files#File`) }, "fileId": string, "modificationDate": string, "kind": string, "type": string, "teamDriveId": string, "teamDrive": { object (`https://developers.google.com/workspace/drive/api/reference/rest/v2/teamdrives#TeamDrive`) }, "changeType": string, "selfLink": string, "driveId": string, "drive": { object (`https://developers.google.com/workspace/drive/api/reference/rest/v2/drives#Drive`) } } ``` |

| Fields ||
|---|---|
| `id` | `string (https://developers.google.com/discovery/v1/type-format 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 (`https://developers.google.com/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. |
| `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` > [!WARNING] > This item is deprecated! Deprecated: Use `changeType` instead. |
| `teamDriveId (deprecated)` | `string` > [!WARNING] > This item is deprecated! Deprecated: Use `driveId` instead. |
| `teamDrive (deprecated)` | ``object (`https://developers.google.com/workspace/drive/api/reference/rest/v2/teamdrives#TeamDrive`)`` > [!WARNING] > This item is deprecated! 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 (`https://developers.google.com/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. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/workspace/drive/api/reference/rest/v2/changes/get` | Deprecated: Use `changes.getStartPageToken` and `changes.list` to retrieve recent changes. |
| ### `https://developers.google.com/workspace/drive/api/reference/rest/v2/changes/getStartPageToken` | Gets the starting pageToken for listing future changes. |
| ### `https://developers.google.com/workspace/drive/api/reference/rest/v2/changes/list` | Lists the changes for a user or shared drive. |
| ### `https://developers.google.com/workspace/drive/api/reference/rest/v2/changes/watch` | Subscribe to changes for a user. |