Method: projects.databases.importDocuments

Импортирует документы в Google Cloud Firestore. Существующие документы с таким же именем перезаписываются. Импорт происходит в фоновом режиме, и его ход можно отслеживать и управлять с помощью созданного ресурса Operation. Если операция Databases.importDocuments отменена, возможно, часть данных уже была импортирована в Cloud Firestore.

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
name

string

Необходимый. База данных для импорта. Должен иметь форму: projects/{projectId}/databases/{databaseId} .

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "collectionIds": [
    string
  ],
  "inputUriPrefix": string,
  "namespaceIds": [
    string
  ]
}
Поля
collectionIds[]

string

Идентификаторы каких коллекций импортировать. Не указано — все коллекции, включенные в импорт.

inputUriPrefix

string

Расположение экспортированных файлов. Он должен соответствовать выходному UriPrefix ExportDocumentsResponse из успешно завершенного экспорта. См.: google.firestore.admin.v1.ExportDocumentsResponse.output_uri_prefix .

namespaceIds[]

string

Пустой список представляет все пространства имен. Это предпочтительное использование для баз данных, которые не используют пространства имен.

Пустой строковый элемент представляет пространство имен по умолчанию. Это следует использовать, если база данных имеет данные в пространствах имен, отличных от заданных по умолчанию, но не хочет их включать. Каждое пространство имен в этом списке должно быть уникальным.

Тело ответа

В случае успеха тело ответа содержит экземпляр Operation .

Области авторизации

Требуется одна из следующих областей OAuth:

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

Для получения дополнительной информации см. Обзор аутентификации .