Reference documentation and code samples for the Discovery Engine V1 API class Google::Cloud::DiscoveryEngine::V1::Principal.
Principal identifier of a user or a group.
Inherits
Object
Extended By
Google::Protobuf::MessageExts::ClassMethods
Includes
Google::Protobuf::MessageExts
Methods
#external_entity_id
defexternal_entity_id()->::String
Returns
(::String) — For 3P application identities which are not present in the customer
identity provider.
Note: The following fields are mutually exclusive: external_entity_id, user_id, group_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
#external_entity_id=
defexternal_entity_id=(value)->::String
Parameter
value (::String) — For 3P application identities which are not present in the customer
identity provider.
Note: The following fields are mutually exclusive: external_entity_id, user_id, group_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
Returns
(::String) — For 3P application identities which are not present in the customer
identity provider.
Note: The following fields are mutually exclusive: external_entity_id, user_id, group_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
#group_id
defgroup_id()->::String
Returns
(::String) — Group identifier.
For Google Workspace user account, group_id should be the google
workspace group email.
For non-google identity provider user account, group_id is the mapped
group identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: group_id, user_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
#group_id=
defgroup_id=(value)->::String
Parameter
value (::String) — Group identifier.
For Google Workspace user account, group_id should be the google
workspace group email.
For non-google identity provider user account, group_id is the mapped
group identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: group_id, user_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
Returns
(::String) — Group identifier.
For Google Workspace user account, group_id should be the google
workspace group email.
For non-google identity provider user account, group_id is the mapped
group identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: group_id, user_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
#user_id
defuser_id()->::String
Returns
(::String) — User identifier.
For Google Workspace user account, user_id should be the google workspace
user email.
For non-google identity provider user account, user_id is the mapped user
identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: user_id, group_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
#user_id=
defuser_id=(value)->::String
Parameter
value (::String) — User identifier.
For Google Workspace user account, user_id should be the google workspace
user email.
For non-google identity provider user account, user_id is the mapped user
identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: user_id, group_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
Returns
(::String) — User identifier.
For Google Workspace user account, user_id should be the google workspace
user email.
For non-google identity provider user account, user_id is the mapped user
identifier configured during the workforcepool config.
Note: The following fields are mutually exclusive: user_id, group_id, external_entity_id. If a field in that set is populated, all other fields in the set will automatically be cleared.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Discovery Engine V1 API - Class Google::Cloud::DiscoveryEngine::V1::Principal (v2.4.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.4.0 (latest)](/ruby/docs/reference/google-cloud-discovery_engine-v1/latest/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [2.3.1](/ruby/docs/reference/google-cloud-discovery_engine-v1/2.3.1/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [2.2.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/2.2.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [2.1.1](/ruby/docs/reference/google-cloud-discovery_engine-v1/2.1.1/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [2.0.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/2.0.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.5.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.5.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.4.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.4.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.3.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.3.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.2.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.2.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.1.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.1.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [1.0.2](/ruby/docs/reference/google-cloud-discovery_engine-v1/1.0.2/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.9.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.9.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.8.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.8.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.7.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.7.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.6.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.6.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.5.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.5.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.4.2](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.4.2/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.3.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.3.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.2.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.2.0/Google-Cloud-DiscoveryEngine-V1-Principal)\n- [0.1.0](/ruby/docs/reference/google-cloud-discovery_engine-v1/0.1.0/Google-Cloud-DiscoveryEngine-V1-Principal) \nReference documentation and code samples for the Discovery Engine V1 API class Google::Cloud::DiscoveryEngine::V1::Principal.\n\nPrincipal identifier of a user or a group. \n\nInherits\n--------\n\n- Object \n\nExtended By\n-----------\n\n- Google::Protobuf::MessageExts::ClassMethods \n\nIncludes\n--------\n\n- Google::Protobuf::MessageExts\n\nMethods\n-------\n\n### #external_entity_id\n\n def external_entity_id() -\u003e ::String\n\n**Returns**\n\n- (::String) --- For 3P application identities which are not present in the customer identity provider.\n\n Note: The following fields are mutually exclusive: `external_entity_id`, `user_id`, `group_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.\n\n### #external_entity_id=\n\n def external_entity_id=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- For 3P application identities which are not present in the customer identity provider.\n\n\nNote: The following fields are mutually exclusive: `external_entity_id`, `user_id`, `group_id`. If a field in that set is populated, all other fields in the set will automatically be cleared. \n**Returns**\n\n- (::String) --- For 3P application identities which are not present in the customer identity provider.\n\n Note: The following fields are mutually exclusive: `external_entity_id`, `user_id`, `group_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.\n\n### #group_id\n\n def group_id() -\u003e ::String\n\n**Returns**\n\n- (::String) --- Group identifier. For Google Workspace user account, group_id should be the google workspace group email. For non-google identity provider user account, group_id is the mapped group identifier configured during the workforcepool config.\n\n Note: The following fields are mutually exclusive: `group_id`, `user_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.\n\n### #group_id=\n\n def group_id=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- Group identifier. For Google Workspace user account, group_id should be the google workspace group email. For non-google identity provider user account, group_id is the mapped group identifier configured during the workforcepool config.\n\n\nNote: The following fields are mutually exclusive: `group_id`, `user_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared. \n**Returns**\n\n- (::String) --- Group identifier. For Google Workspace user account, group_id should be the google workspace group email. For non-google identity provider user account, group_id is the mapped group identifier configured during the workforcepool config.\n\n Note: The following fields are mutually exclusive: `group_id`, `user_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.\n\n### #user_id\n\n def user_id() -\u003e ::String\n\n**Returns**\n\n- (::String) --- User identifier. For Google Workspace user account, user_id should be the google workspace user email. For non-google identity provider user account, user_id is the mapped user identifier configured during the workforcepool config.\n\n Note: The following fields are mutually exclusive: `user_id`, `group_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared.\n\n### #user_id=\n\n def user_id=(value) -\u003e ::String\n\n**Parameter**\n\n- **value** (::String) --- User identifier. For Google Workspace user account, user_id should be the google workspace user email. For non-google identity provider user account, user_id is the mapped user identifier configured during the workforcepool config.\n\n\nNote: The following fields are mutually exclusive: `user_id`, `group_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared. \n**Returns**\n\n- (::String) --- User identifier. For Google Workspace user account, user_id should be the google workspace user email. For non-google identity provider user account, user_id is the mapped user identifier configured during the workforcepool config.\n\n Note: The following fields are mutually exclusive: `user_id`, `group_id`, `external_entity_id`. If a field in that set is populated, all other fields in the set will automatically be cleared."]]