## Resource: Group

SCIM representation of a group.

| JSON representation |
|---|
| ``` { "schemas": [ string ], "members": [ { object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups#Member`) } ], "id": string, "externalId": string, "meta": { object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/Meta`) }, "displayName": string, "urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup": { object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups#CloudIdentityGroupExtension`) } } ``` |

| Fields ||
|---|---|
| `schemas[]` | `string` Required. A list of URIs which indicate the namespaces of the SCIM schemas that define the attributes present in the current JSON structure. Must only contain values defined as `schema` and `schemaExtensions` for the Group ResourceType. |
| `members[]` | ``object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups#Member`)`` Optional. The list of members in this group. This attribute is not currently returned. Group memberships can be modified through PATCH requests. |
| `id` | `string` Identifier. The unique ID for the group. The attribute characteristics are `caseExact` as `true`, a mutability of `readOnly`, and a `returned` characteristic of `always`. |
| `externalId` | `string` Optional. An identifier for the resource as defined by the provisioning client. |
| `meta` | ``object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/Meta`)`` Output only. Resource metadata. All sub-attributes have a mutability of `readOnly` and a `returned` characteristic of `default`. |
| `displayName` | `string` Required. The group's display name. |
| `urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup` | ``object (`https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups#CloudIdentityGroupExtension`)`` Required. Cloud Identity specific group attributes. |

## Member

SCIM representation of a group member.

| JSON representation |
|---|
| ``` { "value": string, "$ref": string } ``` |

| Fields ||
|---|---|
| `value` | `string` Immutable. Identifier of the member of this Group. |
| `$ref` | `string` Immutable. The URI for the member. |

## CloudIdentityGroupExtension

Defines the attributes for the Google Cloud Identity Group extension. The schema URN for this extension is: `urn:ietf:params:scim:schemas:extension:google:2.0:CloudIdentityGroup`.

| JSON representation |
|---|
| ``` { "email": string, "description": string } ``` |

| Fields ||
|---|---|
| `email` | `string` Required. The group's email address. If your account has multiple domains, select the appropriate domain for the email address. The `email` must be unique. Group email addresses are subject to the same character usage rules as usernames. For details, see the [help center documentation](https://support.google.com/a/answer/9193374). |
| `description` | `string` Optional. An extended description to help users determine the purpose of a `Group`. Limit: 4,096 characters. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups/create` | Creates a Group. |
| ### `https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups/delete` | Deletes a Group. |
| ### `https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups/get` | Retrieves a Group. |
| ### `https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups/list` | Retrieves a list of Groups. |
| ### `https://docs.cloud.google.com/identity/docs/scim/reference/rest/v1/customers.v2.Groups/patch` | Updates a Group using SCIM patch semantics. |