Close httplib2 connections.
create(matterId, body=None, x__xgafv=None)
Creates a saved query.
delete(matterId, savedQueryId, x__xgafv=None)
Deletes the specified saved query.
get(matterId, savedQueryId, x__xgafv=None)
Retrieves the specified saved query.
list(matterId, pageSize=None, pageToken=None, x__xgafv=None)
Lists the saved queries in a matter.
Retrieves the next page of results.
close()
Close httplib2 connections.
create(matterId, body=None, x__xgafv=None)
Creates a saved query.
Args:
matterId: string, The ID of the matter to create the saved query in. (required)
body: object, The request body.
The object takes the form of:
{ # The definition of a saved query. To work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
"createTime": "A String", # Output only. The server-generated timestamp when the saved query was created.
"displayName": "A String", # The name of the saved query.
"matterId": "A String", # Output only. The matter ID of the matter the saved query is saved in. The server does not use this field during create and always uses matter ID in the URL.
"query": { # The query definition used for search and export. # The search parameters of the saved query.
"accountInfo": { # The accounts to search # Required when **SearchMethod** is **ACCOUNT**.
"emails": [ # A set of accounts to search.
"A String",
],
},
"calendarOptions": { # Additional options for Calendar search # Set Calendar search-specific options.
"locationQuery": [ # Matches only those events whose location contains all of the words in the given set. If the string contains quoted phrases, this method only matches those events whose location contain the exact phrase. Entries in the set are considered in "and". Word splitting example: ["New Zealand"] vs ["New","Zealand"] "New Zealand": matched by both "New and better Zealand": only matched by the later
"A String",
],
"minusWords": [ # Matches only those events that do not contain any of the words in the given set in title, description, location, or attendees. Entries in the set are considered in "or".
"A String",
],
"peopleQuery": [ # Matches only those events whose attendees contain all of the words in the given set. Entries in the set are considered in "and".
"A String",
],
"responseStatuses": [ # Matches only events for which the custodian gave one of these responses. If the set is empty or contains ATTENDEE_RESPONSE_UNSPECIFIED there will be no filtering on responses.
"A String",
],
"versionDate": "A String", # Search the current version of the Calendar event, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"corpus": "A String", # The Google Workspace service to search.
"dataScope": "A String", # The data source to search.
"driveOptions": { # Additional options for Drive search # Set Drive search-specific options.
"clientSideEncryptedOption": "A String", # Set whether the results include only content encrypted with [Google Workspace Client-side encryption](https://support.google.com/a?p=cse_ov) content, only unencrypted content, or both. Defaults to both. Currently supported for Drive.
"includeSharedDrives": True or False, # Set to **true** to include shared drives.
"includeTeamDrives": True or False, # Set to true to include Team Drive.
"versionDate": "A String", # Search the current version of the Drive file, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"endTime": "A String", # The end time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"hangoutsChatInfo": { # The Chat spaces to search # Required when **SearchMethod** is **ROOM**. (read-only)
"roomId": [ # A list of Chat spaces IDs, as provided by the [Chat API](https://developers.google.com/chat). There is a limit of exporting from 500 Chat spaces per request.
"A String",
],
},
"hangoutsChatOptions": { # Additional options for Google Chat search # Set Chat search-specific options. (read-only)
"includeRooms": True or False, # For searches by account or organizational unit, set to **true** to include rooms.
},
"mailOptions": { # Additional options for Gmail search # Set Gmail search-specific options.
"clientSideEncryptedOption": "A String", # Specifies whether the results should include encrypted content, unencrypted content, or both. Defaults to including both.
"excludeDrafts": True or False, # Set to **true** to exclude drafts.
},
"method": "A String", # The entity to search. This field replaces **searchMethod** to support shared drives. When **searchMethod** is **TEAM_DRIVE**, the response of this field is **SHARED_DRIVE**.
"orgUnitInfo": { # The organizational unit to search # Required when **SearchMethod** is **ORG_UNIT**.
"orgUnitId": "A String", # The name of the organizational unit to search, as provided by the [Admin SDK Directory API](https://developers.google.com/admin-sdk/directory/).
},
"searchMethod": "A String", # The search method to use.
"sharedDriveInfo": { # The shared drives to search # Required when **SearchMethod** is **SHARED_DRIVE**.
"sharedDriveIds": [ # A list of shared drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"sitesUrlInfo": { # The published site URLs of new Google Sites to search # Required when **SearchMethod** is **SITES_URL**.
"urls": [ # A list of published site URLs.
"A String",
],
},
"startTime": "A String", # The start time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"teamDriveInfo": { # Team Drives to search # Required when **SearchMethod** is **TEAM_DRIVE**.
"teamDriveIds": [ # List of Team Drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"terms": "A String", # Service-specific [search operators](https://support.google.com/vault/answer/2474474) to filter search results.
"timeZone": "A String", # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles". For a list of time zone names, see [Time Zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For more information about how Vault uses time zones, see [the Vault help center](https://support.google.com/vault/answer/6092995#time).
"voiceOptions": { # Additional options for Voice search # Set Voice search-specific options.
"coveredData": [ # Datatypes to search
"A String",
],
},
},
"savedQueryId": "A String", # A unique identifier for the saved query.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # The definition of a saved query. To work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
"createTime": "A String", # Output only. The server-generated timestamp when the saved query was created.
"displayName": "A String", # The name of the saved query.
"matterId": "A String", # Output only. The matter ID of the matter the saved query is saved in. The server does not use this field during create and always uses matter ID in the URL.
"query": { # The query definition used for search and export. # The search parameters of the saved query.
"accountInfo": { # The accounts to search # Required when **SearchMethod** is **ACCOUNT**.
"emails": [ # A set of accounts to search.
"A String",
],
},
"calendarOptions": { # Additional options for Calendar search # Set Calendar search-specific options.
"locationQuery": [ # Matches only those events whose location contains all of the words in the given set. If the string contains quoted phrases, this method only matches those events whose location contain the exact phrase. Entries in the set are considered in "and". Word splitting example: ["New Zealand"] vs ["New","Zealand"] "New Zealand": matched by both "New and better Zealand": only matched by the later
"A String",
],
"minusWords": [ # Matches only those events that do not contain any of the words in the given set in title, description, location, or attendees. Entries in the set are considered in "or".
"A String",
],
"peopleQuery": [ # Matches only those events whose attendees contain all of the words in the given set. Entries in the set are considered in "and".
"A String",
],
"responseStatuses": [ # Matches only events for which the custodian gave one of these responses. If the set is empty or contains ATTENDEE_RESPONSE_UNSPECIFIED there will be no filtering on responses.
"A String",
],
"versionDate": "A String", # Search the current version of the Calendar event, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"corpus": "A String", # The Google Workspace service to search.
"dataScope": "A String", # The data source to search.
"driveOptions": { # Additional options for Drive search # Set Drive search-specific options.
"clientSideEncryptedOption": "A String", # Set whether the results include only content encrypted with [Google Workspace Client-side encryption](https://support.google.com/a?p=cse_ov) content, only unencrypted content, or both. Defaults to both. Currently supported for Drive.
"includeSharedDrives": True or False, # Set to **true** to include shared drives.
"includeTeamDrives": True or False, # Set to true to include Team Drive.
"versionDate": "A String", # Search the current version of the Drive file, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"endTime": "A String", # The end time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"hangoutsChatInfo": { # The Chat spaces to search # Required when **SearchMethod** is **ROOM**. (read-only)
"roomId": [ # A list of Chat spaces IDs, as provided by the [Chat API](https://developers.google.com/chat). There is a limit of exporting from 500 Chat spaces per request.
"A String",
],
},
"hangoutsChatOptions": { # Additional options for Google Chat search # Set Chat search-specific options. (read-only)
"includeRooms": True or False, # For searches by account or organizational unit, set to **true** to include rooms.
},
"mailOptions": { # Additional options for Gmail search # Set Gmail search-specific options.
"clientSideEncryptedOption": "A String", # Specifies whether the results should include encrypted content, unencrypted content, or both. Defaults to including both.
"excludeDrafts": True or False, # Set to **true** to exclude drafts.
},
"method": "A String", # The entity to search. This field replaces **searchMethod** to support shared drives. When **searchMethod** is **TEAM_DRIVE**, the response of this field is **SHARED_DRIVE**.
"orgUnitInfo": { # The organizational unit to search # Required when **SearchMethod** is **ORG_UNIT**.
"orgUnitId": "A String", # The name of the organizational unit to search, as provided by the [Admin SDK Directory API](https://developers.google.com/admin-sdk/directory/).
},
"searchMethod": "A String", # The search method to use.
"sharedDriveInfo": { # The shared drives to search # Required when **SearchMethod** is **SHARED_DRIVE**.
"sharedDriveIds": [ # A list of shared drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"sitesUrlInfo": { # The published site URLs of new Google Sites to search # Required when **SearchMethod** is **SITES_URL**.
"urls": [ # A list of published site URLs.
"A String",
],
},
"startTime": "A String", # The start time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"teamDriveInfo": { # Team Drives to search # Required when **SearchMethod** is **TEAM_DRIVE**.
"teamDriveIds": [ # List of Team Drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"terms": "A String", # Service-specific [search operators](https://support.google.com/vault/answer/2474474) to filter search results.
"timeZone": "A String", # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles". For a list of time zone names, see [Time Zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For more information about how Vault uses time zones, see [the Vault help center](https://support.google.com/vault/answer/6092995#time).
"voiceOptions": { # Additional options for Voice search # Set Voice search-specific options.
"coveredData": [ # Datatypes to search
"A String",
],
},
},
"savedQueryId": "A String", # A unique identifier for the saved query.
}
delete(matterId, savedQueryId, x__xgafv=None)
Deletes the specified saved query.
Args:
matterId: string, The ID of the matter to delete the saved query from. (required)
savedQueryId: string, ID of the saved query to delete. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
get(matterId, savedQueryId, x__xgafv=None)
Retrieves the specified saved query.
Args:
matterId: string, The ID of the matter to get the saved query from. (required)
savedQueryId: string, ID of the saved query to retrieve. (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # The definition of a saved query. To work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
"createTime": "A String", # Output only. The server-generated timestamp when the saved query was created.
"displayName": "A String", # The name of the saved query.
"matterId": "A String", # Output only. The matter ID of the matter the saved query is saved in. The server does not use this field during create and always uses matter ID in the URL.
"query": { # The query definition used for search and export. # The search parameters of the saved query.
"accountInfo": { # The accounts to search # Required when **SearchMethod** is **ACCOUNT**.
"emails": [ # A set of accounts to search.
"A String",
],
},
"calendarOptions": { # Additional options for Calendar search # Set Calendar search-specific options.
"locationQuery": [ # Matches only those events whose location contains all of the words in the given set. If the string contains quoted phrases, this method only matches those events whose location contain the exact phrase. Entries in the set are considered in "and". Word splitting example: ["New Zealand"] vs ["New","Zealand"] "New Zealand": matched by both "New and better Zealand": only matched by the later
"A String",
],
"minusWords": [ # Matches only those events that do not contain any of the words in the given set in title, description, location, or attendees. Entries in the set are considered in "or".
"A String",
],
"peopleQuery": [ # Matches only those events whose attendees contain all of the words in the given set. Entries in the set are considered in "and".
"A String",
],
"responseStatuses": [ # Matches only events for which the custodian gave one of these responses. If the set is empty or contains ATTENDEE_RESPONSE_UNSPECIFIED there will be no filtering on responses.
"A String",
],
"versionDate": "A String", # Search the current version of the Calendar event, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"corpus": "A String", # The Google Workspace service to search.
"dataScope": "A String", # The data source to search.
"driveOptions": { # Additional options for Drive search # Set Drive search-specific options.
"clientSideEncryptedOption": "A String", # Set whether the results include only content encrypted with [Google Workspace Client-side encryption](https://support.google.com/a?p=cse_ov) content, only unencrypted content, or both. Defaults to both. Currently supported for Drive.
"includeSharedDrives": True or False, # Set to **true** to include shared drives.
"includeTeamDrives": True or False, # Set to true to include Team Drive.
"versionDate": "A String", # Search the current version of the Drive file, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"endTime": "A String", # The end time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"hangoutsChatInfo": { # The Chat spaces to search # Required when **SearchMethod** is **ROOM**. (read-only)
"roomId": [ # A list of Chat spaces IDs, as provided by the [Chat API](https://developers.google.com/chat). There is a limit of exporting from 500 Chat spaces per request.
"A String",
],
},
"hangoutsChatOptions": { # Additional options for Google Chat search # Set Chat search-specific options. (read-only)
"includeRooms": True or False, # For searches by account or organizational unit, set to **true** to include rooms.
},
"mailOptions": { # Additional options for Gmail search # Set Gmail search-specific options.
"clientSideEncryptedOption": "A String", # Specifies whether the results should include encrypted content, unencrypted content, or both. Defaults to including both.
"excludeDrafts": True or False, # Set to **true** to exclude drafts.
},
"method": "A String", # The entity to search. This field replaces **searchMethod** to support shared drives. When **searchMethod** is **TEAM_DRIVE**, the response of this field is **SHARED_DRIVE**.
"orgUnitInfo": { # The organizational unit to search # Required when **SearchMethod** is **ORG_UNIT**.
"orgUnitId": "A String", # The name of the organizational unit to search, as provided by the [Admin SDK Directory API](https://developers.google.com/admin-sdk/directory/).
},
"searchMethod": "A String", # The search method to use.
"sharedDriveInfo": { # The shared drives to search # Required when **SearchMethod** is **SHARED_DRIVE**.
"sharedDriveIds": [ # A list of shared drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"sitesUrlInfo": { # The published site URLs of new Google Sites to search # Required when **SearchMethod** is **SITES_URL**.
"urls": [ # A list of published site URLs.
"A String",
],
},
"startTime": "A String", # The start time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"teamDriveInfo": { # Team Drives to search # Required when **SearchMethod** is **TEAM_DRIVE**.
"teamDriveIds": [ # List of Team Drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"terms": "A String", # Service-specific [search operators](https://support.google.com/vault/answer/2474474) to filter search results.
"timeZone": "A String", # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles". For a list of time zone names, see [Time Zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For more information about how Vault uses time zones, see [the Vault help center](https://support.google.com/vault/answer/6092995#time).
"voiceOptions": { # Additional options for Voice search # Set Voice search-specific options.
"coveredData": [ # Datatypes to search
"A String",
],
},
},
"savedQueryId": "A String", # A unique identifier for the saved query.
}
list(matterId, pageSize=None, pageToken=None, x__xgafv=None)
Lists the saved queries in a matter.
Args:
matterId: string, The ID of the matter to get the saved queries for. (required)
pageSize: integer, The maximum number of saved queries to return.
pageToken: string, The pagination token as returned in the previous response. An empty token means start from the beginning.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Definition of the response for method ListSaveQuery.
"nextPageToken": "A String", # Page token to retrieve the next page of results in the list. If this is empty, then there are no more saved queries to list.
"savedQueries": [ # List of saved queries.
{ # The definition of a saved query. To work with Vault resources, the account must have the [required Vault privileges](https://support.google.com/vault/answer/2799699) and access to the matter. To access a matter, the account must have created the matter, have the matter shared with them, or have the **View All Matters** privilege.
"createTime": "A String", # Output only. The server-generated timestamp when the saved query was created.
"displayName": "A String", # The name of the saved query.
"matterId": "A String", # Output only. The matter ID of the matter the saved query is saved in. The server does not use this field during create and always uses matter ID in the URL.
"query": { # The query definition used for search and export. # The search parameters of the saved query.
"accountInfo": { # The accounts to search # Required when **SearchMethod** is **ACCOUNT**.
"emails": [ # A set of accounts to search.
"A String",
],
},
"calendarOptions": { # Additional options for Calendar search # Set Calendar search-specific options.
"locationQuery": [ # Matches only those events whose location contains all of the words in the given set. If the string contains quoted phrases, this method only matches those events whose location contain the exact phrase. Entries in the set are considered in "and". Word splitting example: ["New Zealand"] vs ["New","Zealand"] "New Zealand": matched by both "New and better Zealand": only matched by the later
"A String",
],
"minusWords": [ # Matches only those events that do not contain any of the words in the given set in title, description, location, or attendees. Entries in the set are considered in "or".
"A String",
],
"peopleQuery": [ # Matches only those events whose attendees contain all of the words in the given set. Entries in the set are considered in "and".
"A String",
],
"responseStatuses": [ # Matches only events for which the custodian gave one of these responses. If the set is empty or contains ATTENDEE_RESPONSE_UNSPECIFIED there will be no filtering on responses.
"A String",
],
"versionDate": "A String", # Search the current version of the Calendar event, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"corpus": "A String", # The Google Workspace service to search.
"dataScope": "A String", # The data source to search.
"driveOptions": { # Additional options for Drive search # Set Drive search-specific options.
"clientSideEncryptedOption": "A String", # Set whether the results include only content encrypted with [Google Workspace Client-side encryption](https://support.google.com/a?p=cse_ov) content, only unencrypted content, or both. Defaults to both. Currently supported for Drive.
"includeSharedDrives": True or False, # Set to **true** to include shared drives.
"includeTeamDrives": True or False, # Set to true to include Team Drive.
"versionDate": "A String", # Search the current version of the Drive file, but export the contents of the last version saved before 12:00 AM UTC on the specified date. Enter the date in UTC.
},
"endTime": "A String", # The end time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"hangoutsChatInfo": { # The Chat spaces to search # Required when **SearchMethod** is **ROOM**. (read-only)
"roomId": [ # A list of Chat spaces IDs, as provided by the [Chat API](https://developers.google.com/chat). There is a limit of exporting from 500 Chat spaces per request.
"A String",
],
},
"hangoutsChatOptions": { # Additional options for Google Chat search # Set Chat search-specific options. (read-only)
"includeRooms": True or False, # For searches by account or organizational unit, set to **true** to include rooms.
},
"mailOptions": { # Additional options for Gmail search # Set Gmail search-specific options.
"clientSideEncryptedOption": "A String", # Specifies whether the results should include encrypted content, unencrypted content, or both. Defaults to including both.
"excludeDrafts": True or False, # Set to **true** to exclude drafts.
},
"method": "A String", # The entity to search. This field replaces **searchMethod** to support shared drives. When **searchMethod** is **TEAM_DRIVE**, the response of this field is **SHARED_DRIVE**.
"orgUnitInfo": { # The organizational unit to search # Required when **SearchMethod** is **ORG_UNIT**.
"orgUnitId": "A String", # The name of the organizational unit to search, as provided by the [Admin SDK Directory API](https://developers.google.com/admin-sdk/directory/).
},
"searchMethod": "A String", # The search method to use.
"sharedDriveInfo": { # The shared drives to search # Required when **SearchMethod** is **SHARED_DRIVE**.
"sharedDriveIds": [ # A list of shared drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"sitesUrlInfo": { # The published site URLs of new Google Sites to search # Required when **SearchMethod** is **SITES_URL**.
"urls": [ # A list of published site URLs.
"A String",
],
},
"startTime": "A String", # The start time for the search query. Specify in GMT. The value is rounded to 12 AM on the specified date.
"teamDriveInfo": { # Team Drives to search # Required when **SearchMethod** is **TEAM_DRIVE**.
"teamDriveIds": [ # List of Team Drive IDs, as provided by the [Drive API](https://developers.google.com/drive).
"A String",
],
},
"terms": "A String", # Service-specific [search operators](https://support.google.com/vault/answer/2474474) to filter search results.
"timeZone": "A String", # The time zone name. It should be an IANA TZ name, such as "America/Los_Angeles". For a list of time zone names, see [Time Zone](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). For more information about how Vault uses time zones, see [the Vault help center](https://support.google.com/vault/answer/6092995#time).
"voiceOptions": { # Additional options for Voice search # Set Voice search-specific options.
"coveredData": [ # Datatypes to search
"A String",
],
},
},
"savedQueryId": "A String", # A unique identifier for the saved query.
},
],
}
list_next()
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.