The Drive API changes collection can maintain a local inventory more efficiently than repeatedly listing every file. Store the appropriate page token and process all returned pages. A notification that changes exist is not itself the changed file content.
Establish the token and scope
Use changes.getStartPageToken for the authorized account or supported shared-drive context and retain the result securely. Define how the initial inventory and subsequent change processing fit together so changes during initialization are not silently skipped.
Keep each account or drive’s token context distinct. A token from one identity or corpus should not be treated as a universal organization-wide checkpoint.
Process the complete feed
Call changes.list with the stored token and request the needed fields, including continuation and new-start tokens. Follow nextPageToken until the current batch is exhausted, then retain the response’s newStartPageToken for the next poll.
Handle the current file state and supported removed-item behavior according to the response and permissions. Do not assume every change entry supplies an accessible full document or that a missing field has one universal meaning.
Make processing recoverable
Design local updates to be replay-safe and advance durable checkpoints only after the corresponding work is safely recorded. That application design prevents a crash from turning a partially processed page into an apparent complete update. Handle errors without discarding the last valid state blindly. Google documents changes.watch notifications as signals to fetch the actual change feed, not detailed changes themselves. Shared-drive integration needs its documented support parameters. Test pagination, interruption, and repeated delivery with controlled fixtures before trusting production coverage, and keep operational logs free of unnecessary document contents or credentials.
References
- Retrieve changes | Google Drive | Google for Developers
- Implement shared drive support | Google Drive | Google for Developers
- Return specific fields | Google Drive | Google for Developers
Reviewed against the linked official product guidance on November 3, 2026. Features, limits, screen labels, and access can vary by account, platform, region, and organization policy.