Method: projects.locations.sampleQuerySets.sampleQueries.import

Bulk-Import mehrerer SampleQuerys. Beispielabfragen, die bereits vorhanden sind, können gelöscht werden.

Hinweis: Es ist möglich, dass nur ein Teil der SampleQuerys erfolgreich importiert wird.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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

Wenn der Aufrufer keine Berechtigung hat, SampleQuerys unter diesem Beispiel-Abfrageset aufzulisten, wird der Fehler PERMISSION_DENIED zurückgegeben. Dies geschieht unabhängig davon, ob dieses Beispiel-Abfrageset vorhanden ist oder nicht.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{
  "errorConfig": {
    object (ImportErrorConfig)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "inlineSource": {
    object (InlineSource)
  },
  "gcsSource": {
    object (GcsSource)
  },
  "bigquerySource": {
    object (BigQuerySource)
  }
  // End of mutually exclusive fields.
}
Felder
errorConfig

object (ImportErrorConfig)

Der gewünschte Speicherort für Fehler, die während des Imports aufgetreten sind.

Die Quelle der Beispielabfragen. Die folgende Liste enthält sich gegenseitig ausschließende Felder. In einer Antwort wird höchstens eines der Felder festgelegt:
inlineSource

object (InlineSource)

Die Inline-Quelle für Beispielabfrageeinträge.

gcsSource

object (GcsSource)

Cloud Storage-Speicherort für die Eingabeinhalte.

bigquerySource

object (BigQuerySource)

BigQuery-Eingabequelle

Ende der sich gegenseitig ausschließenden Felder.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

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.import

Weitere Informationen finden Sie in der IAM-Dokumentation.

InlineSource

Die Inline-Quelle für SampleQuerys.

JSON-Darstellung
{
  "sampleQueries": [
    {
      object (SampleQuery)
    }
  ]
}
Felder
sampleQueries[]

object (SampleQuery)

Erforderlich. Eine Liste der zu importierenden SampleQuerys. Maximal 1.000 Elemente