- [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/IdentityMappingEntry#SCHEMA_REPRESENTATION)

Identity Mapping Entry that maps an external identity to an internal identity.

| JSON representation |
|---|
| ``` { "externalIdentity": string, "externalIdentityName": string, // The following is a list of mutually exclusive fields. At most one of the // fields will be set in a response: "userId": string, "groupId": string // End of mutually exclusive fields. } ``` |

| Fields ||
|---|---|
| `externalIdentity` | `string` Required. Identity outside the customer identity provider. The length limit of external identity will be of 100 characters. |
| `externalIdentityName` | `string` Optional. The name of the external identity. |
| Union field identity_provider_id. Identity Provider ID can be a user or a group. The following is a list of mutually exclusive fields. At most one of the fields will be set in a response: ||
| `userId` | `string` User identifier. For Google Workspace user account, userId should be the google workspace user email. For non-google identity provider, userId is the mapped user identifier configured during the workforcepool config. |
| `groupId` | `string` Group identifier. For Google Workspace user account, groupId should be the google workspace group email. For non-google identity provider, groupId is the mapped group identifier configured during the workforcepool config. |
| End of mutually exclusive fields. ||