Method: projects.locations.sampleQuerySets.sampleQueries.create

Crea un SampleQuery.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Nombre del recurso superior, como projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}.

Los parámetros de consulta

Parámetros
sampleQueryId

string

Obligatorio. El ID que se usará en SampleQuery, que se convertirá en el componente final de SampleQuery.name.

Si la persona que llama no tiene permiso para crear el SampleQuery, independientemente de si existe o no, se devuelve un error PERMISSION_DENIED.

Este campo debe ser único entre todos los SampleQuerys con el mismo parent. De lo contrario, se devuelve un error ALREADY_EXISTS.

Este campo debe cumplir el estándar RFC-1034 y tener una longitud máxima de 63 caracteres. De lo contrario, se devuelve un error INVALID_ARGUMENT.

Cuerpo de la solicitud

En el cuerpo de la solicitud se incluye una instancia de SampleQuery.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de SampleQuery.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:

  • discoveryengine.sampleQueries.create

Para obtener más información, consulta la documentación de gestión de identidades y accesos.