Method: projects.databases.documents.commit

Zatwierdzanie transakcji i opcjonalne aktualizowanie dokumentów.

Żą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

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

Treść żądania

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

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

object (Write)

Zapisy do zastosowania.

Zawsze wykonywane atomowo i w kolejności.
transaction

string (bytes format)

Jeśli zasada jest skonfigurowana, stosuje i zatwierdza wszystkie zapisy w tej transakcji.

Ciąg zakodowany w standardzie base64.

Treść odpowiedzi

Odpowiedź dotycząca: Firestore.Commit.

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Zapis 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 wystąpienia zatwierdzenia. Każdy odczyt o wartości readTime lub większej z gwarancji pokazuje efekty zatwierdzenia.

Sygnatura czasowa w formacie „Zulu” RFC3339 UTC z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.