docs: update generated docs (#1053)
Updates for both discovery docs and epydoc API Documentation
Fixes: #1049
diff --git a/docs/dyn/vault_v1.matters.holds.html b/docs/dyn/vault_v1.matters.holds.html
index dc2d04c..6363c19 100644
--- a/docs/dyn/vault_v1.matters.holds.html
+++ b/docs/dyn/vault_v1.matters.holds.html
@@ -81,7 +81,10 @@
<p class="toc_element">
<code><a href="#addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Adds HeldAccounts to a hold. Returns a list of accounts that have been</p>
+<p class="firstline">Adds HeldAccounts to a hold. Returns a list of accounts that have been successfully added. Accounts can only be added to an existing account-based hold.</p>
+<p class="toc_element">
+ <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#create">create(matterId, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Creates a hold in the given matter.</p>
@@ -92,23 +95,21 @@
<code><a href="#get">get(matterId, holdId, view=None, x__xgafv=None)</a></code></p>
<p class="firstline">Gets a hold by ID.</p>
<p class="toc_element">
- <code><a href="#list">list(matterId, view=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Lists holds within a matter. An empty page token in ListHoldsResponse</p>
+ <code><a href="#list">list(matterId, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p>
+<p class="firstline">Lists holds within a matter. An empty page token in ListHoldsResponse denotes no more holds to list.</p>
<p class="toc_element">
<code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
<p class="firstline">Retrieves the next page of results.</p>
<p class="toc_element">
<code><a href="#removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Removes HeldAccounts from a hold. Returns a list of statuses in the same</p>
+<p class="firstline">Removes HeldAccounts from a hold. Returns a list of statuses in the same order as the request. If this request leaves the hold with no held accounts, the hold will not apply to any accounts.</p>
<p class="toc_element">
<code><a href="#update">update(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the OU and/or query parameters of a hold. You cannot add accounts</p>
+<p class="firstline">Updates the OU and/or query parameters of a hold. You cannot add accounts to a hold that covers an OU, nor can you add OUs to a hold that covers individual accounts. Accounts listed in the hold will be ignored.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code>
- <pre>Adds HeldAccounts to a hold. Returns a list of accounts that have been
-successfully added. Accounts can only be added to an existing account-based
-hold.
+ <pre>Adds HeldAccounts to a hold. Returns a list of accounts that have been successfully added. Accounts can only be added to an existing account-based hold.
Args:
matterId: string, The matter ID. (required)
@@ -117,12 +118,10 @@
The object takes the form of:
{ # Add a list of accounts to a hold.
- "emails": [ # Emails to identify which accounts to add. Only emails or only account_ids
- # should be specified, but not both.
+ "accountIds": [ # Account IDs to identify which accounts to add. Only account_ids or only emails should be specified, but not both.
"A String",
],
- "accountIds": [ # Account IDs to identify which accounts to add. Only account_ids or only
- # emails should be specified, but not both.
+ "emails": [ # Emails to identify which accounts to add. Only emails or only account_ids should be specified, but not both.
"A String",
],
}
@@ -137,35 +136,22 @@
{ # Response for batch create held accounts.
"responses": [ # The list of responses, in the same order as the batch request.
- { # A status detailing the status of each account creation, and the
- # HeldAccount, if successful.
- "status": { # The `Status` type defines a logical error model that is suitable for # This represents the success status. If failed, check message.
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ { # A status detailing the status of each account creation, and the HeldAccount, if successful.
+ "status": { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors). # This represents the success status. If failed, check message.
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
- "account": { # An account being held in a particular hold. This structure is immutable. # If present, this account was successfully created.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
+ "account": { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus. # If present, this account was successfully created.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
"lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
"holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
},
},
],
@@ -173,6 +159,11 @@
</div>
<div class="method">
+ <code class="details" id="close">close()</code>
+ <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
<code class="details" id="create">create(matterId, body=None, x__xgafv=None)</code>
<pre>Creates a hold in the given matter.
@@ -181,60 +172,44 @@
body: object, The request body.
The object takes the form of:
-{ # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+{ # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
- }
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
+ },
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -244,60 +219,44 @@
Returns:
An object of the form:
- { # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ { # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
- }</pre>
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
+ },
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+ }</pre>
</div>
<div class="method">
@@ -315,15 +274,7 @@
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);
- # }
- #
- # The JSON representation for `Empty` is empty JSON object `{}`.
+ { # 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); } The JSON representation for `Empty` is empty JSON object `{}`.
}</pre>
</div>
@@ -335,6 +286,10 @@
matterId: string, The matter ID. (required)
holdId: string, The hold ID. (required)
view: string, Specifies which parts of the Hold to return.
+ Allowed values
+ HOLD_VIEW_UNSPECIFIED - There is no specified view. Defaults to FULL_HOLD.
+ BASIC_HOLD - Response includes the id, name, update time, corpus, and query.
+ FULL_HOLD - Full representation of a Hold. Response includes all fields of 'BASIC' and the entities the Hold applies to, such as accounts, or OU.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -343,74 +298,59 @@
Returns:
An object of the form:
- { # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ { # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
- }</pre>
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
+ },
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+ }</pre>
</div>
<div class="method">
- <code class="details" id="list">list(matterId, view=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
- <pre>Lists holds within a matter. An empty page token in ListHoldsResponse
-denotes no more holds to list.
+ <code class="details" id="list">list(matterId, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code>
+ <pre>Lists holds within a matter. An empty page token in ListHoldsResponse denotes no more holds to list.
Args:
matterId: string, The matter ID. (required)
+ pageSize: integer, The number of holds to return in the response, between 0 and 100 inclusive. Leaving this empty, or as 0, is the same as page_size = 100.
+ pageToken: string, The pagination token as returned in the response. An empty token means start from the beginning.
view: string, Specifies which parts of the Hold to return.
- pageSize: integer, The number of holds to return in the response, between 0 and 100 inclusive.
-Leaving this empty, or as 0, is the same as page_size = 100.
- pageToken: string, The pagination token as returned in the response.
-An empty token means start from the beginning.
+ Allowed values
+ HOLD_VIEW_UNSPECIFIED - There is no specified view. Defaults to FULL_HOLD.
+ BASIC_HOLD - Response includes the id, name, update time, corpus, and query.
+ FULL_HOLD - Full representation of a Hold. Response includes all fields of 'BASIC' and the entities the Hold applies to, such as accounts, or OU.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
@@ -420,63 +360,46 @@
An object of the form:
{ # The holds for a matter.
- "nextPageToken": "A String", # Page token to retrieve the next page of results in the list.
- # If this is empty, then there are no more holds to list.
+ "nextPageToken": "A String", # Page token to retrieve the next page of results in the list. If this is empty, then there are no more holds to list.
"holds": [ # The list of holds.
- { # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ { # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
},
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+ },
],
}</pre>
</div>
@@ -497,9 +420,7 @@
<div class="method">
<code class="details" id="removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code>
- <pre>Removes HeldAccounts from a hold. Returns a list of statuses in the same
-order as the request. If this request leaves the hold with no held
-accounts, the hold will not apply to any accounts.
+ <pre>Removes HeldAccounts from a hold. Returns a list of statuses in the same order as the request. If this request leaves the hold with no held accounts, the hold will not apply to any accounts.
Args:
matterId: string, The matter ID. (required)
@@ -522,25 +443,15 @@
An object of the form:
{ # Response for batch delete held accounts.
- "statuses": [ # A list of statuses for deleted accounts. Results have the
- # same order as the request.
- { # The `Status` type defines a logical error model that is suitable for
- # different programming environments, including REST APIs and RPC APIs. It is
- # used by [gRPC](https://github.com/grpc). Each `Status` message contains
- # three pieces of data: error code, error message, and error details.
- #
- # You can find out more about this error model and how to work with it in the
- # [API Design Guide](https://cloud.google.com/apis/design/errors).
- "code": 42, # The status code, which should be an enum value of google.rpc.Code.
- "details": [ # A list of messages that carry the error details. There is a common set of
- # message types for APIs to use.
+ "statuses": [ # A list of statuses for deleted accounts. Results have the same order as the request.
+ { # The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).
+ "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use.
{
"a_key": "", # Properties of the object. Contains field @type with type URL.
},
],
- "message": "A String", # A developer-facing error message, which should be in English. Any
- # user-facing error message should be localized and sent in the
- # google.rpc.Status.details field, or localized by the client.
+ "code": 42, # The status code, which should be an enum value of google.rpc.Code.
+ "message": "A String", # A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
},
],
}</pre>
@@ -548,9 +459,7 @@
<div class="method">
<code class="details" id="update">update(matterId, holdId, body=None, x__xgafv=None)</code>
- <pre>Updates the OU and/or query parameters of a hold. You cannot add accounts
-to a hold that covers an OU, nor can you add OUs to a hold that covers
-individual accounts. Accounts listed in the hold will be ignored.
+ <pre>Updates the OU and/or query parameters of a hold. You cannot add accounts to a hold that covers an OU, nor can you add OUs to a hold that covers individual accounts. Accounts listed in the hold will be ignored.
Args:
matterId: string, The matter ID. (required)
@@ -558,60 +467,44 @@
body: object, The request body.
The object takes the form of:
-{ # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+{ # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
- }
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
+ },
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+}
x__xgafv: string, V1 error format.
Allowed values
@@ -621,60 +514,44 @@
Returns:
An object of the form:
- { # Represents a hold within Vault. A hold restricts purging of
- # artifacts based on the combination of the query and accounts restrictions.
- # A hold can be configured to either apply to an explicitly configured set
- # of accounts, or can be applied to all members of an organizational unit.
- "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
- "orgUnit": { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
- # accounts must be empty. This property is mutable. For groups holds,
- # set the accounts field.
- # This structure is immutable.
- "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
- "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ { # Represents a hold within Vault. A hold restricts purging of artifacts based on the combination of the query and accounts restrictions. A hold can be configured to either apply to an explicitly configured set of accounts, or can be applied to all members of an organizational unit.
+ "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type.
+ "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
+ "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
+ "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
},
- "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be
- # empty.
- { # An account being held in a particular hold. This structure is immutable.
- # This can be either a single user or a google group, depending on the corpus.
- "firstName": "A String", # Output only. The first name of the account holder.
- "lastName": "A String", # Output only. The last name of the account holder.
- "accountId": "A String", # The account's ID as provided by the
- # <a href="https://developers.google.com/admin-sdk/">Admin SDK</a>.
- "email": "A String", # The primary email address of the account. If used as an input, this takes
- # precedence over account ID.
- "holdTime": "A String", # Output only. When the account was put on hold.
- },
- ],
- "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
- # type.
- "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
- "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and
- # rounded down to the start of the given date.
- "terms": "A String", # The search terms for the hold.
- },
- "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
- "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold.
- "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold.
- },
- "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
- # Hangouts Chat.
- "includeRooms": True or False, # If true, include rooms the user has participated in.
- },
+ "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
},
- "name": "A String", # The name of the hold.
- "corpus": "A String", # The corpus to be searched.
- "updateTime": "A String", # The last time this hold was modified.
- }</pre>
+ "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
+ "endTime": "A String", # The end time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ "terms": "A String", # The search terms for the hold.
+ "startTime": "A String", # The start time range for the search query. These timestamps are in GMT and rounded down to the start of the given date.
+ },
+ "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat.
+ "includeRooms": True or False, # If true, include rooms the user has participated in.
+ },
+ },
+ "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty.
+ { # An account being held in a particular hold. This structure is immutable. This can be either a single user or a google group, depending on the corpus.
+ "accountId": "A String", # The account's ID as provided by the Admin SDK.
+ "lastName": "A String", # Output only. The last name of the account holder.
+ "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID.
+ "holdTime": "A String", # Output only. When the account was put on hold.
+ "firstName": "A String", # Output only. The first name of the account holder.
+ },
+ ],
+ "updateTime": "A String", # The last time this hold was modified.
+ "orgUnit": { # A organizational unit being held in a particular hold. This structure is immutable. # If set, the hold applies to all members of the organizational unit and accounts must be empty. This property is mutable. For groups holds, set the accounts field.
+ "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK.
+ "holdTime": "A String", # When the org unit was put on hold. This property is immutable.
+ },
+ "corpus": "A String", # The corpus to be searched.
+ "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation.
+ "name": "A String", # The name of the hold.
+ }</pre>
</div>
</body></html>
\ No newline at end of file