Method: projects.locations.setUpDataConnector

Erstellt eine Collection und richtet den entsprechenden DataConnector dafür ein. Verwenden Sie zum Beenden eines DataConnector nach der Einrichtung die Methode CollectionService.DeleteCollection.

HTTP-Anfrage

POST https://discoveryengine.googleapis.com/v1/{parent=projects/*/locations/*}:setUpDataConnector

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das übergeordnete Element der Collection im Format projects/{project}/locations/{location}

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "collectionId": string,
  "collectionDisplayName": string,
  "dataConnector": {
    object (DataConnector)
  }
}
Felder
collectionId

string

Erforderlich. Die ID für die Collection. Wird als letzte Komponente im Ressourcennamen der Collection verwendet. Im Rahmen der Einrichtung des DataConnector wird eine neue Collection erstellt. Der DataConnector ist eine Singleton-Ressource für die Collection und verwaltet alle DataStores der Collection.

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

string

Erforderlich. Der Anzeigename der Collection

Er sollte menschenlesbar sein und wird für die Anzeige von Sammlungen im Console-Dashboard verwendet. Ein UTF-8-codierter String mit höchstens 1.024 Zeichen.
dataConnector

object (DataConnector)

Erforderlich. Der DataConnector, der in der neu erstellten Collection initialisiert werden soll.

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.assist.readwrite

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

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

  • discoveryengine.locations.setUpDataConnector

Weitere Informationen finden Sie in der IAM-Dokumentation.