Method: projects.databases.documents.commit

Фиксирует транзакцию, при необходимости обновляя документы.

HTTP-запрос

POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:commit

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

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

Параметры
database

string

Необходимый. Имя базы данных. В формате: projects/{projectId}/databases/{databaseId} .

Тело запроса

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

JSON-представление 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Поля
writes[]

object ( Write )

Пишет подать заявку.

Всегда выполняется атомарно и по порядку.

transaction

string ( bytes format)

Если установлено, применяются все записи в этой транзакции и фиксируются.

Строка в кодировке Base64.

Тело ответа

Ответ на Firestore.Commit .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Поля
writeResults[]

object ( WriteResult )

Результат применения записи.

Этот i-й результат записи соответствует i-й записи в запросе.

commitTime

string ( Timestamp format)

Время, когда произошла фиксация. Любое чтение с равным или большим значением readTime гарантированно увидит эффект фиксации.

Временная метка в формате RFC3339 UTC «Зулу» с наносекундным разрешением и до девяти дробных цифр. Примеры: "2014-10-02T15:01:23Z" и "2014-10-02T15:01:23.045123456Z" .

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

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

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

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