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

Crea un Document.

Solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación a gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Nombre del recurso superior, como projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Los parámetros de consulta

Parámetros
documentId

string

Obligatorio. El ID que se va a usar en Document, que se convierte en el componente final de Document.name.

Si la persona que llama no tiene permiso para crear el Document, independientemente de si existe o no, se devuelve un error PERMISSION_DENIED.

Este campo debe ser único entre todos los Documents con el mismo parent. De lo contrario, se devuelve un error ALREADY_EXISTS.

Este campo debe cumplir el estándar RFC-1034 y tener una longitud máxima de 128 caracteres. De lo contrario, se devuelve un error INVALID_ARGUMENT.

Cuerpo de la solicitud

En el cuerpo de la solicitud se incluye una instancia de Document.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, en el cuerpo de la respuesta se incluye una instancia recién creada de Document.

Permisos de autorización

Debes disponer de uno de los siguientes permisos de OAuth:

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

Para obtener más información, consulta el Authentication Overview.

Permisos de IAM

Requiere el siguiente permiso de gestión de identidades y accesos en el recurso parent:

  • discoveryengine.documents.create

Para obtener más información, consulta la documentación de gestión de identidades y accesos.