Method: projects.locations.completeExternalIdentities

Questo metodo fornisce suggerimenti per utenti e gruppi gestiti in un provider di identità esterno, in base al prefisso fornito.

Richiesta HTTP

GET https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*}:completeExternalIdentities

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa della località principale, ad esempio projects/*/locations/global.

Parametri di query

Parametri
prefixQuery

string

Obbligatorio. Il prefisso da cercare. Per gli utenti, questo prefisso viene confrontato con primaryEmail. Per i gruppi, questo prefisso viene confrontato con displayName. La corrispondenza non fa distinzione tra maiuscole e minuscole.
maxSuggestions

integer

Facoltativo. Il numero massimo di risultati di utenti e gruppi da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore.

Se non specificato, verranno restituiti al massimo 6 risultati. Il limite viene distribuito il più uniformemente possibile tra utenti e gruppi. Ad esempio, se maxSuggestions è 7, il servizio potrebbe restituire 4 utenti e 3 gruppi. Se i suggerimenti di un tipo sono inferiori alla metà del limite, l'altro tipo può restituire più suggerimenti fino al limite maxSuggestions.
entityTypeFilter

enum (EntityTypeFilter)

Facoltativo. Il tipo di entità da recuperare. Se non impostato, verranno restituiti tutti i tipi di entità.
useScimIdentities

boolean

Facoltativo. Indica se utilizzare le identità SCIM per il completamento delle identità esterne. Se il valore è false, chiameremo l'API Microsoft Graph per recuperare le identità esterne.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Messaggio di risposta per CompletionService.CompleteExternalIdentities.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "externalIdentities": [
    {
      object (ExternalIdentity)
    }
  ]
}
Campi
externalIdentities[]

object (ExternalIdentity)

L'elenco delle identità esterne che corrispondono alla query.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.assist.readwrite
  • https://www.googleapis.com/auth/discoveryengine.readwrite
  • https://www.googleapis.com/auth/discoveryengine.serving.readwrite

Per saperne di più, consulta la Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • discoveryengine.locations.completeExternalIdentities

Per saperne di più, consulta la documentazione di IAM.

EntityTypeFilter

Il tipo di entità da recuperare.

Enum
ENTITY_TYPE_FILTER_UNSPECIFIED Filtro del tipo di entità non specificato.
USERS Recupera solo gli utenti.
GROUPS Recupera solo i gruppi.

ExternalIdentity

Identità esterna che rappresenta un utente o un gruppo. Questo utente o gruppo proviene da un provider di identità (IdP) esterno.

Rappresentazione JSON 
{
  "externalId": string,
  "displayName": string,
  "subject": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "userMetadata": {
    object (UserMetadata)
  },
  "groupMetadata": {
    object (GroupMetadata)
  }
  // End of mutually exclusive fields.
}
Campi
externalId

string

L'ID univoco di terze parti(externalId) dell'entità (utente o gruppo).
displayName

string

Il nome visualizzato dell'utente o del gruppo.
subject

string

Solo output. Rappresenta l'identificatore del soggetto IAM canonico (per gli utenti) o l'identificatore del gruppo (per i gruppi), derivato dalla mappatura delle attestazioni del pool di forza lavoro. Se non è impostato, viene utilizzata la logica personalizzata.

Questo deve essere utilizzato per i binding IAM.
Il tipo di identità esterna. Viene utilizzato per indicare il tipo di entità (utente o gruppo) e i metadati corrispondenti. Di seguito è riportato un elenco di campi reciprocamente esclusivi. Nella risposta verrà impostato al massimo uno dei seguenti campi:
userMetadata

object (UserMetadata)

Metadati corrispondenti all'utente esterno.
groupMetadata

object (GroupMetadata)

Metadati corrispondenti all'utente esterno.
Fine dei campi reciprocamente esclusivi.

UserMetadata

Metadati corrispondenti all'utente esterno.

Rappresentazione JSON 
{
  "givenName": string,
  "familyName": string,
  "primaryEmail": string
}
Campi
givenName

string

Il nome dell'utente.
familyName

string

Il cognome dell'utente.
primaryEmail

string

L'indirizzo email principale dell'utente. Non utilizzare questo campo per i binding IAM. Utilizza ExternalIdentity.subject.

GroupMetadata

Questo tipo non ha campi.

Metadati corrispondenti al gruppo esterno.