# List Google Drive changes

Canonical URL: https://docs.fuse.init.inc/integrations/google-workspace/actions/drive.changes.list

List durable Drive change events for the user or shared-drive namespace. Preserves removed visibility loss; never maps removed to deleted.

Action ID: `drive.changes.list`
Provider: Google Workspace (`google_workspace`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `https://www.googleapis.com/auth/drive.metadata.readonly`

## Input schema fields

- `page_token`
- `drive_id`
- `page_size`

## Output schema fields

- `changes`
- `changes[]`
- `changes[].change_type`
- `changes[].file_id`
- `changes[].drive_id`
- `changes[].occurred_at`
- `changes[].removed`
- `changes[].file`
- `changes[].file.id`
- `changes[].file.name`
- `changes[].file.mime_type`
- `changes[].file.parents`
- `changes[].file.parents[]`
- `changes[].file.drive_id`
- `changes[].file.web_view_url`
- `changes[].file.created_at`
- `changes[].file.updated_at`
- `changes[].file.trashed`
- `changes[].file.revision`
- `changes[].file.size_bytes`
- `changes[].file.client_side_encrypted`
- `changes[].drive`
- `changes[].drive.id`
- `changes[].drive.name`
- `next_page_token`
- `new_start_page_token`

Provider overview: https://docs.fuse.init.inc/integrations/google-workspace
Actions index: https://docs.fuse.init.inc/integrations/google-workspace/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/google_workspace/actions/drive.changes.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/google_workspace/actions