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

Cria um Document.

Pedido HTTP

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

O URL usa a sintaxe de transcodificação de gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. O nome do recurso principal, como projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Parâmetros de consulta

Parâmetros
documentId

string

Obrigatório. O ID a usar para o Document, que se torna o componente final do Document.name.

Se o autor da chamada não tiver autorização para criar o Document, independentemente de existir ou não, é devolvido um erro PERMISSION_DENIED.

Este campo tem de ser exclusivo entre todos os Documents com o mesmo parent. Caso contrário, é devolvido um erro ALREADY_EXISTS.

Este campo tem de estar em conformidade com a norma RFC-1034, com um limite de comprimento de 128 carateres. Caso contrário, é devolvido um erro INVALID_ARGUMENT.

Corpo do pedido

O corpo do pedido contém uma instância de Document.

Corpo da resposta

Se for bem-sucedido, o corpo da resposta contém uma instância recém-criada de Document.

Âmbitos de autorização

Requer um dos seguintes âmbitos do OAuth:

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

Para mais informações, consulte o Authentication Overview.

Autorizações de IAM

Requer a seguinte autorização de IAM no recurso parent:

  • discoveryengine.documents.create

Para mais informações, consulte a documentação do IAM.