Method: projects.databases.documents.commit

Zatwierdza transakcję, opcjonalnie aktualizując dokumenty.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC .

Parametry ścieżki

Parametry
database

string

Wymagany. Nazwa bazy danych. W formacie: projects/{projectId}/databases/{databaseId} .

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Reprezentacja JSON
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Pola
writes[]

object ( Write )

Pisze, aby zastosować.

Zawsze wykonywane atomowo i w porządku.

transaction

string ( bytes format)

Jeśli ustawione, stosuje wszystkie zapisy w tej transakcji i zatwierdza je.

Ciąg zakodowany w formacie base64.

Treść odpowiedzi

Odpowiedź dla Firestore.Commit .

Jeśli się powiedzie, treść odpowiedzi zawiera dane o następującej strukturze:

Reprezentacja JSON
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Pola
writeResults[]

object ( WriteResult )

Wynik zastosowania zapisów.

Ten i-ty wynik zapisu odpowiada i-temu zapisowi w żądaniu.

commitTime

string ( Timestamp format)

Czas, w którym nastąpiło zatwierdzenie. Każdy odczyt z równym lub większym readTime gwarantuje zobaczenie efektów zatwierdzenia.

Znacznik czasu w formacie RFC3339 UTC „Zulu”, z rozdzielczością nanosekundową i maksymalnie dziewięcioma cyframi ułamkowymi. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z" .

Zakresy uprawnień

Wymaga jednego z następujących zakresów OAuth:

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

Aby uzyskać więcej informacji, zobacz Omówienie uwierzytelniania .