Method: projects.locations.dataStores.branches.documents.create

Erstellt einen Document.

HTTP-Anfrage

POST https://discoveryengine.googleapis.com/v1beta/{parent=projects/*/locations/*/dataStores/*/branches/*}/documents

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Der Name der übergeordneten Ressource, z. B. projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Abfrageparameter

Parameter
documentId

string

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

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

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

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

Anfragetext

Der Anfragetext enthält eine Instanz von Document.

Antworttext

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

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie unter Authentication Overview.

IAM-Berechtigungen

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

  • discoveryengine.documents.create

Weitere Informationen finden Sie in der IAM-Dokumentation.