Stay organized with collectionsSave and categorize content based on your preferences.
The user and shared drive change logs are defined in theChanges and revisions overview. This guide provides more information about individual change log entries and tips for when to track changes in either the user change log or the shared drive change log.
Change entry after file moves to a shared drive
After a file is moved to a shared drive, that shared drive change log continues logging changes for that file, not the user change log. You should then query the shared drive change log to detect new changes to that item.
Change entry for individual items in a shared drive
If a non-member is granted file access to individual items in a shared drive,
changes to those items are tracked in the user change log, not the shared drive change log. This behavior is the same as non-shared drive items that are shared directly with users.
Change entry for lost access permission
If a user loses access permission to a file, the change log entry will saydeleted.
However, the file is still available to other users who still have permission to access the file. If the item is deleted for all users, it will get markeddeletedin all user change logs.
When a file moves between user corpora it may also appeardeletedeven though the user still retains access to the file. If you query change logs for multiple corpora, use theincludeCorpusRemovalsparameter inChanges.listto disambiguate corpus moves from loss of access.
For definitions of different corpora, seeFiles and folders overview.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Identify which change log to track\n\nThe user and shared drive change logs are defined in the [Changes and revisions overview](/workspace/drive/api/guides/change-overview). This guide provides more information about individual change log entries and tips for when to track changes in either the user change log or the shared drive change log.\n\nChange entry after file moves to a shared drive\n-----------------------------------------------\n\nAfter a file is moved to a shared drive, that shared drive change log continues logging changes for that file, not the user change log. You should then query the shared drive change log to detect new changes to that item.\n\nChange entry for individual items in a shared drive\n---------------------------------------------------\n\nIf a non-member is granted file access to individual items in a shared drive,\nchanges to those items are tracked in the user change log, not the shared drive change log. This behavior is the same as non-shared drive items that are shared directly with users.\n\nChange entry for lost access permission\n---------------------------------------\n\nIf a user loses access permission to a file, the change log entry will say `deleted`.\nHowever, the file is still available to other users who still have permission to access the file. If the item is deleted for all users, it will get marked `deleted` in all user change logs.\n\nWhen a file moves between user corpora it may also appear `deleted` even though the user still retains access to the file. If you query change logs for multiple corpora, use the `includeCorpusRemovals` parameter in [Changes.list](/workspace/drive/api/reference/rest/v3/changes/list) to disambiguate corpus moves from loss of access.\nFor definitions of different corpora, see [Files and folders overview](/workspace/drive/api/guides/about-files)."]]