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

Crée un objet Document.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Nom de la ressource parente, par exemple projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Paramètres de requête

Paramètres
documentId

string

Obligatoire. ID à utiliser pour Document, qui devient le composant final de Document.name.

Si l'appelant n'est pas autorisé à créer le Document, qu'il existe ou non, une erreur PERMISSION_DENIED est renvoyée.

La valeur de ce champ doit être unique parmi tous les Document ayant le même parent. Dans le cas contraire, une erreur ALREADY_EXISTS est renvoyée.

Ce champ doit être conforme à la norme RFC-1034 et ne pas dépasser 128 caractères. Dans le cas contraire, une erreur INVALID_ARGUMENT est renvoyée.

Corps de la requête

Le corps de la requête contient une instance de Document.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une nouvelle instance de Document.

Niveaux d'accès des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour plus d'informations, consultez la Authentication Overview.

Autorisations IAM

Nécessite l'autorisation IAM suivante sur la ressource parent :

  • discoveryengine.documents.create

Pour en savoir plus, consultez la documentation IAM.