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

Erstellt ein Document

HTTP-Anfrage

POST https://discoveryengine.googleapis.com/v1alpha/{parent=projects/*/locations/*/collections/*/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}

Anfrageparameter

Parameter
documentId

string

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

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

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

Dieses Feld muss dem Standard RFC 1034 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.