Method: projects.locations.sampleQuerySets.sampleQueries.create

Erstellt ein SampleQuery

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name der übergeordneten Ressource, z. B. projects/{project}/locations/{location}/sampleQuerySets/{sampleQuerySet}

Suchparameter

Parameter
sampleQueryId

string

Erforderlich. Die für SampleQuery zu verwendende ID, die die letzte Komponente von SampleQuery.name wird.

Wenn der Aufrufer nicht berechtigt ist, die SampleQuery zu erstellen, unabhängig davon, ob sie vorhanden ist oder nicht, wird ein PERMISSION_DENIED-Fehler zurückgegeben.

Dieses Feld muss für alle SampleQuerys mit demselben parent eindeutig sein. Andernfalls wird der Fehler ALREADY_EXISTS zurückgegeben.

Dieses Feld muss dem RFC-1034-Standard entsprechen und darf maximal 63 Zeichen lang sein. Andernfalls wird der Fehler INVALID_ARGUMENT zurückgegeben.

Anfragetext

Der Anfragetext enthält eine Instanz von SampleQuery.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine neu erstellte Instanz von SampleQuery.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

Erfordert die folgende IAM-Berechtigung für die Ressource parent:

  • discoveryengine.sampleQueries.create

Weitere Informationen finden Sie in der IAM-Dokumentation.