blob: 27f559f78c37e533358485826a2f1105bd771f68 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -07001<html><body>
2<style>
3
4body, 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
15body {
16 font-size: 13px;
17 padding: 1em;
18}
19
20h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23}
24
25h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28}
29
30h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34}
35
36pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39}
40
41pre {
42 margin-top: 0.5em;
43}
44
45h1, h2, h3, p {
46 font-family: Arial, sans serif;
47}
48
49h1, 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'Mearadd494642020-05-01 07:42:23 -070083 <code><a href="#addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070084<p class="firstline">Adds HeldAccounts to a hold. Returns a list of accounts that have been</p>
85<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -070086 <code><a href="#create">create(matterId, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070087<p class="firstline">Creates a hold in the given matter.</p>
88<p class="toc_element">
89 <code><a href="#delete">delete(matterId, holdId, x__xgafv=None)</a></code></p>
90<p class="firstline">Removes a hold by ID. This will release any HeldAccounts on this Hold.</p>
91<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070092 <code><a href="#get">get(matterId, holdId, view=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070093<p class="firstline">Gets a hold by ID.</p>
94<p class="toc_element">
Bu Sun Kim65020912020-05-20 12:08:20 -070095 <code><a href="#list">list(matterId, pageToken=None, pageSize=None, view=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -070096<p class="firstline">Lists holds within a matter. An empty page token in ListHoldsResponse</p>
97<p class="toc_element">
98 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
99<p class="firstline">Retrieves the next page of results.</p>
100<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700101 <code><a href="#removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700102<p class="firstline">Removes HeldAccounts from a hold. Returns a list of statuses in the same</p>
103<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700104 <code><a href="#update">update(matterId, holdId, body=None, x__xgafv=None)</a></code></p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700105<p class="firstline">Updates the OU and/or query parameters of a hold. You cannot add accounts</p>
106<h3>Method Details</h3>
107<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700108 <code class="details" id="addHeldAccounts">addHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700109 <pre>Adds HeldAccounts to a hold. Returns a list of accounts that have been
110successfully added. Accounts can only be added to an existing account-based
111hold.
112
113Args:
114 matterId: string, The matter ID. (required)
115 holdId: string, The hold ID. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700116 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700117 The object takes the form of:
118
119{ # Add a list of accounts to a hold.
Bu Sun Kim65020912020-05-20 12:08:20 -0700120 &quot;emails&quot;: [ # Emails to identify which accounts to add. Only emails or only account_ids
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700121 # should be specified, but not both.
Bu Sun Kim65020912020-05-20 12:08:20 -0700122 &quot;A String&quot;,
123 ],
124 &quot;accountIds&quot;: [ # Account IDs to identify which accounts to add. Only account_ids or only
125 # emails should be specified, but not both.
126 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700127 ],
128 }
129
130 x__xgafv: string, V1 error format.
131 Allowed values
132 1 - v1 error format
133 2 - v2 error format
134
135Returns:
136 An object of the form:
137
138 { # Response for batch create held accounts.
Bu Sun Kim65020912020-05-20 12:08:20 -0700139 &quot;responses&quot;: [ # The list of responses, in the same order as the batch request.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700140 { # A status detailing the status of each account creation, and the
141 # HeldAccount, if successful.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700142 &quot;account&quot;: { # An account being held in a particular hold. This structure is immutable. # If present, this account was successfully created.
143 # This can be either a single user or a google group, depending on the corpus.
144 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
145 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
146 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
147 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
148 # precedence over account ID.
149 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
150 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
151 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700152 &quot;status&quot;: { # The `Status` type defines a logical error model that is suitable for # This represents the success status. If failed, check message.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700153 # different programming environments, including REST APIs and RPC APIs. It is
Dan O'Mearadd494642020-05-01 07:42:23 -0700154 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
155 # three pieces of data: error code, error message, and error details.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700156 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700157 # You can find out more about this error model and how to work with it in the
158 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700159 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700160 # message types for APIs to use.
161 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700162 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700163 },
164 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700165 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
166 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
167 # user-facing error message should be localized and sent in the
168 # google.rpc.Status.details field, or localized by the client.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700169 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700170 },
171 ],
172 }</pre>
173</div>
174
175<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700176 <code class="details" id="create">create(matterId, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700177 <pre>Creates a hold in the given matter.
178
179Args:
180 matterId: string, The matter ID. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700181 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700182 The object takes the form of:
183
184{ # Represents a hold within Vault. A hold restricts purging of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700185 # artifacts based on the combination of the query and accounts restrictions.
186 # A hold can be configured to either apply to an explicitly configured set
187 # of accounts, or can be applied to all members of an organizational unit.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700188 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
189 # accounts must be empty. This property is mutable. For groups holds,
190 # set the accounts field.
191 # This structure is immutable.
192 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
193 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
194 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700195 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700196 # type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700197 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
198 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
199 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
200 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700201 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700202 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
203 # rounded down to the start of the given date.
Bu Sun Kim65020912020-05-20 12:08:20 -0700204 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
205 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
206 # rounded down to the start of the given date.
Bu Sun Kim65020912020-05-20 12:08:20 -0700207 },
208 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
209 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
210 # rounded down to the start of the given date.
211 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
212 # rounded down to the start of the given date.
213 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
214 },
215 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700216 # Hangouts Chat.
Bu Sun Kim65020912020-05-20 12:08:20 -0700217 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700218 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700219 },
220 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
221 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
222 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
223 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700224 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
225 # empty.
226 { # An account being held in a particular hold. This structure is immutable.
227 # This can be either a single user or a google group, depending on the corpus.
228 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
229 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
230 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
231 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
232 # precedence over account ID.
233 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
234 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
235 },
236 ],
237 }
238
239 x__xgafv: string, V1 error format.
240 Allowed values
241 1 - v1 error format
242 2 - v2 error format
243
244Returns:
245 An object of the form:
246
247 { # Represents a hold within Vault. A hold restricts purging of
248 # artifacts based on the combination of the query and accounts restrictions.
249 # A hold can be configured to either apply to an explicitly configured set
250 # of accounts, or can be applied to all members of an organizational unit.
251 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
252 # accounts must be empty. This property is mutable. For groups holds,
253 # set the accounts field.
254 # This structure is immutable.
255 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
256 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
257 },
258 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
259 # type.
260 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
261 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
262 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
263 },
264 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
265 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
266 # rounded down to the start of the given date.
267 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
268 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
269 # rounded down to the start of the given date.
270 },
271 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
272 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
273 # rounded down to the start of the given date.
274 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
275 # rounded down to the start of the given date.
276 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
277 },
278 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
279 # Hangouts Chat.
280 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
281 },
282 },
283 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
284 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
285 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
286 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
287 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
288 # empty.
289 { # An account being held in a particular hold. This structure is immutable.
290 # This can be either a single user or a google group, depending on the corpus.
291 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
292 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
293 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
294 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
295 # precedence over account ID.
296 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
297 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
298 },
299 ],
300 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700301</div>
302
303<div class="method">
304 <code class="details" id="delete">delete(matterId, holdId, x__xgafv=None)</code>
305 <pre>Removes a hold by ID. This will release any HeldAccounts on this Hold.
306
307Args:
308 matterId: string, The matter ID. (required)
309 holdId: string, The hold ID. (required)
310 x__xgafv: string, V1 error format.
311 Allowed values
312 1 - v1 error format
313 2 - v2 error format
314
315Returns:
316 An object of the form:
317
318 { # A generic empty message that you can re-use to avoid defining duplicated
319 # empty messages in your APIs. A typical example is to use it as the request
320 # or the response type of an API method. For instance:
321 #
322 # service Foo {
323 # rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
324 # }
325 #
326 # The JSON representation for `Empty` is empty JSON object `{}`.
327 }</pre>
328</div>
329
330<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700331 <code class="details" id="get">get(matterId, holdId, view=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700332 <pre>Gets a hold by ID.
333
334Args:
335 matterId: string, The matter ID. (required)
336 holdId: string, The hold ID. (required)
Bu Sun Kim65020912020-05-20 12:08:20 -0700337 view: string, Specifies which parts of the Hold to return.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700338 x__xgafv: string, V1 error format.
339 Allowed values
340 1 - v1 error format
341 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700342
343Returns:
344 An object of the form:
345
346 { # Represents a hold within Vault. A hold restricts purging of
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700347 # artifacts based on the combination of the query and accounts restrictions.
348 # A hold can be configured to either apply to an explicitly configured set
349 # of accounts, or can be applied to all members of an organizational unit.
350 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
351 # accounts must be empty. This property is mutable. For groups holds,
352 # set the accounts field.
353 # This structure is immutable.
354 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
355 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700356 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700357 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
358 # type.
359 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
360 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
361 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
362 },
363 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
364 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
365 # rounded down to the start of the given date.
366 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
367 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
368 # rounded down to the start of the given date.
369 },
370 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
371 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
372 # rounded down to the start of the given date.
373 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
374 # rounded down to the start of the given date.
375 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
376 },
377 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
378 # Hangouts Chat.
379 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
380 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700381 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700382 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
383 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
384 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
385 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
386 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
387 # empty.
388 { # An account being held in a particular hold. This structure is immutable.
389 # This can be either a single user or a google group, depending on the corpus.
390 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
391 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
392 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
393 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
394 # precedence over account ID.
395 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
396 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
397 },
398 ],
399 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700400</div>
401
402<div class="method">
Bu Sun Kim65020912020-05-20 12:08:20 -0700403 <code class="details" id="list">list(matterId, pageToken=None, pageSize=None, view=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700404 <pre>Lists holds within a matter. An empty page token in ListHoldsResponse
405denotes no more holds to list.
406
407Args:
408 matterId: string, The matter ID. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700409 pageToken: string, The pagination token as returned in the response.
410An empty token means start from the beginning.
Bu Sun Kim65020912020-05-20 12:08:20 -0700411 pageSize: integer, The number of holds to return in the response, between 0 and 100 inclusive.
412Leaving this empty, or as 0, is the same as page_size = 100.
413 view: string, Specifies which parts of the Hold to return.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700414 x__xgafv: string, V1 error format.
415 Allowed values
416 1 - v1 error format
417 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700418
419Returns:
420 An object of the form:
421
422 { # The holds for a matter.
Bu Sun Kim65020912020-05-20 12:08:20 -0700423 &quot;nextPageToken&quot;: &quot;A String&quot;, # Page token to retrieve the next page of results in the list.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700424 # If this is empty, then there are no more holds to list.
Bu Sun Kim65020912020-05-20 12:08:20 -0700425 &quot;holds&quot;: [ # The list of holds.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700426 { # Represents a hold within Vault. A hold restricts purging of
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700427 # artifacts based on the combination of the query and accounts restrictions.
428 # A hold can be configured to either apply to an explicitly configured set
429 # of accounts, or can be applied to all members of an organizational unit.
430 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
431 # accounts must be empty. This property is mutable. For groups holds,
432 # set the accounts field.
433 # This structure is immutable.
434 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
435 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700436 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700437 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
438 # type.
439 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
440 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
441 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
442 },
443 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
444 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
445 # rounded down to the start of the given date.
446 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
447 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
448 # rounded down to the start of the given date.
449 },
450 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
451 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
452 # rounded down to the start of the given date.
453 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
454 # rounded down to the start of the given date.
455 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
456 },
457 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
458 # Hangouts Chat.
459 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
460 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700461 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700462 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
463 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
464 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
465 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
466 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
467 # empty.
468 { # An account being held in a particular hold. This structure is immutable.
469 # This can be either a single user or a google group, depending on the corpus.
470 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
471 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
472 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
473 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
474 # precedence over account ID.
475 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
476 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
477 },
478 ],
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700479 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700480 ],
481 }</pre>
482</div>
483
484<div class="method">
485 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
486 <pre>Retrieves the next page of results.
487
488Args:
489 previous_request: The request for the previous page. (required)
490 previous_response: The response from the request for the previous page. (required)
491
492Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700493 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700494 page. Returns None if there are no more items in the collection.
495 </pre>
496</div>
497
498<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700499 <code class="details" id="removeHeldAccounts">removeHeldAccounts(matterId, holdId, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700500 <pre>Removes HeldAccounts from a hold. Returns a list of statuses in the same
501order as the request. If this request leaves the hold with no held
502accounts, the hold will not apply to any accounts.
503
504Args:
505 matterId: string, The matter ID. (required)
506 holdId: string, The hold ID. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700507 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700508 The object takes the form of:
509
510{ # Remove a list of accounts from a hold.
Bu Sun Kim65020912020-05-20 12:08:20 -0700511 &quot;accountIds&quot;: [ # Account IDs to identify HeldAccounts to remove.
512 &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700513 ],
514 }
515
516 x__xgafv: string, V1 error format.
517 Allowed values
518 1 - v1 error format
519 2 - v2 error format
520
521Returns:
522 An object of the form:
523
524 { # Response for batch delete held accounts.
Bu Sun Kim65020912020-05-20 12:08:20 -0700525 &quot;statuses&quot;: [ # A list of statuses for deleted accounts. Results have the
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700526 # same order as the request.
527 { # The `Status` type defines a logical error model that is suitable for
528 # different programming environments, including REST APIs and RPC APIs. It is
Dan O'Mearadd494642020-05-01 07:42:23 -0700529 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
530 # three pieces of data: error code, error message, and error details.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700531 #
Dan O'Mearadd494642020-05-01 07:42:23 -0700532 # You can find out more about this error model and how to work with it in the
533 # [API Design Guide](https://cloud.google.com/apis/design/errors).
Bu Sun Kim65020912020-05-20 12:08:20 -0700534 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700535 # message types for APIs to use.
536 {
Bu Sun Kim65020912020-05-20 12:08:20 -0700537 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700538 },
539 ],
Bu Sun Kim65020912020-05-20 12:08:20 -0700540 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
541 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
542 # user-facing error message should be localized and sent in the
543 # google.rpc.Status.details field, or localized by the client.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700544 },
545 ],
546 }</pre>
547</div>
548
549<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700550 <code class="details" id="update">update(matterId, holdId, body=None, x__xgafv=None)</code>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700551 <pre>Updates the OU and/or query parameters of a hold. You cannot add accounts
552to a hold that covers an OU, nor can you add OUs to a hold that covers
553individual accounts. Accounts listed in the hold will be ignored.
554
555Args:
556 matterId: string, The matter ID. (required)
557 holdId: string, The ID of the hold. (required)
Dan O'Mearadd494642020-05-01 07:42:23 -0700558 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700559 The object takes the form of:
560
561{ # Represents a hold within Vault. A hold restricts purging of
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700562 # artifacts based on the combination of the query and accounts restrictions.
563 # A hold can be configured to either apply to an explicitly configured set
564 # of accounts, or can be applied to all members of an organizational unit.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700565 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
566 # accounts must be empty. This property is mutable. For groups holds,
567 # set the accounts field.
568 # This structure is immutable.
569 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
570 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
571 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700572 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700573 # type.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700574 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
575 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
576 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
577 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700578 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700579 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
580 # rounded down to the start of the given date.
Bu Sun Kim65020912020-05-20 12:08:20 -0700581 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
582 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
583 # rounded down to the start of the given date.
Bu Sun Kim65020912020-05-20 12:08:20 -0700584 },
585 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
586 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
587 # rounded down to the start of the given date.
588 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
589 # rounded down to the start of the given date.
590 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
591 },
592 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700593 # Hangouts Chat.
Bu Sun Kim65020912020-05-20 12:08:20 -0700594 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700595 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700596 },
597 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
598 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
599 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
600 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700601 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
602 # empty.
603 { # An account being held in a particular hold. This structure is immutable.
604 # This can be either a single user or a google group, depending on the corpus.
605 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
606 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
607 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
608 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
609 # precedence over account ID.
610 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
611 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
612 },
613 ],
614 }
615
616 x__xgafv: string, V1 error format.
617 Allowed values
618 1 - v1 error format
619 2 - v2 error format
620
621Returns:
622 An object of the form:
623
624 { # Represents a hold within Vault. A hold restricts purging of
625 # artifacts based on the combination of the query and accounts restrictions.
626 # A hold can be configured to either apply to an explicitly configured set
627 # of accounts, or can be applied to all members of an organizational unit.
628 &quot;orgUnit&quot;: { # A organizational unit being held in a particular hold. # If set, the hold applies to all members of the organizational unit and
629 # accounts must be empty. This property is mutable. For groups holds,
630 # set the accounts field.
631 # This structure is immutable.
632 &quot;orgUnitId&quot;: &quot;A String&quot;, # The org unit&#x27;s immutable ID as provided by the Admin SDK.
633 &quot;holdTime&quot;: &quot;A String&quot;, # When the org unit was put on hold. This property is immutable.
634 },
635 &quot;query&quot;: { # Corpus specific queries. # The corpus-specific query. If set, the corpusQuery must match corpus
636 # type.
637 &quot;driveQuery&quot;: { # Query options for Drive holds. # Details pertaining to Drive holds. If set, corpus must be Drive.
638 &quot;includeTeamDriveFiles&quot;: True or False, # If true, include files in Team Drives in the hold.
639 &quot;includeSharedDriveFiles&quot;: True or False, # If true, include files in shared drives in the hold.
640 },
641 &quot;mailQuery&quot;: { # Query options for mail holds. # Details pertaining to mail holds. If set, corpus must be mail.
642 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
643 # rounded down to the start of the given date.
644 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
645 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
646 # rounded down to the start of the given date.
647 },
648 &quot;groupsQuery&quot;: { # Query options for group holds. # Details pertaining to Groups holds. If set, corpus must be Groups.
649 &quot;endTime&quot;: &quot;A String&quot;, # The end time range for the search query. These timestamps are in GMT and
650 # rounded down to the start of the given date.
651 &quot;startTime&quot;: &quot;A String&quot;, # The start time range for the search query. These timestamps are in GMT and
652 # rounded down to the start of the given date.
653 &quot;terms&quot;: &quot;A String&quot;, # The search terms for the hold.
654 },
655 &quot;hangoutsChatQuery&quot;: { # Query options for hangouts chat holds. # Details pertaining to Hangouts Chat holds. If set, corpus must be
656 # Hangouts Chat.
657 &quot;includeRooms&quot;: True or False, # If true, include rooms the user has participated in.
658 },
659 },
660 &quot;corpus&quot;: &quot;A String&quot;, # The corpus to be searched.
661 &quot;updateTime&quot;: &quot;A String&quot;, # The last time this hold was modified.
662 &quot;holdId&quot;: &quot;A String&quot;, # The unique immutable ID of the hold. Assigned during creation.
663 &quot;name&quot;: &quot;A String&quot;, # The name of the hold.
664 &quot;accounts&quot;: [ # If set, the hold applies to the enumerated accounts and org_unit must be
665 # empty.
666 { # An account being held in a particular hold. This structure is immutable.
667 # This can be either a single user or a google group, depending on the corpus.
668 &quot;firstName&quot;: &quot;A String&quot;, # Output only. The first name of the account holder.
669 &quot;holdTime&quot;: &quot;A String&quot;, # Output only. When the account was put on hold.
670 &quot;lastName&quot;: &quot;A String&quot;, # Output only. The last name of the account holder.
671 &quot;email&quot;: &quot;A String&quot;, # The primary email address of the account. If used as an input, this takes
672 # precedence over account ID.
673 &quot;accountId&quot;: &quot;A String&quot;, # The account&#x27;s ID as provided by the
674 # &lt;a href=&quot;https://developers.google.com/admin-sdk/&quot;&gt;Admin SDK&lt;/a&gt;.
675 },
676 ],
677 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700678</div>
679
680</body></html>