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

Cria uma Document.

Solicitação HTTP

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

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

Parâmetros de caminho

Parâmetros
parent

string

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

Parâmetros de consulta

Parâmetros
documentId

string

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

Se o autor da chamada não tiver permissão para criar o Document, independente de ele existir ou não, um erro PERMISSION_DENIED será retornado.

Esse campo precisa ser exclusivo entre todos os Documents com o mesmo parent. Caso contrário, é retornado um erro ALREADY_EXISTS.

Esse campo precisa estar em conformidade com o padrão RFC-1034 e ter um limite de 128 caracteres. Caso contrário, um erro INVALID_ARGUMENT será retornado.

Corpo da solicitação

O corpo da solicitação contém uma instância de Document.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Document.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

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

Para mais informações, consulte Authentication Overview.

Permissões do IAM

Requer a seguinte permissão do IAM no recurso parent:

  • discoveryengine.documents.create

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