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

Crée un objet Document.

Requête HTTP

POST https://discoveryengine.googleapis.com/v1/{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, tel que projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}/branches/{branch}.

Paramètres de requête

Paramètres
documentId

string

Obligatoire. ID à utiliser pour le Document, qui devient le composant final de le 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.

Ce champ doit être unique parmi tous les Documents 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 niveaux d'accès OAuth suivants :

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

Pour plus d'informations, consultez la page 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.