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

Crea un Document.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. Il nome della risorsa padre, ad esempio projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Parametri di query

Parametri
documentId

string

Obbligatorio. L'ID da utilizzare per Document, che diventa il componente finale di Document.name.

Se il chiamante non dispone dell'autorizzazione per creare Document, indipendentemente dalla sua esistenza, viene restituito un errore PERMISSION_DENIED.

Il valore di questo campo deve essere univoco tra tutti i Document con lo stesso parent. In caso contrario, viene restituito un errore ALREADY_EXISTS.

Questo campo deve essere conforme allo standard RFC-1034 con un limite di lunghezza di 128 caratteri. In caso contrario, viene restituito un errore INVALID_ARGUMENT.

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di Document.

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza appena creata di Document.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta Authentication Overview.

Autorizzazioni IAM

Richiede la seguente autorizzazione IAM per la risorsa parent:

  • discoveryengine.documents.create

Per saperne di più, consulta la documentazione di IAM.