Method: projects.locations.sampleQuerySets.sampleQueries.create

Crée un SampleQuery.

Requête HTTP

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/sampleQuerySets/*}/sampleQueries

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource parente, par exemple projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}.

Paramètres de requête

Paramètres
sampleQueryId

string

Obligatoire. ID à utiliser pour SampleQuery, qui constituera le composant final de SampleQuery.name.

Si l'appelant n'est pas autorisé à créer le SampleQuery, qu'il existe ou non, une erreur PERMISSION_DENIED est renvoyée.

La valeur de ce champ doit être unique parmi tous les SampleQuery ayant le même parent. Dans le cas contraire, une erreur ALREADY_EXISTS est renvoyée.

Ce champ doit être conforme à la norme RFC-1034 et ne pas comporter plus de 63 caractères. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée.

Corps de la requête

Le corps de la requête contient une instance de SampleQuery.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de SampleQuery.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

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

  • discoveryengine.sampleQueries.create

Pour en savoir plus, consultez la documentation IAM.