Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 88714e9

Browse files
committedMar 14, 2023
feat(cloudidentity): update the api
#### cloudidentity:v1 The following keys were added: - schemas.Group.properties.additionalGroupKeys (Total Keys: 3) #### cloudidentity:v1beta1 The following keys were added: - schemas.Group.properties.additionalGroupKeys (Total Keys: 3)
1 parent 0dbb94e commit 88714e9

10 files changed

+124
-48
lines changed
 

‎docs/dyn/cloudidentity_v1.groups.html

+31-1
Original file line numberDiff line numberDiff line change
@@ -130,6 +130,12 @@ <h3>Method Details</h3>
130130
The object takes the form of:
131131

132132
{ # A group within the Cloud Identity Groups API. A `Group` is a collection of entities, where each entity is either a user, another group, or a service account.
133+
&quot;additionalGroupKeys&quot;: [ # Output only. Additional group keys associated with the Group.
134+
{ # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s.
135+
&quot;id&quot;: &quot;A String&quot;, # The ID of the entity. For Google-managed entities, the `id` should be the email address of an existing group or user. For external-identity-mapped entities, the `id` must be a string conforming to the Identity Source&#x27;s requirements. Must be unique within a `namespace`.
136+
&quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists. If not specified, the `EntityKey` represents a Google-managed entity such as a Google user or a Google Group. If specified, the `EntityKey` represents an external-identity-mapped group. The namespace must correspond to an identity source created in Admin Console and must be in the form of `identitysources/{identity_source}`.
137+
},
138+
],
133139
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
134140
&quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`. Must not be longer than 4,096 characters.
135141
&quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
@@ -241,6 +247,12 @@ <h3>Method Details</h3>
241247
An object of the form:
242248

243249
{ # A group within the Cloud Identity Groups API. A `Group` is a collection of entities, where each entity is either a user, another group, or a service account.
250+
&quot;additionalGroupKeys&quot;: [ # Output only. Additional group keys associated with the Group.
251+
{ # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s.
252+
&quot;id&quot;: &quot;A String&quot;, # The ID of the entity. For Google-managed entities, the `id` should be the email address of an existing group or user. For external-identity-mapped entities, the `id` must be a string conforming to the Identity Source&#x27;s requirements. Must be unique within a `namespace`.
253+
&quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists. If not specified, the `EntityKey` represents a Google-managed entity such as a Google user or a Google Group. If specified, the `EntityKey` represents an external-identity-mapped group. The namespace must correspond to an identity source created in Admin Console and must be in the form of `identitysources/{identity_source}`.
254+
},
255+
],
244256
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
245257
&quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`. Must not be longer than 4,096 characters.
246258
&quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
@@ -319,6 +331,12 @@ <h3>Method Details</h3>
319331
{ # Response message for ListGroups operation.
320332
&quot;groups&quot;: [ # Groups returned in response to list request. The results are not sorted.
321333
{ # A group within the Cloud Identity Groups API. A `Group` is a collection of entities, where each entity is either a user, another group, or a service account.
334+
&quot;additionalGroupKeys&quot;: [ # Output only. Additional group keys associated with the Group.
335+
{ # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s.
336+
&quot;id&quot;: &quot;A String&quot;, # The ID of the entity. For Google-managed entities, the `id` should be the email address of an existing group or user. For external-identity-mapped entities, the `id` must be a string conforming to the Identity Source&#x27;s requirements. Must be unique within a `namespace`.
337+
&quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists. If not specified, the `EntityKey` represents a Google-managed entity such as a Google user or a Google Group. If specified, the `EntityKey` represents an external-identity-mapped group. The namespace must correspond to an identity source created in Admin Console and must be in the form of `identitysources/{identity_source}`.
338+
},
339+
],
322340
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
323341
&quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`. Must not be longer than 4,096 characters.
324342
&quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
@@ -394,6 +412,12 @@ <h3>Method Details</h3>
394412
The object takes the form of:
395413

396414
{ # A group within the Cloud Identity Groups API. A `Group` is a collection of entities, where each entity is either a user, another group, or a service account.
415+
&quot;additionalGroupKeys&quot;: [ # Output only. Additional group keys associated with the Group.
416+
{ # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s.
417+
&quot;id&quot;: &quot;A String&quot;, # The ID of the entity. For Google-managed entities, the `id` should be the email address of an existing group or user. For external-identity-mapped entities, the `id` must be a string conforming to the Identity Source&#x27;s requirements. Must be unique within a `namespace`.
418+
&quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists. If not specified, the `EntityKey` represents a Google-managed entity such as a Google user or a Google Group. If specified, the `EntityKey` represents an external-identity-mapped group. The namespace must correspond to an identity source created in Admin Console and must be in the form of `identitysources/{identity_source}`.
419+
},
420+
],
397421
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
398422
&quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`. Must not be longer than 4,096 characters.
399423
&quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.
@@ -458,7 +482,7 @@ <h3>Method Details</h3>
458482
Args:
459483
pageSize: integer, The maximum number of results to return. Note that the number of results returned may be less than this value even if there are more available results. To fetch all results, clients must continue calling this method repeatedly until the response no longer contains a `next_page_token`. If unspecified, defaults to 200 for `GroupView.BASIC` and 50 for `GroupView.FULL`. Must not be greater than 1000 for `GroupView.BASIC` or 500 for `GroupView.FULL`.
460484
pageToken: string, The `next_page_token` value returned from a previous search request, if any.
461-
query: string, Required. The search query. Must be specified in [Common Expression Language](https://opensource.google/projects/cel). May only contain equality operators on the parent and inclusion operators on labels (e.g., `parent == &#x27;customers/{customer_id}&#x27; &amp;&amp; &#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27; in labels`). The `customer_id` must begin with &quot;C&quot; (for example, &#x27;C046psxkn&#x27;). [Find your customer ID.] (https://support.google.com/cloudidentity/answer/10070793)
485+
query: string, Required. The search query. * Must be specified in [Common Expression Language](https://opensource.google/projects/cel). * Must contain equality operators on the parent, e.g. `parent == &#x27;customers/{customer_id}&#x27;`. The `customer_id` must begin with &quot;C&quot; (for example, &#x27;C046psxkn&#x27;). [Find your customer ID.] (https://support.google.com/cloudidentity/answer/10070793) * Can contain optional inclusion operators on `labels` such as `&#x27;cloudidentity.googleapis.com/groups.discussion_forum&#x27; in labels`). * Can contain an optional equality operator on `domain_name`. e.g. `domain_name == &#x27;abc.com&#x27;` * Can contain optional `startsWith/contains/equality` operators on `group_key`, e.g. `group_key.startsWith(&#x27;dev&#x27;)`, `group_key.contains(&#x27;dev&#x27;), group_key == &#x27;dev@abc.com&#x27;` * Can contain optional `startsWith/contains/equality` operators on `display_name`, such as `display_name.startsWith(&#x27;dev&#x27;)` , `display_name.contains(&#x27;dev&#x27;)`, `display_name == &#x27;dev&#x27;`
462486
view: string, The level of detail to be returned. If unspecified, defaults to `View.BASIC`.
463487
Allowed values
464488
VIEW_UNSPECIFIED - Default. Should not be used.
@@ -475,6 +499,12 @@ <h3>Method Details</h3>
475499
{ # The response message for GroupsService.SearchGroups.
476500
&quot;groups&quot;: [ # The `Group` resources that match the search query.
477501
{ # A group within the Cloud Identity Groups API. A `Group` is a collection of entities, where each entity is either a user, another group, or a service account.
502+
&quot;additionalGroupKeys&quot;: [ # Output only. Additional group keys associated with the Group.
503+
{ # A unique identifier for an entity in the Cloud Identity Groups API. An entity can represent either a group with an optional `namespace` or a user without a `namespace`. The combination of `id` and `namespace` must be unique; however, the same `id` can be used with different `namespace`s.
504+
&quot;id&quot;: &quot;A String&quot;, # The ID of the entity. For Google-managed entities, the `id` should be the email address of an existing group or user. For external-identity-mapped entities, the `id` must be a string conforming to the Identity Source&#x27;s requirements. Must be unique within a `namespace`.
505+
&quot;namespace&quot;: &quot;A String&quot;, # The namespace in which the entity exists. If not specified, the `EntityKey` represents a Google-managed entity such as a Google user or a Google Group. If specified, the `EntityKey` represents an external-identity-mapped group. The namespace must correspond to an identity source created in Admin Console and must be in the form of `identitysources/{identity_source}`.
506+
},
507+
],
478508
&quot;createTime&quot;: &quot;A String&quot;, # Output only. The time when the `Group` was created.
479509
&quot;description&quot;: &quot;A String&quot;, # An extended description to help users determine the purpose of a `Group`. Must not be longer than 4,096 characters.
480510
&quot;displayName&quot;: &quot;A String&quot;, # The display name of the `Group`.

‎docs/dyn/cloudidentity_v1.groups.memberships.html

+1-1
Original file line numberDiff line numberDiff line change
@@ -487,7 +487,7 @@ <h3>Method Details</h3>
487487
parent: string, [Resource name](https://cloud.google.com/apis/design/resource_names) of the group to search transitive memberships in. Format: `groups/{group}`, where `group` is always &#x27;-&#x27; as this API will search across all groups for a given member. (required)
488488
pageSize: integer, The default page size is 200 (max 1000).
489489
pageToken: string, The next_page_token value returned from a previous list request, if any.
490-
query: string, Required. A CEL expression that MUST include member specification AND label(s). This is a `required` field. Users can search on label attributes of groups. CONTAINS match (&#x27;in&#x27;) is supported on labels. Identity-mapped groups are uniquely identified by both a `member_key_id` and a `member_key_namespace`, which requires an additional query input: `member_key_namespace`. Example query: `member_key_id == &#x27;member_key_id_value&#x27; &amp;&amp; in labels`
490+
query: string, Required. A CEL expression that MUST include member specification AND label(s). This is a `required` field. Users can search on label attributes of groups. CONTAINS match (&#x27;in&#x27;) is supported on labels. Identity-mapped groups are uniquely identified by both a `member_key_id` and a `member_key_namespace`, which requires an additional query input: `member_key_namespace`. Example query: `member_key_id == &#x27;member_key_id_value&#x27; &amp;&amp; in labels` Query may optionally contain equality operators on the parent of the group restricting the search within a particular customer, e.g. `parent == &#x27;customers/{customer_id}&#x27;`. The `customer_id` must begin with &quot;C&quot; (for example, &#x27;C046psxkn&#x27;). This filtering is only supported for Admins with groups read permissons on the input customer. Example query: `member_key_id == &#x27;member_key_id_value&#x27; &amp;&amp; in labels &amp;&amp; parent == &#x27;customers/C046psxkn&#x27;`
491491
x__xgafv: string, V1 error format.
492492
Allowed values
493493
1 - v1 error format

0 commit comments

Comments
 (0)
Please sign in to comment.