Close httplib2 connections.
query(body=None, x__xgafv=None)
Query past activity in Google Drive.
query_next(previous_request, previous_response)
Retrieves the next page of results.
close()
Close httplib2 connections.
query(body=None, x__xgafv=None)
Query past activity in Google Drive.
Args:
body: object, The request body.
The object takes the form of:
{ # The request message for querying Drive activity.
"ancestorName": "A String", # Return activities for this Drive folder and all children and descendants. The format is `items/ITEM_ID`.
"consolidationStrategy": { # How the individual activities are consolidated. A set of activities may be consolidated into one combined activity if they are related in some way, 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. # Details on how to consolidate related actions that make up the activity. If not set, then related actions are not consolidated.
"legacy": { # A strategy which 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. # The individual activities are consolidated using the legacy strategy.
},
"none": { # A strategy which does no consolidation of individual activities. # The individual activities are not consolidated.
},
},
"filter": "A String", # 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 > 1452409200000 AND time <= 1492812924310` - `time >= "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. Examples: - `detail.action_detail_case: RENAME` - `detail.action_detail_case:(CREATE EDIT)` - `-detail.action_detail_case:MOVE`
"itemName": "A String", # Return activities for this Drive item. The format is `items/ITEM_ID`.
"pageSize": 42, # The miminum number of activities desired in the response; the server will attempt to return at least this quanitity. 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.
"pageToken": "A String", # The token identifying 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 will be returned.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for querying Drive activity.
"activities": [ # List of activity requested.
{ # 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.
"actions": [ # Details on all actions in this activity.
{ # Information about the action.
"actor": { # The actor of a Drive activity. # The actor responsible for this action (or empty if all actors are responsible).
"administrator": { # Empty message representing an administrator. # An administrator.
},
"anonymous": { # Empty message representing an anonymous user or indicating the authenticated user should be anonymized. # An anonymous user.
},
"impersonation": { # Information about an impersonation, where an admin acts on behalf of an end user. Information about the acting admin is not currently available. # An account acting on behalf of another.
"impersonatedUser": { # Information about an end user. # The impersonated user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"system": { # Event triggered by system operations instead of end users. # A non-user actor (i.e. system triggered).
"type": "A String", # The type of the system event that may triggered activity.
},
"user": { # Information about an end user. # An end user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"detail": { # Data describing the type and additional information of an action. # The type and detailed information about the action.
"comment": { # A change about comments on an object. # A change about comments was made.
"assignment": { # A comment with an assignment. # A change on an assignment.
"assignedUser": { # Information about an end user. # The user to whom the comment was assigned.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
"subtype": "A String", # The sub-type of this event.
},
"mentionedUsers": [ # Users who are mentioned in this comment.
{ # Information about an end user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
],
"post": { # A regular posted comment. # A change on a regular posted comment.
"subtype": "A String", # The sub-type of this event.
},
"suggestion": { # A suggestion. # A change on a suggestion.
"subtype": "A String", # The sub-type of this event.
},
},
"create": { # An object was created. # An object was created.
"copy": { # An object was created by copying an existing object. # If present, indicates the object was created by copying an existing Drive object.
"originalObject": { # A lightweight reference to the target of activity. # The original object.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
},
"new": { # An object was created from scratch. # If present, indicates the object was newly created (e.g. as a blank document), not derived from a Drive object or external object.
},
"upload": { # An object was uploaded into Drive. # If present, indicates the object originated externally and was uploaded to Drive.
},
},
"delete": { # An object was deleted. # An object was deleted.
"type": "A String", # The type of delete action taken.
},
"dlpChange": { # A change in the object's data leak prevention status. # A change happened in data leak prevention status.
"type": "A String", # The type of Data Leak Prevention (DLP) change.
},
"edit": { # An empty message indicating an object was edited. # An object was edited.
},
"move": { # An object was moved. # An object was moved.
"addedParents": [ # The added parent object(s).
{ # A lightweight reference to the target of activity.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
],
"removedParents": [ # The removed parent object(s).
{ # A lightweight reference to the target of activity.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
],
},
"permissionChange": { # A change of the permission setting on an item. # The permission on an object was changed.
"addedPermissions": [ # The set of permissions added by this change.
{ # The permission setting of an object.
"allowDiscovery": True or False, # If true, the item can be discovered (e.g. in the user's "Shared with me" collection) without needing a link to the item.
"anyone": { # Represents any user (including a logged out user). # If set, this permission applies to anyone, even logged out users.
},
"domain": { # Information about a domain. # The domain to whom this permission applies.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"group": { # Information about a group. # The group to whom this permission applies.
"email": "A String", # The email address of the group.
"title": "A String", # The title of the group.
},
"role": "A String", # Indicates the [Google Drive permissions role](https://developers.google.com/drive/web/manage-sharing#roles). The role determines a user's ability to read, write, and comment on items.
"user": { # Information about an end user. # The user to whom this permission applies.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
],
"removedPermissions": [ # The set of permissions removed by this change.
{ # The permission setting of an object.
"allowDiscovery": True or False, # If true, the item can be discovered (e.g. in the user's "Shared with me" collection) without needing a link to the item.
"anyone": { # Represents any user (including a logged out user). # If set, this permission applies to anyone, even logged out users.
},
"domain": { # Information about a domain. # The domain to whom this permission applies.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"group": { # Information about a group. # The group to whom this permission applies.
"email": "A String", # The email address of the group.
"title": "A String", # The title of the group.
},
"role": "A String", # Indicates the [Google Drive permissions role](https://developers.google.com/drive/web/manage-sharing#roles). The role determines a user's ability to read, write, and comment on items.
"user": { # Information about an end user. # The user to whom this permission applies.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
],
},
"reference": { # Activity in applications other than Drive. # An object was referenced in an application outside of Drive/Docs.
"type": "A String", # The reference type corresponding to this event.
},
"rename": { # An object was renamed. # An object was renamed.
"newTitle": "A String", # The new title of the drive object.
"oldTitle": "A String", # The previous title of the drive object.
},
"restore": { # A deleted object was restored. # A deleted object was restored.
"type": "A String", # The type of restore action taken.
},
"settingsChange": { # Information about settings changes. # Settings were changed.
"restrictionChanges": [ # The set of changes made to restrictions.
{ # Information about restriction policy changes to a feature.
"feature": "A String", # The feature which had a change in restriction policy.
"newRestriction": "A String", # The restriction in place after the change.
},
],
},
},
"target": { # Information about the target of activity. # The target this action affects (or empty if affecting all targets). This represents the state of the target immediately after this action occurred.
"drive": { # Information about a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"root": { # A Drive item, such as a file or folder. # The root of this shared drive.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"fileComment": { # A comment on a file. # The target is a comment on a Drive file.
"legacyCommentId": "A String", # The comment in the discussion thread. This identifier is an opaque string compatible with the Drive API; see https://developers.google.com/drive/v3/reference/comments/get
"legacyDiscussionId": "A String", # 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/drive/v3/reference/comments/get
"linkToDiscussion": "A String", # The link to the discussion thread containing this comment, for example, `https://docs.google.com/DOCUMENT_ID/edit?disco=THREAD_ID`.
"parent": { # A Drive item, such as a file or folder. # The Drive item containing this comment.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
},
"teamDrive": { # This item is deprecated; please see `Drive` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `Drive.name` instead.
"root": { # A Drive item, such as a file or folder. # This field is deprecated; please see `Drive.root` instead.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"title": "A String", # This field is deprecated; please see `Drive.title` instead.
},
},
"timeRange": { # Information about time ranges. # The action occurred over this time range.
"endTime": "A String", # The end of the time range.
"startTime": "A String", # The start of the time range.
},
"timestamp": "A String", # The action occurred at this specific time.
},
],
"actors": [ # All actor(s) responsible for the activity.
{ # The actor of a Drive activity.
"administrator": { # Empty message representing an administrator. # An administrator.
},
"anonymous": { # Empty message representing an anonymous user or indicating the authenticated user should be anonymized. # An anonymous user.
},
"impersonation": { # Information about an impersonation, where an admin acts on behalf of an end user. Information about the acting admin is not currently available. # An account acting on behalf of another.
"impersonatedUser": { # Information about an end user. # The impersonated user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"system": { # Event triggered by system operations instead of end users. # A non-user actor (i.e. system triggered).
"type": "A String", # The type of the system event that may triggered activity.
},
"user": { # Information about an end user. # An end user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
],
"primaryActionDetail": { # Data describing the type and additional information of an action. # 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.
"comment": { # A change about comments on an object. # A change about comments was made.
"assignment": { # A comment with an assignment. # A change on an assignment.
"assignedUser": { # Information about an end user. # The user to whom the comment was assigned.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
"subtype": "A String", # The sub-type of this event.
},
"mentionedUsers": [ # Users who are mentioned in this comment.
{ # Information about an end user.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
],
"post": { # A regular posted comment. # A change on a regular posted comment.
"subtype": "A String", # The sub-type of this event.
},
"suggestion": { # A suggestion. # A change on a suggestion.
"subtype": "A String", # The sub-type of this event.
},
},
"create": { # An object was created. # An object was created.
"copy": { # An object was created by copying an existing object. # If present, indicates the object was created by copying an existing Drive object.
"originalObject": { # A lightweight reference to the target of activity. # The original object.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
},
"new": { # An object was created from scratch. # If present, indicates the object was newly created (e.g. as a blank document), not derived from a Drive object or external object.
},
"upload": { # An object was uploaded into Drive. # If present, indicates the object originated externally and was uploaded to Drive.
},
},
"delete": { # An object was deleted. # An object was deleted.
"type": "A String", # The type of delete action taken.
},
"dlpChange": { # A change in the object's data leak prevention status. # A change happened in data leak prevention status.
"type": "A String", # The type of Data Leak Prevention (DLP) change.
},
"edit": { # An empty message indicating an object was edited. # An object was edited.
},
"move": { # An object was moved. # An object was moved.
"addedParents": [ # The added parent object(s).
{ # A lightweight reference to the target of activity.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
],
"removedParents": [ # The removed parent object(s).
{ # A lightweight reference to the target of activity.
"drive": { # A lightweight reference to a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A lightweight reference to a Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"title": "A String", # The title of the Drive item.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
},
],
},
"permissionChange": { # A change of the permission setting on an item. # The permission on an object was changed.
"addedPermissions": [ # The set of permissions added by this change.
{ # The permission setting of an object.
"allowDiscovery": True or False, # If true, the item can be discovered (e.g. in the user's "Shared with me" collection) without needing a link to the item.
"anyone": { # Represents any user (including a logged out user). # If set, this permission applies to anyone, even logged out users.
},
"domain": { # Information about a domain. # The domain to whom this permission applies.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"group": { # Information about a group. # The group to whom this permission applies.
"email": "A String", # The email address of the group.
"title": "A String", # The title of the group.
},
"role": "A String", # Indicates the [Google Drive permissions role](https://developers.google.com/drive/web/manage-sharing#roles). The role determines a user's ability to read, write, and comment on items.
"user": { # Information about an end user. # The user to whom this permission applies.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
],
"removedPermissions": [ # The set of permissions removed by this change.
{ # The permission setting of an object.
"allowDiscovery": True or False, # If true, the item can be discovered (e.g. in the user's "Shared with me" collection) without needing a link to the item.
"anyone": { # Represents any user (including a logged out user). # If set, this permission applies to anyone, even logged out users.
},
"domain": { # Information about a domain. # The domain to whom this permission applies.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"group": { # Information about a group. # The group to whom this permission applies.
"email": "A String", # The email address of the group.
"title": "A String", # The title of the group.
},
"role": "A String", # Indicates the [Google Drive permissions role](https://developers.google.com/drive/web/manage-sharing#roles). The role determines a user's ability to read, write, and comment on items.
"user": { # Information about an end user. # The user to whom this permission applies.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
],
},
"reference": { # Activity in applications other than Drive. # An object was referenced in an application outside of Drive/Docs.
"type": "A String", # The reference type corresponding to this event.
},
"rename": { # An object was renamed. # An object was renamed.
"newTitle": "A String", # The new title of the drive object.
"oldTitle": "A String", # The previous title of the drive object.
},
"restore": { # A deleted object was restored. # A deleted object was restored.
"type": "A String", # The type of restore action taken.
},
"settingsChange": { # Information about settings changes. # Settings were changed.
"restrictionChanges": [ # The set of changes made to restrictions.
{ # Information about restriction policy changes to a feature.
"feature": "A String", # The feature which had a change in restriction policy.
"newRestriction": "A String", # The restriction in place after the change.
},
],
},
},
"targets": [ # 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.
{ # Information about the target of activity.
"drive": { # Information about a shared drive. # The target is a shared drive.
"name": "A String", # 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.
"root": { # A Drive item, such as a file or folder. # The root of this shared drive.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"title": "A String", # The title of the shared drive.
},
"driveItem": { # A Drive item, such as a file or folder. # The target is a Drive item.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"fileComment": { # A comment on a file. # The target is a comment on a Drive file.
"legacyCommentId": "A String", # The comment in the discussion thread. This identifier is an opaque string compatible with the Drive API; see https://developers.google.com/drive/v3/reference/comments/get
"legacyDiscussionId": "A String", # 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/drive/v3/reference/comments/get
"linkToDiscussion": "A String", # The link to the discussion thread containing this comment, for example, `https://docs.google.com/DOCUMENT_ID/edit?disco=THREAD_ID`.
"parent": { # A Drive item, such as a file or folder. # The Drive item containing this comment.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
},
"teamDrive": { # This item is deprecated; please see `Drive` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `Drive.name` instead.
"root": { # A Drive item, such as a file or folder. # This field is deprecated; please see `Drive.root` instead.
"driveFile": { # A Drive item which is a file. # The Drive item is a file.
},
"driveFolder": { # A Drive item which is a folder. # The Drive item is a folder. Includes information about the type of folder.
"type": "A String", # The type of Drive folder.
},
"file": { # This item is deprecated; please see `DriveFile` instead. # This field is deprecated; please use the `driveFile` field instead.
},
"folder": { # This item is deprecated; please see `DriveFolder` instead. # This field is deprecated; please use the `driveFolder` field instead.
"type": "A String", # This field is deprecated; please see `DriveFolder.type` instead.
},
"mimeType": "A String", # The MIME type of the Drive item. See https://developers.google.com/drive/v3/web/mime-types.
"name": "A String", # The target Drive item. The format is `items/ITEM_ID`.
"owner": { # Information about the owner of a Drive item. # Information about the owner of this Drive item.
"domain": { # Information about a domain. # The domain of the Drive item owner.
"legacyId": "A String", # An opaque string used to identify this domain.
"name": "A String", # The name of the domain, e.g. `google.com`.
},
"drive": { # A lightweight reference to a shared drive. # The drive that owns the item.
"name": "A String", # 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.
"title": "A String", # The title of the shared drive.
},
"teamDrive": { # This item is deprecated; please see `DriveReference` instead. # This field is deprecated; please use the `drive` field instead.
"name": "A String", # This field is deprecated; please see `DriveReference.name` instead.
"title": "A String", # This field is deprecated; please see `DriveReference.title` instead.
},
"user": { # Information about an end user. # The user that owns the Drive item.
"deletedUser": { # A user whose account has since been deleted. # A user whose account has since been deleted.
},
"knownUser": { # A known user. # A known user.
"isCurrentUser": True or False, # True if this is the user making the request.
"personName": "A String", # 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/.
},
"unknownUser": { # A user about whom nothing is currently known. # A user about whom nothing is currently known.
},
},
},
"title": "A String", # The title of the Drive item.
},
"title": "A String", # This field is deprecated; please see `Drive.title` instead.
},
},
],
"timeRange": { # Information about time ranges. # The activity occurred over this time range.
"endTime": "A String", # The end of the time range.
"startTime": "A String", # The start of the time range.
},
"timestamp": "A String", # The activity occurred at this specific time.
},
],
"nextPageToken": "A String", # Token to retrieve the next page of results, or empty if there are no more results in the list.
}
query_next(previous_request, previous_response)
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.