Google · Schema
ChangeList
A list of changes for a user.
AdvertisingCloudDevelopersGooglePlatformSearchT1Agentic CommerceUniversal Commerce ProtocolAP2A2A
Properties
| Name | Type | Description |
|---|---|---|
| changes | array | The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched. |
| kind | string | Identifies what kind of resource this is. Value: the fixed string `"drive#changeList"`. |
| newStartPageToken | string | The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire. |
| nextPageToken | string | The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://raw.githubusercontent.com/api-evangelist/google/main/json-schema/google-change-list-schema.json",
"title": "ChangeList",
"description": "A list of changes for a user.",
"x-generated": "2026-10-03",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/google-changes-api-openapi.yml#/components/schemas/ChangeList",
"properties": {
"changes": {
"description": "The list of changes. If nextPageToken is populated, then this list may be incomplete and an additional page of results should be fetched.",
"items": {
"$ref": "#/$defs/Change"
},
"type": "array"
},
"kind": {
"default": "drive#changeList",
"description": "Identifies what kind of resource this is. Value: the fixed string `\"drive#changeList\"`.",
"type": "string"
},
"newStartPageToken": {
"description": "The starting page token for future changes. This will be present only if the end of the current changes list has been reached. The page token doesn't expire.",
"type": "string"
},
"nextPageToken": {
"description": "The page token for the next page of changes. This will be absent if the end of the changes list has been reached. The page token doesn't expire.",
"type": "string"
}
},
"type": "object",
"$defs": {
"Change": {
"description": "A change to a file or shared drive.",
"properties": {
"changeType": {
"description": "The type of the change. Possible values are `file` and `drive`.",
"type": "string"
},
"drive": {
"$ref": "#/$defs/Drive",
"description": "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."
},
"driveId": {
"description": "The ID of the shared drive associated with this change.",
"type": "string"
},
"file": {
"$ref": "#/$defs/File",
"description": "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": {
"description": "The ID of the file which has changed.",
"type": "string"
},
"kind": {
"default": "drive#change",
"description": "Identifies what kind of resource this is. Value: the fixed string `\"drive#change\"`.",
"type": "string"
},
"removed": {
"description": "Whether the file or shared drive has been removed from this list of changes, for example by deletion or loss of access.",
"type": "boolean"
},
"teamDrive": {
"$ref": "#/$defs/TeamDrive",
"deprecated": true,
"description": "Deprecated: Use `drive` instead."
},
"teamDriveId": {
"deprecated": true,
"description": "Deprecated: Use `driveId` instead.",
"type": "string"
},
"time": {
"description": "The time of this change (RFC 3339 date-time).",
"format": "date-time",
"type": "string"
},
"type": {
"deprecated": true,
"description": "Deprecated: Use `changeType` instead.",
"type": "string"
}
},
"type": "object"
},
"ContentRestriction": {
"description": "A restriction for accessing the content of the file.",
"properties": {
"ownerRestricted": {
"description": "Whether the content restriction can only be modified or removed by a user who owns the file. For files in shared drives, any user with `organizer` capabilities can modify or remove this content restriction.",
"type": "boolean"
},
"readOnly": {
"description": "Whether the content of the file is read-only. If a file is read-only, a new revision of the file may not be added, comments may not be added or modified, and the title of the file may not be modified.",
"type": "boolean"
},
"reason": {
"description": "Reason for why the content of the file is restricted. This is only mutable on requests that also set `readOnly=true`.",
"type": "string"
},
"restrictingUser": {
"$ref": "#/$defs/User",
"description": "Output only. The user who set the content restriction. Only populated if `readOnly` is true."
},
"restrictionTime": {
"description": "The time at which the content restriction was set (formatted RFC 3339 timestamp). Only populated if readOnly is true.",
"format": "date-time",
"type": "string"
},
"systemRestricted": {
"description": "Output only. Whether the content restriction was applied by the system, for example due to an esignature. Users cannot modify or remove system restricted content restrictions.",
"type": "boolean"
},
"type": {
"description": "Output only. The type of the content restriction. Currently the only possible value is `globalContentRestriction`.",
"type": "string"
}
},
"type": "object"
},
"Drive": {
"description": "Representation of a shared drive. Some resource methods (such as `drives.update`) require a `driveId`. Use the `drives.list` method to retrieve the ID for a shared drive.",
"properties": {
"backgroundImageFile": {
"description": "An image file and cropping parameters from which a background image for this shared drive is set. This is a write only field; it can only be set on `drive.drives.update` requests that don't set `themeId`. When specified, all fields of the `backgroundImageFile` must be set.",
"properties": {
"id": {
"description": "The ID of an image file in Google Drive to use for the background image.",
"type": "string"
},
"width": {
"description": "The width of the cropped image in the closed range of 0 to 1. This value represents the width of the cropped image divided by the width of the entire image. The height is computed by applying a width to height aspect ratio of 80 to 9. The resulting image must be at least 1280 pixels wide and 144 pixels high.",
"format": "float",
"type": "number"
},
"xCoordinate": {
"description": "The X coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the horizontal distance from the left side of the entire image to the left side of the cropping area divided by the width of the entire image.",
"format": "float",
"type": "number"
},
"yCoordinate": {
"description": "The Y coordinate of the upper left corner of the cropping area in the background image. This is a value in the closed range of 0 to 1. This value represents the vertical distance from the top side of the entire image to the top side of the cropping area divided by the height of the entire image.",
"format": "float",
"type": "number"
}
},
"type": "object"
},
"backgroundImageLink": {
"description": "Output only. A short-lived link to this shared drive's background image.",
"type": "string"
},
"capabilities": {
"description": "Output only. Capabilities the current user has on this shared drive.",
"properties": {
"canAddChildren": {
"description": "Output only. Whether the current user can add children to folders in this shared drive.",
"type": "boolean"
},
"canChangeCopyRequiresWriterPermissionRestriction": {
"description": "Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this shared drive.",
"type": "boolean"
},
"canChangeDomainUsersOnlyRestriction": {
"description": "Output only. Whether the current user can change the `domainUsersOnly` restriction of this shared drive.",
"type": "boolean"
},
"canChangeDriveBackground": {
"description": "Output only. Whether the current user can change the background of this shared drive.",
"type": "boolean"
},
"canChangeDriveMembersOnlyRestriction": {
"description": "Output only. Whether the current user can change the `driveMembersOnly` restriction of this shared drive.",
"type": "boolean"
},
"canChangeSharingFoldersRequiresOrganizerPermissionRestriction": {
"description": "Output only. Whether the current user can change the `sharingFoldersRequiresOrganizerPermission` restriction of this shared drive.",
"type": "boolean"
},
"canComment": {
"description": "Output only. Whether the current user can comment on files in this shared drive.",
"type": "boolean"
},
"canCopy": {
"description": "Output only. Whether the current user can copy files in this shared drive.",
"type": "boolean"
},
"canDeleteChildren": {
"description": "Output only. Whether the current user can delete children from folders in this shared drive.",
"type": "boolean"
},
"canDeleteDrive": {
"description": "Output only. Whether the current user can delete this shared drive. Attempting to delete the shared drive may still fail if there are untrashed items inside the shared drive.",
"type": "boolean"
},
"canDownload": {
"description": "Output only. Whether the current user can download files in this shared drive.",
"type": "boolean"
},
"canEdit": {
"description": "Output only. Whether the current user can edit files in this shared drive",
"type": "boolean"
},
"canListChildren": {
"description": "Output only. Whether the current user can list the children of folders in this shared drive.",
"type": "boolean"
},
"canManageMembers": {
"description": "Output only. Whether the current user can add members to this shared drive or remove them or change their role.",
"type": "boolean"
},
"canReadRevisions": {
"description": "Output only. Whether the current user can read the revisions resource of files in this shared drive.",
"type": "boolean"
},
"canRename": {
"description": "Output only. Whether the current user can rename files or folders in this shared drive.",
"type": "boolean"
},
"canRenameDrive": {
"description": "Output only. Whether the current user can rename this shared drive.",
"type": "boolean"
},
"canResetDriveRestrictions": {
"description": "Output only. Whether the current user can reset the shared drive restrictions to defaults.",
"type": "boolean"
},
"canShare": {
"description": "Output only. Whether the current user can share files or folders in this shared drive.",
"type": "boolean"
},
"canTrashChildren": {
"description": "Output only. Whether the current user can trash children from folders in this shared drive.",
"type": "boolean"
}
},
"type": "object"
},
"colorRgb": {
"description": "The color of this shared drive as an RGB hex string. It can only be set on a `drive.drives.update` request that does not set `themeId`.",
"type": "string"
},
"createdTime": {
"description": "The time at which the shared drive was created (RFC 3339 date-time).",
"format": "date-time",
"type": "string"
},
"hidden": {
"description": "Whether the shared drive is hidden from default view.",
"type": "boolean"
},
"id": {
"description": "Output only. The ID of this shared drive which is also the ID of the top level folder of this shared drive.",
"type": "string"
},
"kind": {
"default": "drive#drive",
"description": "Output only. Identifies what kind of resource this is. Value: the fixed string `\"drive#drive\"`.",
"type": "string"
},
"name": {
"description": "The name of this shared drive.",
"type": "string"
},
"orgUnitId": {
"description": "Output only. The organizational unit of this shared drive. This field is only populated on `drives.list` responses when the `useDomainAdminAccess` parameter is set to `true`.",
"type": "string"
},
"restrictions": {
"description": "A set of restrictions that apply to this shared drive or items inside this shared drive. Note that restrictions can't be set when creating a shared drive. To add a restriction, first create a shared drive and then use `drives.update` to add restrictions.",
"properties": {
"adminManagedRestrictions": {
"description": "Whether administrative privileges on this shared drive are required to modify restrictions.",
"type": "boolean"
},
"copyRequiresWriterPermission": {
"description": "Whether the options to copy, print, or download files inside this shared drive, should be disabled for readers and commenters. When this restriction is set to `true`, it will override the similarly named field to `true` for any file inside this shared drive.",
"type": "boolean"
},
"domainUsersOnly": {
"description": "Whether access to this shared drive and items inside this shared drive is restricted to users of the domain to which this shared drive belongs. This restriction may be overridden by other sharing policies controlled outside of this shared drive.",
"type": "boolean"
},
"driveMembersOnly": {
"description": "Whether access to items inside this shared drive is restricted to its members.",
"type": "boolean"
},
"sharingFoldersRequiresOrganizerPermission": {
"description": "If true, only users with the organizer role can share folders. If false, users with either the organizer role or the file organizer role can share folders.",
"type": "boolean"
}
},
"type": "object"
},
"themeId": {
"description": "The ID of the theme from which the background image and color will be set. The set of possible `driveThemes` can be retrieved from a `drive.about.get` response. When not specified on a `drive.drives.create` request, a random theme is chosen from which the background image and color are set. This is a write-only field; it can only be set on requests that don't set `colorRgb` or `backgroundImageFile`.",
"type": "string"
}
},
"type": "object"
},
"File": {
"description": "The metadata for a file. Some resource methods (such as `files.update`) require a `fileId`. Use the `files.list` method to retrieve the ID for a file.",
"properties": {
"appProperties": {
"additionalProperties": {
"type": "string"
},
"description": "A collection of arbitrary key-value pairs which are private to the requesting app.\nEntries with null values are cleared in update and copy requests. These properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties.",
"type": "object"
},
"capabilities": {
"description": "Output only. Capabilities the current user has on this file. Each capability corresponds to a fine-grained action that a user may take.",
"properties": {
"canAcceptOwnership": {
"description": "Output only. Whether the current user is the pending owner of the file. Not populated for shared drive files.",
"type": "boolean"
},
"canAddChildren": {
"description": "Output only. Whether the current user can add children to this folder. This is always false when the item is not a folder.",
"type": "boolean"
},
"canAddFolderFromAnotherDrive": {
"description": "Output only. Whether the current user can add a folder from another drive (different shared drive or My Drive) to this folder. This is false when the item is not a folder. Only populated for items in shared drives.",
"type": "boolean"
},
"canAddMyDriveParent": {
"description": "Output only. Whether the current user can add a parent for the item without removing an existing parent in the same request. Not populated for shared drive files.",
"type": "boolean"
},
"canChangeCopyRequiresWriterPermission": {
"description": "Output only. Whether the current user can change the `copyRequiresWriterPermission` restriction of this file.",
"type": "boolean"
},
"canChangeSecurityUpdateEnabled": {
"description": "Output only. Whether the current user can change the securityUpdateEnabled field on link share metadata.",
"type": "boolean"
},
"canChangeViewersCanCopyContent": {
"deprecated": true,
"description": "Deprecated: Output only.",
"type": "boolean"
},
"canComment": {
"description": "Output only. Whether the current user can comment on this file.",
"type": "boolean"
},
"canCopy": {
"description": "Output only. Whether the current user can copy this file. For an item in a shared drive, whether the current user can copy non-folder descendants of this item, or this item itself if it is not a folder.",
"type": "boolean"
},
"canDelete": {
"description": "Output only. Whether the current user can delete this file.",
"type": "boolean"
},
"canDeleteChildren": {
"description": "Output only. Whether the current user can delete children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.",
"type": "boolean"
},
"canDownload": {
"description": "Output only. Whether the current user can download this file.",
"type": "boolean"
},
"canEdit": {
"description": "Output only. Whether the current user can edit this file. Other factors may limit the type of changes a user can make to a file. For example, see `canChangeCopyRequiresWriterPermission` or `canModifyContent`.",
"type": "boolean"
},
"canListChildren": {
"description": "Output only. Whether the current user can list the children of this folder. This is always false when the item is not a folder.",
"type": "boolean"
},
"canModifyContent": {
"description": "Output only. Whether the current user can modify the content of this file.",
"type": "boolean"
},
"canModifyContentRestriction": {
"deprecated": true,
"description": "Deprecated: Output only. Use one of `canModifyEditorContentRestriction`, `canModifyOwnerContentRestriction` or `canRemoveContentRestriction`.",
"type": "boolean"
},
"canModifyEditorContentRestriction": {
"description": "Output only. Whether the current user can add or modify content restrictions on the file which are editor restricted.",
"type": "boolean"
},
"canModifyLabels": {
"description": "Output only. Whether the current user can modify the labels on the file.",
"type": "boolean"
},
"canModifyOwnerContentRestriction": {
"description": "Output only. Whether the current user can add or modify content restrictions which are owner restricted.",
"type": "boolean"
},
"canMoveChildrenOutOfDrive": {
"description": "Output only. Whether the current user can move children of this folder outside of the shared drive. This is false when the item is not a folder. Only populated for items in shared drives.",
"type": "boolean"
},
"canMoveChildrenOutOfTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveChildrenOutOfDrive` instead.",
"type": "boolean"
},
"canMoveChildrenWithinDrive": {
"description": "Output only. Whether the current user can move children of this folder within this drive. This is false when the item is not a folder. Note that a request to move the child may still fail depending on the current user's access to the child and to the destination folder.",
"type": "boolean"
},
"canMoveChildrenWithinTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveChildrenWithinDrive` instead.",
"type": "boolean"
},
"canMoveItemIntoTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveItemOutOfDrive` instead.",
"type": "boolean"
},
"canMoveItemOutOfDrive": {
"description": "Output only. Whether the current user can move this item outside of this drive by changing its parent. Note that a request to change the parent of the item may still fail depending on the new parent that is being added.",
"type": "boolean"
},
"canMoveItemOutOfTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveItemOutOfDrive` instead.",
"type": "boolean"
},
"canMoveItemWithinDrive": {
"description": "Output only. Whether the current user can move this item within this drive. Note that a request to change the parent of the item may still fail depending on the new parent that is being added and the parent that is being removed.",
"type": "boolean"
},
"canMoveItemWithinTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveItemWithinDrive` instead.",
"type": "boolean"
},
"canMoveTeamDriveItem": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canMoveItemWithinDrive` or `canMoveItemOutOfDrive` instead.",
"type": "boolean"
},
"canReadDrive": {
"description": "Output only. Whether the current user can read the shared drive to which this file belongs. Only populated for items in shared drives.",
"type": "boolean"
},
"canReadLabels": {
"description": "Output only. Whether the current user can read the labels on the file.",
"type": "boolean"
},
"canReadRevisions": {
"description": "Output only. Whether the current user can read the revisions resource of this file. For a shared drive item, whether revisions of non-folder descendants of this item, or this item itself if it is not a folder, can be read.",
"type": "boolean"
},
"canReadTeamDrive": {
"deprecated": true,
"description": "Deprecated: Output only. Use `canReadDrive` instead.",
"type": "boolean"
},
"canRemoveChildren": {
"description": "Output only. Whether the current user can remove children from this folder. This is always false when the item is not a folder. For a folder in a shared drive, use `canDeleteChildren` or `canTrashChildren` instead.",
"type": "boolean"
},
"canRemoveContentRestriction": {
"description": "Output only. Whether there is a content restriction on the file that can be removed by the current user.",
"type": "boolean"
},
"canRemoveMyDriveParent": {
"description": "Output only. Whether the current user can remove a parent from the item without adding another parent in the same request. Not populated for shared drive files.",
"type": "boolean"
},
"canRename": {
"description": "Output only. Whether the current user can rename this file.",
"type": "boolean"
},
"canShare": {
"description": "Output only. Whether the current user can modify the sharing settings for this file.",
"type": "boolean"
},
"canTrash": {
"description": "Output only. Whether the current user can move this file to trash.",
"type": "boolean"
},
"canTrashChildren": {
"description": "Output only. Whether the current user can trash children of this folder. This is false when the item is not a folder. Only populated for items in shared drives.",
"type": "boolean"
},
"canUntrash": {
"description": "Output only. Whether the current user can restore this file from trash.",
"type": "boolean"
}
},
"type": "object"
},
"contentHints": {
"description": "Additional information about the content of the file. These fields are never populated in responses.",
"properties": {
"indexableText": {
"description": "Text to be indexed for the file to improve fullText queries. This is limited to 128KB in length and may contain HTML elements.",
"type": "string"
},
"thumbnail": {
"description": "A thumbnail for the file. This will only be used if Google Drive cannot generate a standard thumbnail.",
"properties": {
"image": {
"description": "The thumbnail data encoded with URL-safe Base64 (RFC 4648 section 5).",
"format": "byte",
"type": "string"
},
"mimeType": {
"description": "The MIME type of the thumbnail.",
"type": "string"
}
},
"type": "object"
}
},
"type": "object"
},
"contentRestrictions": {
"description": "Restrictions for accessing the content of the file. Only populated if such a restriction exists.",
"items": {
"$ref": "#/$defs/ContentRestriction"
},
"type": "array"
},
"copyRequiresWriterPermission": {
"description": "Whether the options to copy, print, or download this file, should be disabled for readers and commenters.",
"type": "boolean"
},
"createdTime": {
"description": "The time at which the file was created (RFC 3339 date-time).",
"format": "date-time",
"type": "string"
},
"description": {
"description": "A short description of the file.",
"type": "string"
},
"driveId": {
"description": "Output only. ID of the shared drive the file resides in. Only populated for items in shared drives.",
"type": "string"
},
"explicitlyTrashed": {
"description": "Output only. Whether the file has been explicitly trashed, as opposed to recursively trashed from a parent folder.",
"type": "boolean"
},
"exportLinks": {
"additionalProperties": {
"type": "string"
},
"description": "Output only. Links for exporting Docs Editors files to specific formats.",
"readOnly": true,
"type": "object"
},
"fileExtension": {
"description": "Output only. The final component of `fullFileExtension`. This is only available for files with binary content in Google Drive.",
"type": "string"
},
"folderColorRgb": {
"description": "The color for a folder or a shortcut to a folder as an RGB hex string. The supported colors are published in the `folderColorPalette` field of the About resource. If an unsupported color is specified, the closest color in the palette is used instead.",
"type": "string"
},
"fullFileExtension": {
"description": "Output only. The full file extension extracted from the `name` field. May contain multiple concatenated extensions, such as \"tar.gz\". This is only available for files with binary content in Google Drive. This is automatically updated when the `name` field changes, however it is not cleared if the new name does not contain a valid extension.",
"type": "string"
},
"hasAugmentedPermissions": {
"description": "Output only. Whether there are permissions directly on this file. This field is only populated for items in shared drives.",
"type": "boolean"
},
"hasThumbnail": {
"description": "Output only. Whether this file has a thumbnail. This does not indicate whether the requesting app has access to the thumbnail. To check access, look for the presence of the thumbnailLink field.",
"type": "boolean"
},
"headRevisionId": {
"description": "Output only. The ID of the file's head revision. This is currently only available for files with binary content in Google Drive.",
"type": "string"
},
"iconLink": {
"description": "Output only. A static, unauthenticated link to the file's icon.",
"type": "string"
},
"id": {
"description": "The ID of the file.",
"type": "string"
},
"imageMediaMetadata": {
"description": "Output only. Additional metadata about image media, if available.",
"properties": {
"aperture": {
"description": "Output only. The aperture used to create the photo (f-number).",
"format": "float",
"type": "number"
},
"cameraMake": {
"description": "Output only. The make of the camera used to create the photo.",
"type": "string"
},
"cameraModel": {
"description": "Output only. The model of the camera used to create the photo.",
"type": "string"
},
"colorSpace": {
"description": "Output only. The color space of the photo.",
"type": "string"
},
"exposureBias": {
"description": "Output only. The exposure bias of the photo (APEX value).",
"format": "float",
"type": "number"
},
"exposureMode": {
"description": "Output only. The exposure mode used to create the photo.",
"type": "string"
},
"exposureTime": {
"description": "Output only. The
# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/google/refs/heads/main/json-schema/google-change-list-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/google-change-list"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.