Method: projects.databases.importDocuments

Importe des documents dans Google Cloud Firestore. Les documents existants portant le même nom sont écrasés. L'importation s'effectue en arrière-plan et sa progression peut être surveillée et gérée via la ressource Opération créée. Si une opération databases.importDocuments est annulée, il est possible qu'un sous-ensemble de données ait déjà été importé dans Cloud Firestore.

Requête HTTP

POST https://firestore.googleapis.com/v1beta1/{name=projects/*/databases/*}:importDocuments

L'URL utilise la syntaxe de transcodage gRPC .

Paramètres du chemin

Paramètres
name

string

Base de données dans laquelle importer. Doit être de la forme : projects/{projectId}/databases/{databaseId} .

Corps de la demande

Le corps de la requête contient des données avec la structure suivante :

Représentation JSON
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string
}
Des champs
collectionIds[]

string

Quels identifiants de collection importer. Non spécifié signifie toutes les collections incluses dans l'importation.

inputUriPrefix

string

Emplacement des fichiers exportés. Cela doit correspondre au outputUriPrefix d’un ExportDocumentsResponse d’une exportation qui s’est terminée avec succès. Voir : google.firestore.admin.v1beta1.ExportDocumentsResponse.output_uri_prefix .

Corps de réponse

En cas de succès, le corps de la réponse contient une instance de Operation .

Portées des autorisations

Nécessite l'une des étendues OAuth suivantes :

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

Pour plus d'informations, consultez la Présentation de l'authentification .