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 la 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 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, au maximum six résultats sont renvoyés. La limite est répartie aussi uniformément 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. S'il y a moins de suggestions d'un type que 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 aucune valeur n'est définie, tous les types d'entités sont renvoyés.
useScimIdentities

boolean

Facultatif. Indique si les identités SCIM doivent être utilisées pour la saisie semi-automatique des identités externes. Si la valeur est "false", nous appelons 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 qui correspondent à 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é 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 d'identité externe. Il 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.