Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / google-api-python-client / c72efbc6b71c963997c5728d471c04ab33d95e4f / . / docs / dyn / cloudidentity_v1beta1.groups.html
blob: cebcf0827824199c3ad92862d9db006321644ca8 [file] [log] [blame]
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]1<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="cloudidentity_v1beta1.html">Cloud Identity API</a> . <a href="cloudidentity_v1beta1.groups.html">groups</a></h1>
76<h2>Instance Methods</h2>
77<p class="toc_element">
78 <code><a href="cloudidentity_v1beta1.groups.memberships.html">memberships()</a></code>
79</p>
80<p class="firstline">Returns the memberships Resource.</p>
81
82<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]83 <code><a href="#create">create(body=None, initialGroupConfig=None, x__xgafv=None)</a></code></p>
84<p class="firstline">Creates a `Group`.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]85<p class="toc_element">
86 <code><a href="#delete">delete(name, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]87<p class="firstline">Deletes a `Group`.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]88<p class="toc_element">
89 <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]90<p class="firstline">Retrieves a `Group`.</p>
91<p class="toc_element">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]92 <code><a href="#list">list(view=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]93<p class="firstline">Lists the `Group`s under a customer or namespace.</p>
94<p class="toc_element">
95 <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
96<p class="firstline">Retrieves the next page of results.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]97<p class="toc_element">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]98 <code><a href="#lookup">lookup(groupKey_namespace=None, groupKey_id=None, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]99<p class="firstline">Looks up the [resource</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]100<p class="toc_element">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]101 <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
102<p class="firstline">Updates a `Group`.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]103<p class="toc_element">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]104 <code><a href="#search">search(query=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)</a></code></p>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]105<p class="firstline">Searches for `Group`s matching a specified query.</p>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]106<p class="toc_element">
107 <code><a href="#search_next">search_next(previous_request, previous_response)</a></code></p>
108<p class="firstline">Retrieves the next page of results.</p>
109<h3>Method Details</h3>
110<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]111 <code class="details" id="create">create(body=None, initialGroupConfig=None, x__xgafv=None)</code>
112 <pre>Creates a `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]113
114Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]115 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]116 The object takes the form of:
117
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]118{ # A group within the Cloud Identity Groups API.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]119 #
120 # A `Group` is a collection of entities, where each entity is either a user,
121 # another group or a service account.
122 &quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]123 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]124 # Must not be longer than 4,096 characters.
125 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
126 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
127 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
128 # the `Group`.
129 #
130 # Shall be of the form `groups/{group_id}`.
131 &quot;groupKey&quot;: { # A unique identifier for an entity in the Cloud Identity Groups API. # Required. Immutable. The `EntityKey` of the `Group`.
132 #
133 # An entity can represent either a group with an optional `namespace` or a user
134 # without a `namespace`. The combination of `id` and `namespace` must be
135 # unique; however, the same `id` can be used with different `namespace`s.
136 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
137 #
138 # For Google-managed entities, the `id` must be the email address of an
139 # existing group or user.
140 #
141 # For external-identity-mapped entities, the `id` must be a string conforming
142 # to the Identity Source&#x27;s requirements.
143 #
144 # Must be unique within a `namespace`.
145 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
146 #
147 # If not specified, the `EntityKey` represents a Google-managed entity such
148 # as a Google user or a Google Group.
149 #
150 # If specified, the `EntityKey` represents an external-identity-mapped group.
151 # The namespace must correspond to an identity source created in Admin
152 # Console and must be in the form of `identitysources/{identity_source_id}.
153 },
154 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was last updated.
155 &quot;additionalGroupKeys&quot;: [ # Additional entity key aliases for a Group.
156 { # A unique identifier for an entity in the Cloud Identity Groups API.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]157 #
158 # An entity can represent either a group with an optional `namespace` or a user
159 # without a `namespace`. The combination of `id` and `namespace` must be
160 # unique; however, the same `id` can be used with different `namespace`s.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]161 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]162 #
163 # For Google-managed entities, the `id` must be the email address of an
164 # existing group or user.
165 #
166 # For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]167 # to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]168 #
169 # Must be unique within a `namespace`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]170 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]171 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]172 # If not specified, the `EntityKey` represents a Google-managed entity such
173 # as a Google user or a Google Group.
174 #
175 # If specified, the `EntityKey` represents an external-identity-mapped group.
176 # The namespace must correspond to an identity source created in Admin
177 # Console and must be in the form of `identitysources/{identity_source_id}.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]178 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]179 ],
180 &quot;parent&quot;: &quot;A String&quot;, # Required. Immutable. The resource name of the entity under which this `Group` resides in the
181 # Cloud Identity resource hierarchy.
182 #
183 # Must be of the form `identitysources/{identity_source_id}` for external-
184 # identity-mapped groups or `customers/{customer_id}` for Google Groups.
185 &quot;labels&quot;: { # Required. The labels that apply to the `Group`.
186 #
187 # Must not contain more than one entry. Must contain the entry
188 # `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27;: &#x27;&#x27;` if the `Group`
189 # is a Google Group or `&#x27;system/groups/external&#x27;: &#x27;&#x27;` if the `Group` is an
190 # external-identity-mapped group.
191 &quot;a_key&quot;: &quot;A String&quot;,
192 },
193}
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]194
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]195 initialGroupConfig: string, Required. The initial configuration option for the `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]196 x__xgafv: string, V1 error format.
197 Allowed values
198 1 - v1 error format
199 2 - v2 error format
200
201Returns:
202 An object of the form:
203
204 { # This resource represents a long-running operation that is the result of a
205 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]206 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
207 # different programming environments, including REST APIs and RPC APIs. It is
208 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
209 # three pieces of data: error code, error message, and error details.
210 #
211 # You can find out more about this error model and how to work with it in the
212 # [API Design Guide](https://cloud.google.com/apis/design/errors).
213 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
214 # user-facing error message should be localized and sent in the
215 # google.rpc.Status.details field, or localized by the client.
216 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
217 # message types for APIs to use.
218 {
219 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
220 },
221 ],
222 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
223 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]224 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
225 # contains progress information and common metadata such as create time.
226 # Some services might not provide such metadata. Any method that returns a
227 # long-running operation should document the metadata type, if any.
228 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
229 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]230 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
231 # originally returns it. If you use the default HTTP mapping, the
232 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]233 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]234 # method returns no data on success, such as `Delete`, the response is
235 # `google.protobuf.Empty`. If the original method is standard
236 # `Get`/`Create`/`Update`, the response should be the resource. For other
237 # methods, the response should have the type `XxxResponse`, where `Xxx`
238 # is the original method name. For example, if the original method name
239 # is `TakeSnapshot()`, the inferred response type is
240 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]241 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]242 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]243 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
244 # If `true`, the operation is completed, and either `error` or `response` is
245 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]246 }</pre>
247</div>
248
249<div class="method">
250 <code class="details" id="delete">delete(name, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]251 <pre>Deletes a `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]252
253Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]254 name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of
255the `Group` to retrieve.
256
257Must be of the form `groups/{group_id}`. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]258 x__xgafv: string, V1 error format.
259 Allowed values
260 1 - v1 error format
261 2 - v2 error format
262
263Returns:
264 An object of the form:
265
266 { # This resource represents a long-running operation that is the result of a
267 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]268 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
269 # different programming environments, including REST APIs and RPC APIs. It is
270 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
271 # three pieces of data: error code, error message, and error details.
272 #
273 # You can find out more about this error model and how to work with it in the
274 # [API Design Guide](https://cloud.google.com/apis/design/errors).
275 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
276 # user-facing error message should be localized and sent in the
277 # google.rpc.Status.details field, or localized by the client.
278 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
279 # message types for APIs to use.
280 {
281 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
282 },
283 ],
284 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
285 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]286 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
287 # contains progress information and common metadata such as create time.
288 # Some services might not provide such metadata. Any method that returns a
289 # long-running operation should document the metadata type, if any.
290 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
291 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]292 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
293 # originally returns it. If you use the default HTTP mapping, the
294 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]295 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]296 # method returns no data on success, such as `Delete`, the response is
297 # `google.protobuf.Empty`. If the original method is standard
298 # `Get`/`Create`/`Update`, the response should be the resource. For other
299 # methods, the response should have the type `XxxResponse`, where `Xxx`
300 # is the original method name. For example, if the original method name
301 # is `TakeSnapshot()`, the inferred response type is
302 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]303 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]304 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]305 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
306 # If `true`, the operation is completed, and either `error` or `response` is
307 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]308 }</pre>
309</div>
310
311<div class="method">
312 <code class="details" id="get">get(name, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]313 <pre>Retrieves a `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]314
315Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]316 name: string, Required. The [resource name](https://cloud.google.com/apis/design/resource_names) of
317the `Group` to retrieve.
318
319Must be of the form `groups/{group_id}`. (required)
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]320 x__xgafv: string, V1 error format.
321 Allowed values
322 1 - v1 error format
323 2 - v2 error format
324
325Returns:
326 An object of the form:
327
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]328 { # A group within the Cloud Identity Groups API.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]329 #
330 # A `Group` is a collection of entities, where each entity is either a user,
331 # another group or a service account.
332 &quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]333 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]334 # Must not be longer than 4,096 characters.
335 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
336 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
337 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
338 # the `Group`.
339 #
340 # Shall be of the form `groups/{group_id}`.
341 &quot;groupKey&quot;: { # A unique identifier for an entity in the Cloud Identity Groups API. # Required. Immutable. The `EntityKey` of the `Group`.
342 #
343 # An entity can represent either a group with an optional `namespace` or a user
344 # without a `namespace`. The combination of `id` and `namespace` must be
345 # unique; however, the same `id` can be used with different `namespace`s.
346 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
347 #
348 # For Google-managed entities, the `id` must be the email address of an
349 # existing group or user.
350 #
351 # For external-identity-mapped entities, the `id` must be a string conforming
352 # to the Identity Source&#x27;s requirements.
353 #
354 # Must be unique within a `namespace`.
355 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
356 #
357 # If not specified, the `EntityKey` represents a Google-managed entity such
358 # as a Google user or a Google Group.
359 #
360 # If specified, the `EntityKey` represents an external-identity-mapped group.
361 # The namespace must correspond to an identity source created in Admin
362 # Console and must be in the form of `identitysources/{identity_source_id}.
363 },
364 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was last updated.
365 &quot;additionalGroupKeys&quot;: [ # Additional entity key aliases for a Group.
366 { # A unique identifier for an entity in the Cloud Identity Groups API.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]367 #
368 # An entity can represent either a group with an optional `namespace` or a user
369 # without a `namespace`. The combination of `id` and `namespace` must be
370 # unique; however, the same `id` can be used with different `namespace`s.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]371 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]372 #
373 # For Google-managed entities, the `id` must be the email address of an
374 # existing group or user.
375 #
376 # For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]377 # to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]378 #
379 # Must be unique within a `namespace`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]380 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]381 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]382 # If not specified, the `EntityKey` represents a Google-managed entity such
383 # as a Google user or a Google Group.
384 #
385 # If specified, the `EntityKey` represents an external-identity-mapped group.
386 # The namespace must correspond to an identity source created in Admin
387 # Console and must be in the form of `identitysources/{identity_source_id}.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]388 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]389 ],
390 &quot;parent&quot;: &quot;A String&quot;, # Required. Immutable. The resource name of the entity under which this `Group` resides in the
391 # Cloud Identity resource hierarchy.
392 #
393 # Must be of the form `identitysources/{identity_source_id}` for external-
394 # identity-mapped groups or `customers/{customer_id}` for Google Groups.
395 &quot;labels&quot;: { # Required. The labels that apply to the `Group`.
396 #
397 # Must not contain more than one entry. Must contain the entry
398 # `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27;: &#x27;&#x27;` if the `Group`
399 # is a Google Group or `&#x27;system/groups/external&#x27;: &#x27;&#x27;` if the `Group` is an
400 # external-identity-mapped group.
401 &quot;a_key&quot;: &quot;A String&quot;,
402 },
403 }</pre>
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]404</div>
405
406<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]407 <code class="details" id="list">list(view=None, pageSize=None, pageToken=None, parent=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]408 <pre>Lists the `Group`s under a customer or namespace.
409
410Args:
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]411 view: string, The level of detail to be returned.
412
413If unspecified, defaults to `View.BASIC`.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]414 pageSize: integer, The maximum number of results to return.
415
416Note that the number of results returned may be less than this value even
417if there are more available results. To fetch all results, clients must
418continue calling this method repeatedly until the response no longer
419contains a `next_page_token`.
420
421If unspecified, defaults to 200 for `View.BASIC` and to 50 for `View.FULL`.
422
423Must not be greater than 1000 for `View.BASIC` or 500 for `View.FULL`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]424 pageToken: string, The `next_page_token` value returned from a previous list request, if any.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]425 parent: string, Required. The parent resource under which to list all `Group`s.
426
427Must be of the form `identitysources/{identity_source_id}` for external-
428identity-mapped groups or `customers/{customer_id}` for Google Groups.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]429 x__xgafv: string, V1 error format.
430 Allowed values
431 1 - v1 error format
432 2 - v2 error format
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]433
434Returns:
435 An object of the form:
436
437 { # The response message for GroupsService.ListGroups.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]438 &quot;nextPageToken&quot;: &quot;A String&quot;, # A continuation token to retrieve the next page of results, or empty if
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]439 # there are no more results available.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]440 &quot;groups&quot;: [ # The `Group`s under the specified `parent`.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]441 { # A group within the Cloud Identity Groups API.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]442 #
443 # A `Group` is a collection of entities, where each entity is either a user,
444 # another group or a service account.
445 &quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]446 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]447 # Must not be longer than 4,096 characters.
448 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
449 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
450 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
451 # the `Group`.
452 #
453 # Shall be of the form `groups/{group_id}`.
454 &quot;groupKey&quot;: { # A unique identifier for an entity in the Cloud Identity Groups API. # Required. Immutable. The `EntityKey` of the `Group`.
455 #
456 # An entity can represent either a group with an optional `namespace` or a user
457 # without a `namespace`. The combination of `id` and `namespace` must be
458 # unique; however, the same `id` can be used with different `namespace`s.
459 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
460 #
461 # For Google-managed entities, the `id` must be the email address of an
462 # existing group or user.
463 #
464 # For external-identity-mapped entities, the `id` must be a string conforming
465 # to the Identity Source&#x27;s requirements.
466 #
467 # Must be unique within a `namespace`.
468 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
469 #
470 # If not specified, the `EntityKey` represents a Google-managed entity such
471 # as a Google user or a Google Group.
472 #
473 # If specified, the `EntityKey` represents an external-identity-mapped group.
474 # The namespace must correspond to an identity source created in Admin
475 # Console and must be in the form of `identitysources/{identity_source_id}.
476 },
477 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was last updated.
478 &quot;additionalGroupKeys&quot;: [ # Additional entity key aliases for a Group.
479 { # A unique identifier for an entity in the Cloud Identity Groups API.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]480 #
481 # An entity can represent either a group with an optional `namespace` or a user
482 # without a `namespace`. The combination of `id` and `namespace` must be
483 # unique; however, the same `id` can be used with different `namespace`s.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]484 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]485 #
486 # For Google-managed entities, the `id` must be the email address of an
487 # existing group or user.
488 #
489 # For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]490 # to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]491 #
492 # Must be unique within a `namespace`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]493 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]494 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]495 # If not specified, the `EntityKey` represents a Google-managed entity such
496 # as a Google user or a Google Group.
497 #
498 # If specified, the `EntityKey` represents an external-identity-mapped group.
499 # The namespace must correspond to an identity source created in Admin
500 # Console and must be in the form of `identitysources/{identity_source_id}.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]501 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]502 ],
503 &quot;parent&quot;: &quot;A String&quot;, # Required. Immutable. The resource name of the entity under which this `Group` resides in the
504 # Cloud Identity resource hierarchy.
505 #
506 # Must be of the form `identitysources/{identity_source_id}` for external-
507 # identity-mapped groups or `customers/{customer_id}` for Google Groups.
508 &quot;labels&quot;: { # Required. The labels that apply to the `Group`.
509 #
510 # Must not contain more than one entry. Must contain the entry
511 # `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27;: &#x27;&#x27;` if the `Group`
512 # is a Google Group or `&#x27;system/groups/external&#x27;: &#x27;&#x27;` if the `Group` is an
513 # external-identity-mapped group.
514 &quot;a_key&quot;: &quot;A String&quot;,
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]515 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]516 },
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]517 ],
518 }</pre>
519</div>
520
521<div class="method">
522 <code class="details" id="list_next">list_next(previous_request, previous_response)</code>
523 <pre>Retrieves the next page of results.
524
525Args:
526 previous_request: The request for the previous page. (required)
527 previous_response: The response from the request for the previous page. (required)
528
529Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]530 A request object that you can call &#x27;execute()&#x27; on to request the next
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]531 page. Returns None if there are no more items in the collection.
532 </pre>
533</div>
534
535<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]536 <code class="details" id="lookup">lookup(groupKey_namespace=None, groupKey_id=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]537 <pre>Looks up the [resource
538name](https://cloud.google.com/apis/design/resource_names) of a `Group` by
539its `EntityKey`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]540
541Args:
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]542 groupKey_namespace: string, The namespace in which the entity exists.
543
544If not specified, the `EntityKey` represents a Google-managed entity such
545as a Google user or a Google Group.
546
547If specified, the `EntityKey` represents an external-identity-mapped group.
548The namespace must correspond to an identity source created in Admin
549Console and must be in the form of `identitysources/{identity_source_id}.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]550 groupKey_id: string, The ID of the entity.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]551
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]552For Google-managed entities, the `id` must be the email address of an
553existing group or user.
554
555For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]556to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]557
558Must be unique within a `namespace`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]559 x__xgafv: string, V1 error format.
560 Allowed values
561 1 - v1 error format
562 2 - v2 error format
563
564Returns:
565 An object of the form:
566
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]567 { # The response message for GroupsService.LookupGroupName.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]568 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]569 # the looked-up `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]570 }</pre>
571</div>
572
573<div class="method">
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]574 <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
575 <pre>Updates a `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]576
577Args:
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]578 name: string, Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
579the `Group`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]580
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]581Shall be of the form `groups/{group_id}`. (required)
582 body: object, The request body.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]583 The object takes the form of:
584
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]585{ # A group within the Cloud Identity Groups API.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]586 #
587 # A `Group` is a collection of entities, where each entity is either a user,
588 # another group or a service account.
589 &quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]590 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]591 # Must not be longer than 4,096 characters.
592 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
593 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
594 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
595 # the `Group`.
596 #
597 # Shall be of the form `groups/{group_id}`.
598 &quot;groupKey&quot;: { # A unique identifier for an entity in the Cloud Identity Groups API. # Required. Immutable. The `EntityKey` of the `Group`.
599 #
600 # An entity can represent either a group with an optional `namespace` or a user
601 # without a `namespace`. The combination of `id` and `namespace` must be
602 # unique; however, the same `id` can be used with different `namespace`s.
603 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
604 #
605 # For Google-managed entities, the `id` must be the email address of an
606 # existing group or user.
607 #
608 # For external-identity-mapped entities, the `id` must be a string conforming
609 # to the Identity Source&#x27;s requirements.
610 #
611 # Must be unique within a `namespace`.
612 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
613 #
614 # If not specified, the `EntityKey` represents a Google-managed entity such
615 # as a Google user or a Google Group.
616 #
617 # If specified, the `EntityKey` represents an external-identity-mapped group.
618 # The namespace must correspond to an identity source created in Admin
619 # Console and must be in the form of `identitysources/{identity_source_id}.
620 },
621 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was last updated.
622 &quot;additionalGroupKeys&quot;: [ # Additional entity key aliases for a Group.
623 { # A unique identifier for an entity in the Cloud Identity Groups API.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]624 #
625 # An entity can represent either a group with an optional `namespace` or a user
626 # without a `namespace`. The combination of `id` and `namespace` must be
627 # unique; however, the same `id` can be used with different `namespace`s.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]628 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]629 #
630 # For Google-managed entities, the `id` must be the email address of an
631 # existing group or user.
632 #
633 # For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]634 # to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]635 #
636 # Must be unique within a `namespace`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]637 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]638 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]639 # If not specified, the `EntityKey` represents a Google-managed entity such
640 # as a Google user or a Google Group.
641 #
642 # If specified, the `EntityKey` represents an external-identity-mapped group.
643 # The namespace must correspond to an identity source created in Admin
644 # Console and must be in the form of `identitysources/{identity_source_id}.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]645 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]646 ],
647 &quot;parent&quot;: &quot;A String&quot;, # Required. Immutable. The resource name of the entity under which this `Group` resides in the
648 # Cloud Identity resource hierarchy.
649 #
650 # Must be of the form `identitysources/{identity_source_id}` for external-
651 # identity-mapped groups or `customers/{customer_id}` for Google Groups.
652 &quot;labels&quot;: { # Required. The labels that apply to the `Group`.
653 #
654 # Must not contain more than one entry. Must contain the entry
655 # `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27;: &#x27;&#x27;` if the `Group`
656 # is a Google Group or `&#x27;system/groups/external&#x27;: &#x27;&#x27;` if the `Group` is an
657 # external-identity-mapped group.
658 &quot;a_key&quot;: &quot;A String&quot;,
659 },
660}
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]661
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]662 updateMask: string, Required. The fully-qualified names of fields to update.
663
664May only contain the following fields: `display_name`, `description`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]665 x__xgafv: string, V1 error format.
666 Allowed values
667 1 - v1 error format
668 2 - v2 error format
669
670Returns:
671 An object of the form:
672
673 { # This resource represents a long-running operation that is the result of a
674 # network API call.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]675 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # The error result of the operation in case of failure or cancellation.
676 # different programming environments, including REST APIs and RPC APIs. It is
677 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
678 # three pieces of data: error code, error message, and error details.
679 #
680 # You can find out more about this error model and how to work with it in the
681 # [API Design Guide](https://cloud.google.com/apis/design/errors).
682 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
683 # user-facing error message should be localized and sent in the
684 # google.rpc.Status.details field, or localized by the client.
685 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
686 # message types for APIs to use.
687 {
688 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
689 },
690 ],
691 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
692 },
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]693 &quot;metadata&quot;: { # Service-specific metadata associated with the operation. It typically
694 # contains progress information and common metadata such as create time.
695 # Some services might not provide such metadata. Any method that returns a
696 # long-running operation should document the metadata type, if any.
697 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
698 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]699 &quot;name&quot;: &quot;A String&quot;, # The server-assigned name, which is only unique within the same service that
700 # originally returns it. If you use the default HTTP mapping, the
701 # `name` should be a resource name ending with `operations/{unique_id}`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]702 &quot;response&quot;: { # The normal response of the operation in case of success. If the original
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]703 # method returns no data on success, such as `Delete`, the response is
704 # `google.protobuf.Empty`. If the original method is standard
705 # `Get`/`Create`/`Update`, the response should be the resource. For other
706 # methods, the response should have the type `XxxResponse`, where `Xxx`
707 # is the original method name. For example, if the original method name
708 # is `TakeSnapshot()`, the inferred response type is
709 # `TakeSnapshotResponse`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]710 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]711 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]712 &quot;done&quot;: True or False, # If the value is `false`, it means the operation is still in progress.
713 # If `true`, the operation is completed, and either `error` or `response` is
714 # available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]715 }</pre>
716</div>
717
718<div class="method">
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]719 <code class="details" id="search">search(query=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)</code>
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]720 <pre>Searches for `Group`s matching a specified query.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]721
722Args:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]723 query: string, Required. The search query.
724
725Must be specified in [Common Expression
726Language](https://opensource.google/projects/cel). May only contain
727equality operators on the parent and inclusion operators on labels (e.g.,
728`parent == &#x27;customers/{customer_id}&#x27; &amp;&amp;
729&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27; in labels`).
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]730 pageSize: integer, The maximum number of results to return.
731
732Note that the number of results returned may be less than this value even
733if there are more available results. To fetch all results, clients must
734continue calling this method repeatedly until the response no longer
735contains a `next_page_token`.
736
737If unspecified, defaults to 200 for `GroupView.BASIC` and to 50 for
738`GroupView.FULL`.
739
740Must not be greater than 1000 for `GroupView.BASIC` or 500 for
741`GroupView.FULL`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]742 pageToken: string, The `next_page_token` value returned from a previous search request, if
743any.
744 view: string, The level of detail to be returned.
745
746If unspecified, defaults to `View.BASIC`.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]747 x__xgafv: string, V1 error format.
748 Allowed values
749 1 - v1 error format
750 2 - v2 error format
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]751
752Returns:
753 An object of the form:
754
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]755 { # The response message for GroupsService.SearchGroups.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]756 &quot;groups&quot;: [ # The `Group`s that match the search query.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]757 { # A group within the Cloud Identity Groups API.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]758 #
759 # A `Group` is a collection of entities, where each entity is either a user,
760 # another group or a service account.
761 &quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]762 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]763 # Must not be longer than 4,096 characters.
764 &quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
765 &quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
766 &quot;name&quot;: &quot;A String&quot;, # Output only. The [resource name](https://cloud.google.com/apis/design/resource_names) of
767 # the `Group`.
768 #
769 # Shall be of the form `groups/{group_id}`.
770 &quot;groupKey&quot;: { # A unique identifier for an entity in the Cloud Identity Groups API. # Required. Immutable. The `EntityKey` of the `Group`.
771 #
772 # An entity can represent either a group with an optional `namespace` or a user
773 # without a `namespace`. The combination of `id` and `namespace` must be
774 # unique; however, the same `id` can be used with different `namespace`s.
775 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
776 #
777 # For Google-managed entities, the `id` must be the email address of an
778 # existing group or user.
779 #
780 # For external-identity-mapped entities, the `id` must be a string conforming
781 # to the Identity Source&#x27;s requirements.
782 #
783 # Must be unique within a `namespace`.
784 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
785 #
786 # If not specified, the `EntityKey` represents a Google-managed entity such
787 # as a Google user or a Google Group.
788 #
789 # If specified, the `EntityKey` represents an external-identity-mapped group.
790 # The namespace must correspond to an identity source created in Admin
791 # Console and must be in the form of `identitysources/{identity_source_id}.
792 },
793 &quot;updateTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was last updated.
794 &quot;additionalGroupKeys&quot;: [ # Additional entity key aliases for a Group.
795 { # A unique identifier for an entity in the Cloud Identity Groups API.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]796 #
797 # An entity can represent either a group with an optional `namespace` or a user
798 # without a `namespace`. The combination of `id` and `namespace` must be
799 # unique; however, the same `id` can be used with different `namespace`s.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]800 &quot;id&quot;: &quot;A String&quot;, # The ID of the entity.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]801 #
802 # For Google-managed entities, the `id` must be the email address of an
803 # existing group or user.
804 #
805 # For external-identity-mapped entities, the `id` must be a string conforming
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]806 # to the Identity Source&#x27;s requirements.
Dan O'Mearadd494642020-05-01 07:42:23 -0700[diff] [blame]807 #
808 # Must be unique within a `namespace`.
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]809 &quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]810 #
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]811 # If not specified, the `EntityKey` represents a Google-managed entity such
812 # as a Google user or a Google Group.
813 #
814 # If specified, the `EntityKey` represents an external-identity-mapped group.
815 # The namespace must correspond to an identity source created in Admin
816 # Console and must be in the form of `identitysources/{identity_source_id}.
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]817 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]818 ],
819 &quot;parent&quot;: &quot;A String&quot;, # Required. Immutable. The resource name of the entity under which this `Group` resides in the
820 # Cloud Identity resource hierarchy.
821 #
822 # Must be of the form `identitysources/{identity_source_id}` for external-
823 # identity-mapped groups or `customers/{customer_id}` for Google Groups.
824 &quot;labels&quot;: { # Required. The labels that apply to the `Group`.
825 #
826 # Must not contain more than one entry. Must contain the entry
827 # `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27;: &#x27;&#x27;` if the `Group`
828 # is a Google Group or `&#x27;system/groups/external&#x27;: &#x27;&#x27;` if the `Group` is an
829 # external-identity-mapped group.
830 &quot;a_key&quot;: &quot;A String&quot;,
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]831 },
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]832 },
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]833 ],
Bu Sun Kim4ed7d3f2020-05-27 12:20:54 -0700[diff] [blame]834 &quot;nextPageToken&quot;: &quot;A String&quot;, # A continuation token to retrieve the next page of results, or empty if
835 # there are no more results available.
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]836 }</pre>
837</div>
838
839<div class="method">
840 <code class="details" id="search_next">search_next(previous_request, previous_response)</code>
841 <pre>Retrieves the next page of results.
842
843Args:
844 previous_request: The request for the previous page. (required)
845 previous_response: The response from the request for the previous page. (required)
846
847Returns:
Bu Sun Kim65020912020-05-20 12:08:20 -0700[diff] [blame]848 A request object that you can call &#x27;execute()&#x27; on to request the next
Bu Sun Kim715bd7f2019-06-14 16:50:42 -0700[diff] [blame]849 page. Returns None if there are no more items in the collection.
850 </pre>
851</div>
852
853</body></html>