Melakukan transaksi, sekaligus memperbarui dokumen secara opsional.
Permintaan HTTP
POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
database |
Wajib. Nama database. Dalam format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"writes": [
{
object ( |
Kolom | |
---|---|
writes[] |
Penulisan yang akan diterapkan. Selalu dieksekusi secara atomik dan berurutan. |
transaction |
Jika ditetapkan, menerapkan semua penulisan dalam transaksi ini dan melakukan commit. String berenkode base64. |
Isi respons
Respons untuk Firestore.Commit
.
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"writeResults": [
{
object ( |
Kolom | |
---|---|
writeResults[] |
Hasil penerapan penulisan. Hasil penulisan i-th ini sesuai dengan penulisan i-th dalam permintaan. |
commitTime |
Waktu saat commit terjadi. Setiap operasi baca dengan Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Untuk informasi selengkapnya, lihat Ringkasan Autentikasi.