Method: projects.locations.completeExternalIdentities

Cette méthode fournit des suggestions pour les utilisateurs et les groupes gérés dans un fournisseur d'identité externe, en fonction du préfixe fourni.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de ressource de l'emplacement parent, par exemple projects/*/locations/global.

Paramètres de requête

Paramètres
prefixQuery

string

Obligatoire. Préfixe à rechercher. Pour les utilisateurs, ce préfixe est mis en correspondance avec primaryEmail. Pour les groupes, ce préfixe est mis en correspondance avec le displayName. La correspondance n'est pas sensible à la casse.
maxSuggestions

integer

Facultatif. Nombre maximal de résultats d'utilisateurs et de groupes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur.

Si aucune valeur n'est spécifiée, six résultats au maximum sont renvoyés. La limite est répartie aussi équitablement que possible entre les utilisateurs et les groupes. Par exemple, si maxSuggestions est défini sur 7, le service peut renvoyer quatre utilisateurs et trois groupes. Si le nombre de suggestions d'un type est inférieur à la moitié de la limite, l'autre type peut renvoyer plus de suggestions, jusqu'à la limite maxSuggestions.
entityTypeFilter

enum (EntityTypeFilter)

Facultatif. Type d'entités à récupérer. Si ce paramètre n'est pas défini, tous les types d'entités seront renvoyés.
useScimIdentities

boolean

Facultatif. Indique s'il faut utiliser les identités SCIM pour compléter les identités externes. Si la valeur est "false", nous appellerons l'API Microsoft Graph pour récupérer les identités externes.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Message de réponse pour CompletionService.CompleteExternalIdentities.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "externalIdentities": [
    {
      object (ExternalIdentity)
    }
  ]
}
Champs
externalIdentities[]

object (ExternalIdentity)

Liste des identités externes correspondant à la requête.

Niveaux d'accès des autorisations

Nécessite l'un des niveaux d'accès OAuth suivants :

  • 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

Pour plus d'informations, consultez la page Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.locations.completeExternalIdentities

Pour en savoir plus, consultez la documentation IAM.

EntityTypeFilter

Type d'entités à récupérer.

Enums
ENTITY_TYPE_FILTER_UNSPECIFIED Filtre de type d'entité non spécifié.
USERS Récupérer uniquement les utilisateurs.
GROUPS Récupérer uniquement les groupes.

ExternalIdentity

Identité externe représentant un utilisateur ou un groupe. Cet utilisateur ou ce groupe provient d'un fournisseur d'identité (IdP) externe.

Représentation JSON 
{
  "externalId": string,
  "displayName": string,

  // Union field EntityType can be only one of the following:
  "userMetadata": {
    object (UserMetadata)
  },
  "groupMetadata": {
    object (GroupMetadata)
  }
  // End of list of possible types for union field EntityType.
}
Champs
externalId

string

ID tiers unique(externalId) de l'entité (utilisateur ou groupe).
displayName

string

Nom à afficher de l'utilisateur ou du groupe.
Champ d'union EntityType. Type de l'identité externe. Cette valeur permet d'indiquer le type d'entité (utilisateur ou groupe) et les métadonnées correspondantes. EntityType ne peut être qu'un des éléments suivants :
userMetadata

object (UserMetadata)

métadonnées correspondant à l'utilisateur externe.
groupMetadata

object (GroupMetadata)

métadonnées correspondant à l'utilisateur externe.

UserMetadata

métadonnées correspondant à l'utilisateur externe.

Représentation JSON 
{
  "givenName": string,
  "familyName": string,
  "primaryEmail": string
}
Champs
givenName

string

Prénom de l'utilisateur.
familyName

string

Nom de famille de l'utilisateur.
primaryEmail

string

Adresse e-mail principale de l'utilisateur.

GroupMetadata

Ce type ne comporte aucun champ.

métadonnées correspondant au groupe externe.