{ "version_module": true, "resources": { "activity": { "methods": { "query": { "response": { "$ref": "QueryDriveActivityResponse" }, "scopes": [ "https://www.googleapis.com/auth/drive.activity", "https://www.googleapis.com/auth/drive.activity.readonly" ], "parameters": {}, "request": { "$ref": "QueryDriveActivityRequest" }, "id": "driveactivity.activity.query", "path": "v2/activity:query", "description": "Query past activity in Google Drive.", "httpMethod": "POST", "parameterOrder": [], "flatPath": "v2/activity:query" } } } }, "batchPath": "batch", "servicePath": "", "baseUrl": "https://driveactivity.googleapis.com/", "id": "driveactivity:v2", "parameters": { "key": { "type": "string", "location": "query", "description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token." }, "uploadType": { "description": "Legacy upload protocol for media (e.g. \"media\", \"multipart\").", "type": "string", "location": "query" }, "oauth_token": { "location": "query", "type": "string", "description": "OAuth 2.0 token for the current user." }, "callback": { "location": "query", "description": "JSONP", "type": "string" }, "access_token": { "location": "query", "type": "string", "description": "OAuth access token." }, "alt": { "enumDescriptions": [ "Responses with Content-Type of application/json", "Media download with context-dependent Content-Type", "Responses with Content-Type of application/x-protobuf" ], "description": "Data format for response.", "default": "json", "type": "string", "enum": [ "json", "media", "proto" ], "location": "query" }, "fields": { "type": "string", "location": "query", "description": "Selector specifying which fields to include in a partial response." }, "upload_protocol": { "description": "Upload protocol for media (e.g. \"raw\", \"multipart\").", "type": "string", "location": "query" }, "prettyPrint": { "description": "Returns response with indentations and line breaks.", "type": "boolean", "location": "query", "default": "true" }, "$.xgafv": { "enumDescriptions": [ "v1 error format", "v2 error format" ], "location": "query", "description": "V1 error format.", "type": "string", "enum": [ "1", "2" ] }, "quotaUser": { "type": "string", "description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters.", "location": "query" } }, "protocol": "rest", "revision": "20260831", "icons": { "x32": "http://www.google.com/images/icons/product/search-32.gif", "x16": "http://www.google.com/images/icons/product/search-16.gif" }, "version": "v2", "kind": "discovery#restDescription", "documentationLink": "https://developers.google.com/workspace/drive/activity/", "ownerDomain": "google.com", "basePath": "", "name": "driveactivity", "discoveryVersion": "v1", "mtlsRootUrl": "https://driveactivity.mtls.googleapis.com/", "canonicalName": "Drive Activity", "ownerName": "Google", "fullyEncodeReservedExpansion": true, "title": "Drive Activity API", "schemas": { "RestrictionChange": { "id": "RestrictionChange", "type": "object", "description": "Information about restriction policy changes to a feature.", "properties": { "feature": { "enumDescriptions": [ "The feature which changed restriction settings was not available.", "When restricted, this prevents items from being shared outside the domain.", "When restricted, this prevents direct sharing of individual items.", "Deprecated: Use READERS_CAN_DOWNLOAD instead.", "When restricted, this prevents use of Drive File Stream.", "When restricted, this limits sharing of folders to managers only.", "When restricted, this prevents actions like copy, download, and print for readers. Replaces ITEM_DUPLICATION.", "When restricted, this prevents actions like copy, download, and print for writers." ], "type": "string", "enum": [ "FEATURE_UNSPECIFIED", "SHARING_OUTSIDE_DOMAIN", "DIRECT_SHARING", "ITEM_DUPLICATION", "DRIVE_FILE_STREAM", "FILE_ORGANIZER_CAN_SHARE_FOLDERS", "READERS_CAN_DOWNLOAD", "WRITERS_CAN_DOWNLOAD" ], "description": "The feature which had a change in restriction policy.", "enumDeprecated": [ false, false, false, true, false, false, false, false ] }, "newRestriction": { "description": "The restriction in place after the change.", "type": "string", "enum": [ "RESTRICTION_UNSPECIFIED", "UNRESTRICTED", "FULLY_RESTRICTED" ], "enumDescriptions": [ "The type of restriction is not available.", "The feature is available without restriction.", "The use of this feature is fully restricted." ] } } }, "File": { "type": "object", "id": "File", "properties": {}, "description": "This item is deprecated; please see `DriveFile` instead.", "deprecated": true }, "TextList": { "properties": { "values": { "type": "array", "items": { "$ref": "Text" }, "description": "Text values." } }, "type": "object", "id": "TextList", "description": "Wrapper for Text List Field value." }, "Upload": { "description": "An object was uploaded into Drive.", "id": "Upload", "properties": {}, "type": "object" }, "PermissionChange": { "type": "object", "description": "A change of the permission setting on an item.", "id": "PermissionChange", "properties": { "removedPermissions": { "description": "The set of permissions removed by this change.", "items": { "$ref": "Permission" }, "type": "array" }, "addedPermissions": { "type": "array", "description": "The set of permissions added by this change.", "items": { "$ref": "Permission" } } } }, "DriveItemReference": { "description": "A lightweight reference to a Drive item, such as a file or folder.", "id": "DriveItemReference", "properties": { "title": { "description": "The title of the Drive item.", "type": "string" }, "name": { "description": "The target Drive item. The format is `items/ITEM_ID`.", "type": "string" }, "driveFile": { "$ref": "DriveFile", "description": "The Drive item is a file." }, "file": { "$ref": "File", "deprecated": true, "description": "This field is deprecated; please use the `driveFile` field instead." }, "folder": { "deprecated": true, "$ref": "Folder", "description": "This field is deprecated; please use the `driveFolder` field instead." }, "driveFolder": { "$ref": "DriveFolder", "description": "The Drive item is a folder. Includes information about the type of folder." } }, "type": "object" }, "KnownUser": { "properties": { "personName": { "type": "string", "description": "The identifier for this user that can be used with the People API to get more information. The format is `people/ACCOUNT_ID`. See https://developers.google.com/people/." }, "isCurrentUser": { "type": "boolean", "description": "True if this is the user making the request." } }, "type": "object", "id": "KnownUser", "description": "A known user." }, "UserList": { "type": "object", "description": "Wrapper for UserList Field value.", "properties": { "values": { "type": "array", "description": "User values.", "items": { "$ref": "SingleUser" } } }, "id": "UserList" }, "DriveItem": { "type": "object", "description": "A Drive item, such as a file or folder.", "id": "DriveItem", "properties": { "file": { "deprecated": true, "$ref": "File", "description": "This field is deprecated; please use the `driveFile` field instead." }, "driveFile": { "description": "The Drive item is a file.", "$ref": "DriveFile" }, "owner": { "description": "Information about the owner of this Drive item.", "$ref": "Owner" }, "name": { "type": "string", "description": "The target Drive item. The format is `items/ITEM_ID`." }, "driveFolder": { "$ref": "DriveFolder", "description": "The Drive item is a folder. Includes information about the type of folder." }, "folder": { "description": "This field is deprecated; please use the `driveFolder` field instead.", "deprecated": true, "$ref": "Folder" }, "title": { "type": "string", "description": "The title of the Drive item." }, "mimeType": { "type": "string", "description": "The MIME type of the Drive item. See https://developers.google.com/workspace/drive/v3/web/mime-types." } } }, "New": { "type": "object", "description": "An object was created from scratch.", "properties": {}, "id": "New" }, "DeletedUser": { "id": "DeletedUser", "properties": {}, "type": "object", "description": "A user whose account has since been deleted." }, "Impersonation": { "type": "object", "properties": { "impersonatedUser": { "description": "The impersonated user.", "$ref": "User" } }, "description": "Information about an impersonation, where an admin acts on behalf of an end user. Information about the acting admin is not currently available.", "id": "Impersonation" }, "Assignment": { "id": "Assignment", "properties": { "subtype": { "type": "string", "enum": [ "SUBTYPE_UNSPECIFIED", "ADDED", "DELETED", "REPLY_ADDED", "REPLY_DELETED", "RESOLVED", "REOPENED", "REASSIGNED" ], "enumDescriptions": [ "Subtype not available.", "An assignment was added.", "An assignment was deleted.", "An assignment reply was added.", "An assignment reply was deleted.", "An assignment was resolved.", "A resolved assignment was reopened.", "An assignment was reassigned." ], "description": "The sub-type of this event." }, "assignedUser": { "$ref": "User", "description": "The user to whom the comment was assigned." } }, "description": "A comment with an assignment.", "type": "object" }, "Owner": { "properties": { "user": { "description": "The user that owns the Drive item.", "$ref": "User" }, "domain": { "$ref": "Domain", "description": "The domain of the Drive item owner." }, "teamDrive": { "$ref": "TeamDriveReference", "description": "This field is deprecated; please use the `drive` field instead.", "deprecated": true }, "drive": { "description": "The drive that owns the item.", "$ref": "DriveReference" } }, "type": "object", "id": "Owner", "description": "Information about the owner of a Drive item." }, "Edit": { "type": "object", "properties": {}, "id": "Edit", "description": "An empty message indicating an object was edited." }, "QueryDriveActivityRequest": { "description": "The request message for querying Drive activity.", "id": "QueryDriveActivityRequest", "properties": { "pageToken": { "description": "The token identifies which page of results to return. Set this to the next_page_token value returned from a previous query to obtain the following page of results. If not set, the first page of results is returned.", "type": "string" }, "filter": { "description": "The filtering for items returned from this query request. The format of the filter string is a sequence of expressions, joined by an optional \"AND\", where each expression is of the form \"field operator value\". Supported fields: - `time`: Uses numerical operators on date values either in terms of milliseconds since Jan 1, 1970 or in RFC 3339 format. Examples: - `time \u003e 1452409200000 AND time \u003c= 1492812924310` - `time \u003e= \"2016-01-10T01:02:03-05:00\"` - `detail.action_detail_case`: Uses the \"has\" operator (:) and either a singular value or a list of allowed action types enclosed in parentheses, separated by a space. To exclude a result from the response, prepend a hyphen (`-`) to the beginning of the filter string. Examples: - `detail.action_detail_case:RENAME` - `detail.action_detail_case:(CREATE RESTORE)` - `-detail.action_detail_case:MOVE` ", "type": "string" }, "itemName": { "description": "Return activities for this Drive item. The format is `items/ITEM_ID`.", "type": "string" }, "ancestorName": { "description": "Return activities for this Drive folder, plus all children and descendants. The format is `items/ITEM_ID`.", "type": "string" }, "consolidationStrategy": { "description": "Details on how to consolidate related actions that make up the activity. If not set, then related actions aren't consolidated.", "$ref": "ConsolidationStrategy" }, "pageSize": { "format": "int32", "description": "The minimum number of activities desired in the response; the server attempts to return at least this quantity. The server may also return fewer activities if it has a partial response ready before the request times out. If not set, a default value is used.", "type": "integer" } }, "type": "object" }, "AnonymousUser": { "id": "AnonymousUser", "description": "Empty message representing an anonymous user or indicating the authenticated user should be anonymized.", "properties": {}, "type": "object" }, "FileComment": { "description": "A comment on a file.", "id": "FileComment", "type": "object", "properties": { "legacyCommentId": { "description": "The comment in the discussion thread. This identifier is an opaque string compatible with the Drive API; see https://developers.google.com/workspace/drive/v3/reference/comments/get", "type": "string" }, "linkToDiscussion": { "type": "string", "description": "The link to the discussion thread containing this comment, for example, `https://docs.google.com/DOCUMENT_ID/edit?disco=THREAD_ID`." }, "legacyDiscussionId": { "description": "The discussion thread to which the comment was added. This identifier is an opaque string compatible with the Drive API and references the first comment in a discussion; see https://developers.google.com/workspace/drive/v3/reference/comments/get", "type": "string" }, "parent": { "$ref": "DriveItem", "description": "The Drive item containing this comment." } } }, "TeamDriveReference": { "id": "TeamDriveReference", "properties": { "title": { "description": "This field is deprecated; please see `DriveReference.title` instead.", "type": "string" }, "name": { "type": "string", "description": "This field is deprecated; please see `DriveReference.name` instead." } }, "description": "This item is deprecated; please see `DriveReference` instead.", "type": "object", "deprecated": true }, "SettingsChange": { "properties": { "restrictionChanges": { "type": "array", "description": "The set of changes made to restrictions.", "items": { "$ref": "RestrictionChange" } } }, "description": "Information about settings changes.", "id": "SettingsChange", "type": "object" }, "Selection": { "type": "object", "description": "Wrapper for Selection Field value as combined value/display_name pair for selected choice.", "id": "Selection", "properties": { "displayName": { "description": "Selection value as human-readable display string.", "type": "string" }, "value": { "type": "string", "description": "Selection value as Field Choice ID." } } }, "Administrator": { "type": "object", "properties": {}, "description": "Empty message representing an administrator.", "id": "Administrator" }, "ApplicationReference": { "properties": { "type": { "description": "The reference type corresponding to this event.", "type": "string", "enum": [ "UNSPECIFIED_REFERENCE_TYPE", "LINK", "DISCUSS" ], "enumDescriptions": [ "The type is not available.", "The links of one or more Drive items were posted.", "Comments were made regarding a Drive item." ] } }, "id": "ApplicationReference", "type": "object", "description": "Activity in applications other than Drive." }, "Move": { "id": "Move", "properties": { "removedParents": { "items": { "$ref": "TargetReference" }, "type": "array", "description": "The removed parent object(s)." }, "addedParents": { "type": "array", "description": "The added parent object(s).", "items": { "$ref": "TargetReference" } } }, "type": "object", "description": "An object was moved." }, "Text": { "properties": { "value": { "type": "string", "description": "Value of Text Field." } }, "type": "object", "id": "Text", "description": "Wrapper for Text Field value." }, "Group": { "properties": { "email": { "type": "string", "description": "The email address of the group." }, "title": { "type": "string", "description": "The title of the group." } }, "type": "object", "description": "Information about a group.", "id": "Group" }, "TargetReference": { "type": "object", "description": "A lightweight reference to the target of activity.", "id": "TargetReference", "properties": { "driveItem": { "$ref": "DriveItemReference", "description": "The target is a Drive item." }, "teamDrive": { "$ref": "TeamDriveReference", "deprecated": true, "description": "This field is deprecated; please use the `drive` field instead." }, "drive": { "description": "The target is a shared drive.", "$ref": "DriveReference" } } }, "TeamDrive": { "deprecated": true, "id": "TeamDrive", "description": "This item is deprecated; please see `Drive` instead.", "type": "object", "properties": { "root": { "$ref": "DriveItem", "description": "This field is deprecated; please see `Drive.root` instead." }, "title": { "description": "This field is deprecated; please see `Drive.title` instead.", "type": "string" }, "name": { "description": "This field is deprecated; please see `Drive.name` instead.", "type": "string" } } }, "Date": { "id": "Date", "description": "Wrapper for Date Field value.", "properties": { "value": { "type": "string", "description": "Date value.", "format": "google-datetime" } }, "type": "object" }, "QueryDriveActivityResponse": { "description": "Response message for querying Drive activity.", "id": "QueryDriveActivityResponse", "properties": { "nextPageToken": { "description": "Token to retrieve the next page of results, or empty if there are no more results in the list.", "type": "string" }, "activities": { "items": { "$ref": "DriveActivity" }, "type": "array", "description": "List of activity requested." } }, "type": "object" }, "Delete": { "description": "An object was deleted.", "type": "object", "id": "Delete", "properties": { "type": { "type": "string", "enum": [ "TYPE_UNSPECIFIED", "TRASH", "PERMANENT_DELETE" ], "enumDescriptions": [ "Deletion type is not available.", "An object was put into the trash.", "An object was deleted permanently." ], "description": "The type of delete action taken." } } }, "ConsolidationStrategy": { "id": "ConsolidationStrategy", "properties": { "none": { "description": "The individual activities are not consolidated.", "$ref": "NoConsolidation" }, "legacy": { "$ref": "Legacy", "description": "The individual activities are consolidated using the legacy strategy." } }, "type": "object", "description": "How the individual activities are consolidated. If a set of activities is related they can be consolidated into one combined activity, such as one actor performing the same action on multiple targets, or multiple actors performing the same action on a single target. The strategy defines the rules for which activities are related." }, "Create": { "properties": { "copy": { "description": "If present, indicates the object was created by copying an existing Drive object.", "$ref": "Copy" }, "upload": { "$ref": "Upload", "description": "If present, indicates the object originated externally and was uploaded to Drive." }, "new": { "description": "If present, indicates the object was newly created (e.g. as a blank document), not derived from a Drive object or external object.", "$ref": "New" } }, "id": "Create", "description": "An object was created.", "type": "object" }, "FieldValue": { "type": "object", "properties": { "user": { "$ref": "SingleUser", "description": "User Field value." }, "selection": { "description": "Selection Field value.", "$ref": "Selection" }, "integer": { "description": "Integer Field value.", "$ref": "Integer" }, "text": { "description": "Text Field value.", "$ref": "Text" }, "date": { "description": "Date Field value.", "$ref": "Date" }, "userList": { "$ref": "UserList", "description": "User List Field value." }, "selectionList": { "$ref": "SelectionList", "description": "Selection List Field value." }, "textList": { "description": "Text List Field value.", "$ref": "TextList" } }, "id": "FieldValue", "description": "Contains a value of a Field." }, "DriveReference": { "description": "A lightweight reference to a shared drive.", "type": "object", "id": "DriveReference", "properties": { "name": { "description": "The resource name of the shared drive. The format is `COLLECTION_ID/DRIVE_ID`. Clients should not assume a specific collection ID for this resource name.", "type": "string" }, "title": { "description": "The title of the shared drive.", "type": "string" } } }, "Copy": { "type": "object", "properties": { "originalObject": { "$ref": "TargetReference", "description": "The original object." } }, "description": "An object was created by copying an existing object.", "id": "Copy" }, "UnknownUser": { "description": "A user about whom nothing is currently known.", "type": "object", "id": "UnknownUser", "properties": {} }, "SelectionList": { "id": "SelectionList", "properties": { "values": { "type": "array", "description": "Selection values.", "items": { "$ref": "Selection" } } }, "type": "object", "description": "Wrapper for SelectionList Field value." }, "User": { "description": "Information about an end user.", "type": "object", "id": "User", "properties": { "deletedUser": { "description": "A user whose account has since been deleted.", "$ref": "DeletedUser" }, "knownUser": { "$ref": "KnownUser", "description": "A known user." }, "unknownUser": { "description": "A user about whom nothing is currently known.", "$ref": "UnknownUser" } } }, "Comment": { "description": "A change about comments on an object.", "type": "object", "properties": { "mentionedUsers": { "items": { "$ref": "User" }, "type": "array", "description": "Users who are mentioned in this comment." }, "assignment": { "description": "A change on an assignment.", "$ref": "Assignment" }, "suggestion": { "description": "A change on a suggestion.", "$ref": "Suggestion" }, "post": { "$ref": "Post", "description": "A change on a regular posted comment." } }, "id": "Comment" }, "AppliedLabelChangeDetail": { "id": "AppliedLabelChangeDetail", "description": "A change made to a Label on the Target.", "type": "object", "properties": { "fieldChanges": { "type": "array", "description": "Field Changes. Only present if `types` contains `LABEL_FIELD_VALUE_CHANGED`.", "items": { "$ref": "FieldValueChange" } }, "title": { "description": "The human-readable title of the label that changed.", "type": "string" }, "label": { "description": "The Label name representing the Label that changed. This name always contains the revision of the Label that was used when this Action occurred. The format is `labels/id@revision`.", "type": "string" }, "types": { "items": { "enumDescriptions": [ "The type of change to this Label is not available.", "The identified Label was added to the Target.", "The identified Label was removed from the Target.", "Field values were changed on the Target.", "The Label was applied as a side-effect of Drive item creation." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "LABEL_ADDED", "LABEL_REMOVED", "LABEL_FIELD_VALUE_CHANGED", "LABEL_APPLIED_BY_ITEM_CREATE" ] }, "description": "The types of changes made to the Label on the Target.", "type": "array" } } }, "Actor": { "properties": { "impersonation": { "description": "An account acting on behalf of another.", "$ref": "Impersonation" }, "administrator": { "description": "An administrator.", "$ref": "Administrator" }, "system": { "$ref": "SystemEvent", "description": "A non-user actor (i.e. system triggered)." }, "anonymous": { "description": "An anonymous user.", "$ref": "AnonymousUser" }, "user": { "description": "An end user.", "$ref": "User" } }, "type": "object", "id": "Actor", "description": "The actor of a Drive activity." }, "ActionDetail": { "description": "Data describing the type and additional information of an action.", "properties": { "appliedLabelChange": { "description": "Label was changed.", "$ref": "AppliedLabelChange" }, "create": { "$ref": "Create", "description": "An object was created." }, "reference": { "description": "An object was referenced in an application outside of Drive/Docs.", "$ref": "ApplicationReference" }, "dlpChange": { "$ref": "DataLeakPreventionChange", "description": "A change happened in data leak prevention status." }, "delete": { "$ref": "Delete", "description": "An object was deleted." }, "permissionChange": { "description": "The permission on an object was changed.", "$ref": "PermissionChange" }, "rename": { "$ref": "Rename", "description": "An object was renamed." }, "move": { "$ref": "Move", "description": "An object was moved." }, "restore": { "description": "A deleted object was restored.", "$ref": "Restore" }, "settingsChange": { "description": "Settings were changed.", "$ref": "SettingsChange" }, "edit": { "description": "An object was edited.", "$ref": "Edit" }, "comment": { "description": "A change about comments was made.", "$ref": "Comment" } }, "id": "ActionDetail", "type": "object" }, "Target": { "description": "Information about the target of activity. For more information on how activity history is shared with users, see [Activity history visibility](https://developers.google.com/workspace/drive/activity/v2#activityhistory).", "type": "object", "id": "Target", "properties": { "teamDrive": { "$ref": "TeamDrive", "description": "This field is deprecated; please use the `drive` field instead.", "deprecated": true }, "drive": { "description": "The target is a shared drive.", "$ref": "Drive" }, "driveItem": { "description": "The target is a Drive item.", "$ref": "DriveItem" }, "fileComment": { "$ref": "FileComment", "description": "The target is a comment on a Drive file." } } }, "SingleUser": { "id": "SingleUser", "properties": { "value": { "description": "User value as email.", "type": "string" } }, "description": "Wrapper for User Field value.", "type": "object" }, "FieldValueChange": { "properties": { "fieldId": { "description": "The ID of this field. Field IDs are unique within a Label.", "type": "string" }, "oldValue": { "$ref": "FieldValue", "description": "The value that was previously set on the field. If not present, the field was newly set. At least one of {old_value|new_value} is always set." }, "displayName": { "description": "The human-readable display name for this field.", "type": "string" }, "newValue": { "description": "The value that is now set on the field. If not present, the field was cleared. At least one of {old_value|new_value} is always set.", "$ref": "FieldValue" } }, "type": "object", "description": "Change to a Field value.", "id": "FieldValueChange" }, "Legacy": { "id": "Legacy", "properties": {}, "type": "object", "description": "A strategy that consolidates activities using the grouping rules from the legacy V1 Activity API. Similar actions occurring within a window of time can be grouped across multiple targets (such as moving a set of files at once) or multiple actors (such as several users editing the same item). Grouping rules for this strategy are specific to each type of action." }, "DriveFolder": { "type": "object", "id": "DriveFolder", "description": "A Drive item which is a folder.", "properties": { "type": { "enumDescriptions": [ "The folder type is unknown.", "The folder is the root of a user's MyDrive.", "The folder is the root of a shared drive.", "The folder is a standard, non-root, folder." ], "description": "The type of Drive folder.", "type": "string", "enum": [ "TYPE_UNSPECIFIED", "MY_DRIVE_ROOT", "SHARED_DRIVE_ROOT", "STANDARD_FOLDER" ] } } }, "SystemEvent": { "properties": { "type": { "type": "string", "enum": [ "TYPE_UNSPECIFIED", "USER_DELETION", "TRASH_AUTO_PURGE" ], "description": "The type of the system event that may triggered activity.", "enumDescriptions": [ "The event type is unspecified.", "The event is a consequence of a user account being deleted.", "The event is due to the system automatically purging trash." ] } }, "id": "SystemEvent", "type": "object", "description": "Event triggered by system operations instead of end users." }, "Rename": { "type": "object", "properties": { "oldTitle": { "type": "string", "description": "The previous title of the drive object." }, "newTitle": { "description": "The new title of the drive object.", "type": "string" } }, "description": "An object was renamed.", "id": "Rename" }, "Suggestion": { "properties": { "subtype": { "type": "string", "enum": [ "SUBTYPE_UNSPECIFIED", "ADDED", "DELETED", "REPLY_ADDED", "REPLY_DELETED", "ACCEPTED", "REJECTED", "ACCEPT_DELETED", "REJECT_DELETED" ], "description": "The sub-type of this event.", "enumDescriptions": [ "Subtype not available.", "A suggestion was added.", "A suggestion was deleted.", "A suggestion reply was added.", "A suggestion reply was deleted.", "A suggestion was accepted.", "A suggestion was rejected.", "An accepted suggestion was deleted.", "A rejected suggestion was deleted." ] } }, "description": "A suggestion.", "type": "object", "id": "Suggestion" }, "Drive": { "description": "Information about a shared drive.", "id": "Drive", "properties": { "title": { "type": "string", "description": "The title of the shared drive." }, "name": { "description": "The resource name of the shared drive. The format is `COLLECTION_ID/DRIVE_ID`. Clients should not assume a specific collection ID for this resource name.", "type": "string" }, "root": { "description": "The root of this shared drive.", "$ref": "DriveItem" } }, "type": "object" }, "Domain": { "id": "Domain", "description": "Information about a domain.", "properties": { "name": { "description": "The name of the domain, e.g. `google.com`.", "type": "string" }, "legacyId": { "description": "An opaque string used to identify this domain.", "type": "string" } }, "type": "object" }, "DriveFile": { "properties": {}, "id": "DriveFile", "description": "A Drive item which is a file.", "type": "object" }, "Anyone": { "id": "Anyone", "description": "Represents any user (including a logged out user).", "type": "object", "properties": {} }, "Restore": { "properties": { "type": { "description": "The type of restore action taken.", "enumDescriptions": [ "The type is not available.", "An object was restored from the trash." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "UNTRASH" ] } }, "id": "Restore", "type": "object", "description": "A deleted object was restored." }, "AppliedLabelChange": { "type": "object", "id": "AppliedLabelChange", "properties": { "changes": { "items": { "$ref": "AppliedLabelChangeDetail" }, "description": "Changes that were made to the Label on the Target.", "type": "array" } }, "description": "Label changes that were made on the Target." }, "Action": { "type": "object", "id": "Action", "description": "Information about the action.", "properties": { "timestamp": { "format": "google-datetime", "description": "The action occurred at this specific time.", "type": "string" }, "target": { "description": "The target this action affects (or empty if affecting all targets). This represents the state of the target immediately after this action occurred.", "$ref": "Target" }, "actor": { "description": "The actor responsible for this action (or empty if all actors are responsible).", "$ref": "Actor" }, "detail": { "description": "The type and detailed information about the action.", "$ref": "ActionDetail" }, "timeRange": { "$ref": "TimeRange", "description": "The action occurred over this time range." } } }, "Post": { "description": "A regular posted comment.", "id": "Post", "properties": { "subtype": { "type": "string", "enum": [ "SUBTYPE_UNSPECIFIED", "ADDED", "DELETED", "REPLY_ADDED", "REPLY_DELETED", "RESOLVED", "REOPENED" ], "description": "The sub-type of this event.", "enumDescriptions": [ "Subtype not available.", "A post was added.", "A post was deleted.", "A reply was added.", "A reply was deleted.", "A posted comment was resolved.", "A posted comment was reopened." ] } }, "type": "object" }, "DriveActivity": { "type": "object", "description": "A single Drive activity comprising one or more Actions by one or more Actors on one or more Targets. Some Action groupings occur spontaneously, such as moving an item into a shared folder triggering a permission change. Other groupings of related Actions, such as multiple Actors editing one item or moving multiple files into a new folder, are controlled by the selection of a ConsolidationStrategy in the QueryDriveActivityRequest.", "id": "DriveActivity", "properties": { "actions": { "items": { "$ref": "Action" }, "description": "Details on all actions in this activity.", "type": "array" }, "timeRange": { "description": "The activity occurred over this time range.", "$ref": "TimeRange" }, "actors": { "type": "array", "items": { "$ref": "Actor" }, "description": "All actor(s) responsible for the activity." }, "primaryActionDetail": { "$ref": "ActionDetail", "description": "Key information about the primary action for this activity. This is either representative, or the most important, of all actions in the activity, according to the ConsolidationStrategy in the request." }, "timestamp": { "description": "The activity occurred at this specific time.", "format": "google-datetime", "type": "string" }, "targets": { "type": "array", "description": "All Google Drive objects this activity is about (e.g. file, folder, drive). This represents the state of the target immediately after the actions occurred.", "items": { "$ref": "Target" } } } }, "NoConsolidation": { "properties": {}, "description": "A strategy that does no consolidation of individual activities.", "type": "object", "id": "NoConsolidation" }, "Permission": { "description": "The permission setting of an object.", "properties": { "anyone": { "description": "If set, this permission applies to anyone, even logged out users.", "$ref": "Anyone" }, "role": { "type": "string", "enum": [ "ROLE_UNSPECIFIED", "OWNER", "ORGANIZER", "FILE_ORGANIZER", "EDITOR", "COMMENTER", "VIEWER", "PUBLISHED_VIEWER" ], "description": "Indicates the [Google Drive permissions role](https://developers.google.com/workspace/drive/web/manage-sharing#roles). The role determines a user's ability to read, write, and comment on items.", "enumDescriptions": [ "The role is not available.", "A role granting full access.", "A role granting the ability to manage people and settings.", "A role granting the ability to contribute and manage content.", "A role granting the ability to contribute content. This role is sometimes also known as \"writer\".", "A role granting the ability to view and comment on content.", "A role granting the ability to view content. This role is sometimes also known as \"reader\".", "A role granting the ability to view content only after it has been published to the web. This role is sometimes also known as \"published reader\". See https://support.google.com/sites/answer/6372880 for more information." ] }, "group": { "description": "The group to whom this permission applies.", "$ref": "Group" }, "domain": { "$ref": "Domain", "description": "The domain to whom this permission applies." }, "allowDiscovery": { "description": "If true, the item can be discovered (e.g. in the user's \"Shared with me\" collection) without needing a link to the item.", "type": "boolean" }, "user": { "description": "The user to whom this permission applies.", "$ref": "User" } }, "id": "Permission", "type": "object" }, "TimeRange": { "description": "Information about time ranges.", "id": "TimeRange", "type": "object", "properties": { "startTime": { "format": "google-datetime", "description": "The start of the time range.", "type": "string" }, "endTime": { "format": "google-datetime", "description": "The end of the time range.", "type": "string" } } }, "Integer": { "type": "object", "properties": { "value": { "description": "Integer value.", "type": "string", "format": "int64" } }, "description": "Wrapper for Integer Field value.", "id": "Integer" }, "Folder": { "type": "object", "deprecated": true, "id": "Folder", "description": "This item is deprecated; please see `DriveFolder` instead.", "properties": { "type": { "enumDescriptions": [ "This item is deprecated; please see `DriveFolder.Type` instead.", "This item is deprecated; please see `DriveFolder.Type` instead.", "This item is deprecated; please see `DriveFolder.Type` instead.", "This item is deprecated; please see `DriveFolder.Type` instead." ], "type": "string", "enum": [ "TYPE_UNSPECIFIED", "MY_DRIVE_ROOT", "TEAM_DRIVE_ROOT", "STANDARD_FOLDER" ], "description": "This field is deprecated; please see `DriveFolder.type` instead." } } }, "DataLeakPreventionChange": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "TYPE_UNSPECIFIED", "FLAGGED", "CLEARED" ], "enumDescriptions": [ "An update to the DLP state that is neither FLAGGED or CLEARED.", "Document has been flagged as containing sensitive content.", "Document is no longer flagged as containing sensitive content." ], "description": "The type of Data Leak Prevention (DLP) change." } }, "description": "A change in the object's data leak prevention status.", "id": "DataLeakPreventionChange" } }, "auth": { "oauth2": { "scopes": { "https://www.googleapis.com/auth/drive.activity": { "description": "View and add to the activity record of files in your Google Drive" }, "https://www.googleapis.com/auth/drive.activity.readonly": { "description": "View the activity record of files in your Google Drive" } } } }, "description": "Provides a historical view of activity in Google Drive.", "rootUrl": "https://driveactivity.googleapis.com/" }