IntegrationsGoogle workspaceActions
List Google Drive changes
List durable Drive change events for the user or shared-drive namespace. Preserves removed visibility loss; never maps removed to deleted.
drive.changes.list · Google Workspace · v1
Details
Scopes
https://www.googleapis.com/auth/drive.metadata.readonly
Input
| Name | Type | Required | Constraints |
|---|---|---|---|
(root) | object | Yes | additionalProperties false |
page_token | string | Yes | minLength 1; maxLength 512 |
drive_id | string | No | minLength 1; maxLength 256 |
page_size | integer | No | minimum 1; maximum 100 |
Output
| Name | Type | Required | Constraints |
|---|---|---|---|
(root) | object | Yes | additionalProperties false |
changes | array<object> | Yes | maxItems 100 |
changes[] | object | Yes | additionalProperties false; oneOf branch 1: required change_type, file_id, removed; change_type=file / branch 2: required change_type, removed; change_type=drive |
changes[].change_type | string | No | enum file | drive |
changes[].file_id | string | No | minLength 1; maxLength 256 |
changes[].drive_id | string | No | minLength 1; maxLength 256 |
changes[].occurred_at | string | No | maxLength 64 |
changes[].removed | boolean | No | — |
changes[].file | object | No | additionalProperties false |
changes[].file.id | string | Yes | minLength 1; maxLength 256 |
changes[].file.name | string | Yes | maxLength 512 |
changes[].file.mime_type | string | Yes | maxLength 256 |
changes[].file.parents | array<string> | No | maxItems 20 |
changes[].file.parents[] | string | Yes | maxLength 256 |
changes[].file.drive_id | string | No | maxLength 256 |
changes[].file.web_view_url | string | No | maxLength 2048 |
changes[].file.created_at | string | No | maxLength 64 |
changes[].file.updated_at | string | No | maxLength 64 |
changes[].file.trashed | boolean | No | — |
changes[].file.revision | string | No | maxLength 64 |
changes[].file.size_bytes | string | No | maxLength 32 |
changes[].file.client_side_encrypted | boolean | Yes | — |
changes[].drive | object | No | additionalProperties false |
changes[].drive.id | string | Yes | minLength 1; maxLength 256 |
changes[].drive.name | string | No | maxLength 512 |
next_page_token | string | No | maxLength 512 |
new_start_page_token | string | No | maxLength 512 |
Raw schema
Input
{
"type": "object",
"additionalProperties": false,
"properties": {
"page_token": {
"type": "string",
"minLength": 1,
"maxLength": 512
},
"drive_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"page_size": {
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"page_token"
]
}Output
{
"type": "object",
"additionalProperties": false,
"properties": {
"changes": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"properties": {
"change_type": {
"type": "string",
"enum": [
"file",
"drive"
]
},
"file_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"drive_id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"occurred_at": {
"type": "string",
"maxLength": 64
},
"removed": {
"type": "boolean"
},
"file": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"name": {
"type": "string",
"maxLength": 512
},
"mime_type": {
"type": "string",
"maxLength": 256
},
"parents": {
"type": "array",
"items": {
"type": "string",
"maxLength": 256
},
"maxItems": 20
},
"drive_id": {
"type": "string",
"maxLength": 256
},
"web_view_url": {
"type": "string",
"maxLength": 2048
},
"created_at": {
"type": "string",
"maxLength": 64
},
"updated_at": {
"type": "string",
"maxLength": 64
},
"trashed": {
"type": "boolean"
},
"revision": {
"type": "string",
"maxLength": 64
},
"size_bytes": {
"type": "string",
"maxLength": 32
},
"client_side_encrypted": {
"type": "boolean"
}
},
"required": [
"id",
"name",
"mime_type",
"client_side_encrypted"
]
},
"drive": {
"type": "object",
"additionalProperties": false,
"properties": {
"id": {
"type": "string",
"minLength": 1,
"maxLength": 256
},
"name": {
"type": "string",
"maxLength": 512
}
},
"required": [
"id"
]
}
},
"oneOf": [
{
"required": [
"change_type",
"file_id",
"removed"
],
"properties": {
"change_type": {
"enum": [
"file"
]
}
}
},
{
"required": [
"change_type",
"removed"
],
"properties": {
"change_type": {
"enum": [
"drive"
]
}
}
}
]
},
"maxItems": 100
},
"next_page_token": {
"type": "string",
"maxLength": 512
},
"new_start_page_token": {
"type": "string",
"maxLength": 512
}
},
"required": [
"changes"
]
}