Skip to main content

groups

Overview

Namegroups
TypeResource
Idgoogle.cloudidentity.groups

Fields

NameDatatypeDescription
namestringOutput only. The resource name of the Group. Shall be of the form groups/{group}.
descriptionstringAn extended description to help users determine the purpose of a Group. Must not be longer than 4,096 characters.
createTimestringOutput only. The time when the Group was created.
groupKeyobjectA 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 namespaces.
parentstringRequired. Immutable. The resource name of the entity under which this Group resides in the Cloud Identity resource hierarchy. Must be of the form identitysources/{identity_source} for external identity-mapped groups or customers/{customer_id} for Google Groups. The customer_id must begin with "C" (for example, 'C046psxkn'). [Find your customer ID.] (https://support.google.com/cloudidentity/answer/10070793)
displayNamestringThe display name of the Group.
dynamicGroupMetadataobjectDynamic group metadata like queries and status.
updateTimestringOutput only. The time when the Group was last updated.
additionalGroupKeysarrayOutput only. Additional group keys associated with the Group.
labelsobjectRequired. One or more label entries that apply to the Group. Currently supported labels contain a key with an empty value. Google Groups are the default type of group and have a label with a key of cloudidentity.googleapis.com/groups.discussion_forum and an empty value. Existing Google Groups can have an additional label with a key of cloudidentity.googleapis.com/groups.security and an empty value added to them. This is an immutable change and the security label cannot be removed once added. Dynamic groups have a label with a key of cloudidentity.googleapis.com/groups.dynamic. Identity-mapped groups for Cloud Search have a label with a key of system/groups/external and an empty value.

Methods

NameAccessible byRequired ParamsDescription
getSELECTgroupsIdRetrieves a Group.
listSELECTLists the Group resources under a customer or namespace.
createINSERTCreates a Group.
deleteDELETEgroupsIdDeletes a Group.
_listEXECLists the Group resources under a customer or namespace.
lookupEXECLooks up the resource name of a Group by its EntityKey.
patchEXECgroupsIdUpdates a Group.
searchEXECSearches for Group resources matching a specified query.