Method: projects.databases.documents.commit

Melakukan transaksi, sambil memperbarui dokumen secara opsional.

permintaan HTTP

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

URL menggunakan sintaks Transcoding gRPC .

Parameter jalur

Parameter
database

string

Diperlukan. Nama basis data. Dalam format: projects/{projectId}/databases/{databaseId} .

Permintaan tubuh

Badan permintaan berisi data dengan struktur berikut:

Representasi JSON
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Bidang
writes[]

object ( Write )

Tulisan untuk melamar.

Selalu dieksekusi secara atom dan berurutan.

transaction

string ( bytes format)

Jika disetel, terapkan semua penulisan dalam transaksi ini, dan lakukan.

String yang dikodekan base64.

Badan respons

Respons untuk Firestore.Commit .

Jika berhasil, isi respons berisi data dengan struktur berikut:

Representasi JSON
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Bidang
writeResults[]

object ( WriteResult )

Hasil penerapan tulisan.

Hasil penulisan ke-i ini sesuai dengan penulisan ke-i dalam permintaan.

commitTime

string ( Timestamp format)

Waktu saat penerapan terjadi. Setiap pembacaan dengan readTime yang sama atau lebih besar dijamin akan melihat efek penerapannya.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z" .

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk informasi lebih lanjut, lihat Ikhtisar Otentikasi .