| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 1 | <html><body> |
| 2 | <style> |
| 3 | |
| 4 | body, h1, h2, h3, div, span, p, pre, a { |
| 5 | margin: 0; |
| 6 | padding: 0; |
| 7 | border: 0; |
| 8 | font-weight: inherit; |
| 9 | font-style: inherit; |
| 10 | font-size: 100%; |
| 11 | font-family: inherit; |
| 12 | vertical-align: baseline; |
| 13 | } |
| 14 | |
| 15 | body { |
| 16 | font-size: 13px; |
| 17 | padding: 1em; |
| 18 | } |
| 19 | |
| 20 | h1 { |
| 21 | font-size: 26px; |
| 22 | margin-bottom: 1em; |
| 23 | } |
| 24 | |
| 25 | h2 { |
| 26 | font-size: 24px; |
| 27 | margin-bottom: 1em; |
| 28 | } |
| 29 | |
| 30 | h3 { |
| 31 | font-size: 20px; |
| 32 | margin-bottom: 1em; |
| 33 | margin-top: 1em; |
| 34 | } |
| 35 | |
| 36 | pre, code { |
| 37 | line-height: 1.5; |
| 38 | font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace; |
| 39 | } |
| 40 | |
| 41 | pre { |
| 42 | margin-top: 0.5em; |
| 43 | } |
| 44 | |
| 45 | h1, h2, h3, p { |
| 46 | font-family: Arial, sans serif; |
| 47 | } |
| 48 | |
| 49 | h1, h2, h3 { |
| 50 | border-bottom: solid #CCC 1px; |
| 51 | } |
| 52 | |
| 53 | .toc_element { |
| 54 | margin-top: 0.5em; |
| 55 | } |
| 56 | |
| 57 | .firstline { |
| 58 | margin-left: 2 em; |
| 59 | } |
| 60 | |
| 61 | .method { |
| 62 | margin-top: 1em; |
| 63 | border: solid 1px #CCC; |
| 64 | padding: 1em; |
| 65 | background: #EEE; |
| 66 | } |
| 67 | |
| 68 | .details { |
| 69 | font-weight: bold; |
| 70 | font-size: 14px; |
| 71 | } |
| 72 | |
| 73 | </style> |
| 74 | |
| 75 | <h1><a href="vault_v1.html">G Suite Vault API</a> . <a href="vault_v1.matters.html">matters</a> . <a href="vault_v1.matters.holds.html">holds</a></h1> |
| 76 | <h2>Instance Methods</h2> |
| 77 | <p class="toc_element"> |
| 78 | <code><a href="vault_v1.matters.holds.accounts.html">accounts()</a></code> |
| 79 | </p> |
| 80 | <p class="firstline">Returns the accounts Resource.</p> |
| 81 | |
| 82 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 83 | <code><a href="#addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 84 | <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> |
| 85 | <p class="toc_element"> |
| 86 | <code><a href="#close">close()</a></code></p> |
| 87 | <p class="firstline">Close httplib2 connections.</p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 88 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 89 | <code><a href="#create">create(matterId, body=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 90 | <p class="firstline">Creates a hold in the given matter.</p> |
| 91 | <p class="toc_element"> |
| 92 | <code><a href="#delete">delete(matterId, holdId, x__xgafv=None)</a></code></p> |
| 93 | <p class="firstline">Removes a hold by ID. This will release any HeldAccounts on this Hold.</p> |
| 94 | <p class="toc_element"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 95 | <code><a href="#get">get(matterId, holdId, view=None, x__xgafv=None)</a></code></p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 96 | <p class="firstline">Gets a hold by ID.</p> |
| 97 | <p class="toc_element"> |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 98 | <code><a href="#list">list(matterId, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 99 | <p class="firstline">Lists holds within a matter. An empty page token in ListHoldsResponse denotes no more holds to list.</p> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 100 | <p class="toc_element"> |
| 101 | <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p> |
| 102 | <p class="firstline">Retrieves the next page of results.</p> |
| 103 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 104 | <code><a href="#removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 105 | <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> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 106 | <p class="toc_element"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 107 | <code><a href="#update">update(matterId, holdId, body=None, x__xgafv=None)</a></code></p> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 108 | <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> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 109 | <h3>Method Details</h3> |
| 110 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 111 | <code class="details" id="addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 112 | <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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 113 | |
| 114 | Args: |
| 115 | matterId: string, The matter ID. (required) |
| 116 | holdId: string, The hold ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 117 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 118 | The object takes the form of: |
| 119 | |
| 120 | { # Add a list of accounts to a hold. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 121 | "accountIds": [ # Account IDs to identify which accounts to add. Only account_ids or only emails should be specified, but not both. |
| 122 | "A String", |
| 123 | ], |
| 124 | "emails": [ # Emails to identify which accounts to add. Only emails or only account_ids should be specified, but not both. |
| 125 | "A String", |
| 126 | ], |
| 127 | } |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 128 | |
| 129 | x__xgafv: string, V1 error format. |
| 130 | Allowed values |
| 131 | 1 - v1 error format |
| 132 | 2 - v2 error format |
| 133 | |
| 134 | Returns: |
| 135 | An object of the form: |
| 136 | |
| 137 | { # Response for batch create held accounts. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 138 | "responses": [ # The list of responses, in the same order as the batch request. |
| 139 | { # A status detailing the status of each account creation, and the HeldAccount, if successful. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 140 | "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. 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. # If present, this account was successfully created. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 141 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 142 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 143 | "firstName": "A String", # Output only. The first name of the account holder. |
| 144 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 145 | "lastName": "A String", # Output only. The last name of the account holder. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 146 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 147 | "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. |
| 148 | "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| 149 | "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. |
| 150 | { |
| 151 | "a_key": "", # Properties of the object. Contains field @type with type URL. |
| 152 | }, |
| 153 | ], |
| 154 | "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. |
| 155 | }, |
| 156 | }, |
| 157 | ], |
| 158 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 159 | </div> |
| 160 | |
| 161 | <div class="method"> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 162 | <code class="details" id="close">close()</code> |
| 163 | <pre>Close httplib2 connections.</pre> |
| 164 | </div> |
| 165 | |
| 166 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 167 | <code class="details" id="create">create(matterId, body=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 168 | <pre>Creates a hold in the given matter. |
| 169 | |
| 170 | Args: |
| 171 | matterId: string, The matter ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 172 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 173 | The object takes the form of: |
| 174 | |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 175 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 176 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 177 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 178 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 179 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 180 | "firstName": "A String", # Output only. The first name of the account holder. |
| 181 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 182 | "lastName": "A String", # Output only. The last name of the account holder. |
| 183 | }, |
| 184 | ], |
| 185 | "corpus": "A String", # The corpus to be searched. |
| 186 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 187 | "name": "A String", # The name of the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 188 | "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. |
| 189 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 190 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| 191 | }, |
| 192 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 193 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 194 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 195 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| 196 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 197 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 198 | "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. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 199 | "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. |
| 200 | "terms": "A String", # The search terms for the hold. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 201 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 202 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 203 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 204 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 205 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 206 | "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. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 207 | "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. |
| 208 | "terms": "A String", # The search terms for the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 209 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 210 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 211 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 212 | "A String", |
| 213 | ], |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 214 | }, |
| 215 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 216 | "updateTime": "A String", # The last time this hold was modified. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 217 | } |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 218 | |
| 219 | x__xgafv: string, V1 error format. |
| 220 | Allowed values |
| 221 | 1 - v1 error format |
| 222 | 2 - v2 error format |
| 223 | |
| 224 | Returns: |
| 225 | An object of the form: |
| 226 | |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 227 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 228 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 229 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 230 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 231 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 232 | "firstName": "A String", # Output only. The first name of the account holder. |
| 233 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 234 | "lastName": "A String", # Output only. The last name of the account holder. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 235 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 236 | ], |
| 237 | "corpus": "A String", # The corpus to be searched. |
| 238 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 239 | "name": "A String", # The name of the hold. |
| 240 | "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. |
| 241 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 242 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| 243 | }, |
| 244 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| 245 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 246 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 247 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 248 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 249 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| 250 | "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. |
| 251 | "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. |
| 252 | "terms": "A String", # The search terms for the hold. |
| 253 | }, |
| 254 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 255 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| 256 | }, |
| 257 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| 258 | "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. |
| 259 | "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. |
| 260 | "terms": "A String", # The search terms for the hold. |
| 261 | }, |
| 262 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 263 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 264 | "A String", |
| 265 | ], |
| 266 | }, |
| 267 | }, |
| 268 | "updateTime": "A String", # The last time this hold was modified. |
| 269 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 270 | </div> |
| 271 | |
| 272 | <div class="method"> |
| 273 | <code class="details" id="delete">delete(matterId, holdId, x__xgafv=None)</code> |
| 274 | <pre>Removes a hold by ID. This will release any HeldAccounts on this Hold. |
| 275 | |
| 276 | Args: |
| 277 | matterId: string, The matter ID. (required) |
| 278 | holdId: string, The hold ID. (required) |
| 279 | x__xgafv: string, V1 error format. |
| 280 | Allowed values |
| 281 | 1 - v1 error format |
| 282 | 2 - v2 error format |
| 283 | |
| 284 | Returns: |
| 285 | An object of the form: |
| 286 | |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 287 | { # 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 `{}`. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 288 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 289 | </div> |
| 290 | |
| 291 | <div class="method"> |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 292 | <code class="details" id="get">get(matterId, holdId, view=None, x__xgafv=None)</code> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 293 | <pre>Gets a hold by ID. |
| 294 | |
| 295 | Args: |
| 296 | matterId: string, The matter ID. (required) |
| 297 | holdId: string, The hold ID. (required) |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 298 | view: string, Specifies which parts of the Hold to return. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 299 | Allowed values |
| 300 | HOLD_VIEW_UNSPECIFIED - There is no specified view. Defaults to FULL_HOLD. |
| 301 | BASIC_HOLD - Response includes the id, name, update time, corpus, and query. |
| 302 | 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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 303 | x__xgafv: string, V1 error format. |
| 304 | Allowed values |
| 305 | 1 - v1 error format |
| 306 | 2 - v2 error format |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 307 | |
| 308 | Returns: |
| 309 | An object of the form: |
| 310 | |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 311 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 312 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 313 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 314 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 315 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 316 | "firstName": "A String", # Output only. The first name of the account holder. |
| 317 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 318 | "lastName": "A String", # Output only. The last name of the account holder. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 319 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 320 | ], |
| 321 | "corpus": "A String", # The corpus to be searched. |
| 322 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 323 | "name": "A String", # The name of the hold. |
| 324 | "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. |
| 325 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 326 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| 327 | }, |
| 328 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| 329 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 330 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 331 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 332 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 333 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| 334 | "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. |
| 335 | "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. |
| 336 | "terms": "A String", # The search terms for the hold. |
| 337 | }, |
| 338 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 339 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| 340 | }, |
| 341 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| 342 | "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. |
| 343 | "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. |
| 344 | "terms": "A String", # The search terms for the hold. |
| 345 | }, |
| 346 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 347 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 348 | "A String", |
| 349 | ], |
| 350 | }, |
| 351 | }, |
| 352 | "updateTime": "A String", # The last time this hold was modified. |
| 353 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 354 | </div> |
| 355 | |
| 356 | <div class="method"> |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 357 | <code class="details" id="list">list(matterId, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 358 | <pre>Lists holds within a matter. An empty page token in ListHoldsResponse denotes no more holds to list. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 359 | |
| 360 | Args: |
| 361 | matterId: string, The matter ID. (required) |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 362 | 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 363 | pageToken: string, The pagination token as returned in the response. An empty token means start from the beginning. |
| Bu Sun Kim | d059ad8 | 2020-07-22 17:02:09 -0700 | [diff] [blame] | 364 | view: string, Specifies which parts of the Hold to return. |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 365 | Allowed values |
| 366 | HOLD_VIEW_UNSPECIFIED - There is no specified view. Defaults to FULL_HOLD. |
| 367 | BASIC_HOLD - Response includes the id, name, update time, corpus, and query. |
| 368 | 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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 369 | x__xgafv: string, V1 error format. |
| 370 | Allowed values |
| 371 | 1 - v1 error format |
| 372 | 2 - v2 error format |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 373 | |
| 374 | Returns: |
| 375 | An object of the form: |
| 376 | |
| 377 | { # The holds for a matter. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 378 | "holds": [ # The list of holds. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 379 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 380 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 381 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 382 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 383 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 384 | "firstName": "A String", # Output only. The first name of the account holder. |
| 385 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 386 | "lastName": "A String", # Output only. The last name of the account holder. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 387 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 388 | ], |
| 389 | "corpus": "A String", # The corpus to be searched. |
| 390 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 391 | "name": "A String", # The name of the hold. |
| 392 | "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. |
| 393 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 394 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 395 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 396 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| 397 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 398 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 399 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| 400 | }, |
| 401 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| 402 | "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. |
| 403 | "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. |
| 404 | "terms": "A String", # The search terms for the hold. |
| 405 | }, |
| 406 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 407 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| 408 | }, |
| 409 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| 410 | "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. |
| 411 | "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. |
| 412 | "terms": "A String", # The search terms for the hold. |
| 413 | }, |
| 414 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 415 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 416 | "A String", |
| 417 | ], |
| 418 | }, |
| 419 | }, |
| 420 | "updateTime": "A String", # The last time this hold was modified. |
| 421 | }, |
| 422 | ], |
| 423 | "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. |
| 424 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 425 | </div> |
| 426 | |
| 427 | <div class="method"> |
| 428 | <code class="details" id="list_next">list_next(previous_request, previous_response)</code> |
| 429 | <pre>Retrieves the next page of results. |
| 430 | |
| 431 | Args: |
| 432 | previous_request: The request for the previous page. (required) |
| 433 | previous_response: The response from the request for the previous page. (required) |
| 434 | |
| 435 | Returns: |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 436 | A request object that you can call 'execute()' on to request the next |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 437 | page. Returns None if there are no more items in the collection. |
| 438 | </pre> |
| 439 | </div> |
| 440 | |
| 441 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 442 | <code class="details" id="removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 443 | <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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 444 | |
| 445 | Args: |
| 446 | matterId: string, The matter ID. (required) |
| 447 | holdId: string, The hold ID. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 448 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 449 | The object takes the form of: |
| 450 | |
| 451 | { # Remove a list of accounts from a hold. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 452 | "accountIds": [ # Account IDs to identify HeldAccounts to remove. |
| 453 | "A String", |
| 454 | ], |
| 455 | } |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 456 | |
| 457 | x__xgafv: string, V1 error format. |
| 458 | Allowed values |
| 459 | 1 - v1 error format |
| 460 | 2 - v2 error format |
| 461 | |
| 462 | Returns: |
| 463 | An object of the form: |
| 464 | |
| 465 | { # Response for batch delete held accounts. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 466 | "statuses": [ # A list of statuses for deleted accounts. Results have the same order as the request. |
| 467 | { # 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). |
| 468 | "code": 42, # The status code, which should be an enum value of google.rpc.Code. |
| 469 | "details": [ # A list of messages that carry the error details. There is a common set of message types for APIs to use. |
| 470 | { |
| 471 | "a_key": "", # Properties of the object. Contains field @type with type URL. |
| 472 | }, |
| 473 | ], |
| 474 | "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. |
| 475 | }, |
| 476 | ], |
| 477 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 478 | </div> |
| 479 | |
| 480 | <div class="method"> |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 481 | <code class="details" id="update">update(matterId, holdId, body=None, x__xgafv=None)</code> |
| Dmitry Frenkel | 3e17f89 | 2020-10-06 16:46:05 -0700 | [diff] [blame] | 482 | <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. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 483 | |
| 484 | Args: |
| 485 | matterId: string, The matter ID. (required) |
| 486 | holdId: string, The ID of the hold. (required) |
| Dan O'Meara | dd49464 | 2020-05-01 07:42:23 -0700 | [diff] [blame] | 487 | body: object, The request body. |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 488 | The object takes the form of: |
| 489 | |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 490 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 491 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 492 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 493 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 494 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 495 | "firstName": "A String", # Output only. The first name of the account holder. |
| 496 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 497 | "lastName": "A String", # Output only. The last name of the account holder. |
| 498 | }, |
| 499 | ], |
| 500 | "corpus": "A String", # The corpus to be searched. |
| 501 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 502 | "name": "A String", # The name of the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 503 | "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. |
| 504 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 505 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| 506 | }, |
| 507 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 508 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 509 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 510 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| 511 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 512 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 513 | "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. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 514 | "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. |
| 515 | "terms": "A String", # The search terms for the hold. |
| Yoshi Automation Bot | b6971b0 | 2020-11-26 17:16:03 -0800 | [diff] [blame] | 516 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 517 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 518 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| Bu Sun Kim | 6502091 | 2020-05-20 12:08:20 -0700 | [diff] [blame] | 519 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 520 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 521 | "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. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 522 | "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. |
| 523 | "terms": "A String", # The search terms for the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 524 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 525 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 526 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 527 | "A String", |
| 528 | ], |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 529 | }, |
| 530 | }, |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 531 | "updateTime": "A String", # The last time this hold was modified. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 532 | } |
| Bu Sun Kim | 4ed7d3f | 2020-05-27 12:20:54 -0700 | [diff] [blame] | 533 | |
| 534 | x__xgafv: string, V1 error format. |
| 535 | Allowed values |
| 536 | 1 - v1 error format |
| 537 | 2 - v2 error format |
| 538 | |
| 539 | Returns: |
| 540 | An object of the form: |
| 541 | |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 542 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 543 | "accounts": [ # If set, the hold applies to the enumerated accounts and org_unit must be empty. |
| Anthonios Partheniou | 10f4b67 | 2021-04-13 14:47:53 -0400 | [diff] [blame] | 544 | { # 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. 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. |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 545 | "accountId": "A String", # The account's ID as provided by the Admin SDK. |
| 546 | "email": "A String", # The primary email address of the account. If used as an input, this takes precedence over account ID. |
| 547 | "firstName": "A String", # Output only. The first name of the account holder. |
| 548 | "holdTime": "A String", # Output only. When the account was put on hold. |
| 549 | "lastName": "A String", # Output only. The last name of the account holder. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 550 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 551 | ], |
| 552 | "corpus": "A String", # The corpus to be searched. |
| 553 | "holdId": "A String", # The unique immutable ID of the hold. Assigned during creation. |
| 554 | "name": "A String", # The name of the hold. |
| 555 | "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. |
| 556 | "holdTime": "A String", # When the org unit was put on hold. This property is immutable. |
| 557 | "orgUnitId": "A String", # The org unit's immutable ID as provided by the Admin SDK. |
| 558 | }, |
| 559 | "query": { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus type. |
| 560 | "driveQuery": { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive. |
| 561 | "includeSharedDriveFiles": True or False, # If true, include files in shared drives in the hold. |
| 562 | "includeTeamDriveFiles": True or False, # If true, include files in Team Drives in the hold. |
| Yoshi Automation Bot | 0bf565c | 2020-12-09 08:56:03 -0800 | [diff] [blame] | 563 | }, |
| Yoshi Automation Bot | cc94ec8 | 2021-01-15 07:10:04 -0800 | [diff] [blame] | 564 | "groupsQuery": { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups. |
| 565 | "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. |
| 566 | "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. |
| 567 | "terms": "A String", # The search terms for the hold. |
| 568 | }, |
| 569 | "hangoutsChatQuery": { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be Hangouts Chat. |
| 570 | "includeRooms": True or False, # If true, include rooms the user has participated in. |
| 571 | }, |
| 572 | "mailQuery": { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail. |
| 573 | "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. |
| 574 | "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. |
| 575 | "terms": "A String", # The search terms for the hold. |
| 576 | }, |
| 577 | "voiceQuery": { # Query options for Voice holds. # Details pertaining to Voice holds. If set, corpus must be Voice. |
| 578 | "coveredData": [ # Data covered by this rule. Should be non-empty. Order does not matter and duplicates will be ignored. |
| 579 | "A String", |
| 580 | ], |
| 581 | }, |
| 582 | }, |
| 583 | "updateTime": "A String", # The last time this hold was modified. |
| 584 | }</pre> |
| Bu Sun Kim | 715bd7f | 2019-06-14 16:50:42 -0700 | [diff] [blame] | 585 | </div> |
| 586 | |
| 587 | </body></html> |