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

Crea un Document.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso principal, como projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Parámetros de consulta

Parámetros
documentId

string

Obligatorio. Es el ID que se usará para el Document, que se convertirá en el componente final del Document.name.

Si el llamador 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 Document con el mismo parent. De lo contrario, se muestra un error ALREADY_EXISTS.

Este campo debe cumplir con el estándar RFC-1034 y tener un límite de 128 caracteres. De lo contrario, se muestra un error INVALID_ARGUMENT.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Document.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Document.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

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

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

Permisos de IAM

Se requiere el siguiente permiso de IAM en el recurso parent:

  • discoveryengine.documents.create

Para obtener más información, consulta la documentación de IAM.