Melakukan transaksi, sekaligus memperbarui dokumen secara opsional.
Permintaan HTTP
POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit
URL menggunakan sintaks gRPC Transcoding.
Parameter jalur
Parameter | |
---|---|
database |
Wajib diisi. Nama {i>database<i}. Dalam format: |
Isi permintaan
Isi permintaan memuat data dengan struktur berikut:
Representasi JSON |
---|
{
"writes": [
{
object ( |
Kolom | |
---|---|
writes[] |
Penulisan yang akan diterapkan. Selalu dijalankan secara atomik dan berurutan. |
transaction |
Jika ditetapkan, semua penulisan dalam transaksi ini akan diterapkan, lalu di-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 ke-i ini sesuai dengan penulisan ke-i dalam permintaan. |
commitTime |
Waktu terjadinya commit. Setiap pembacaan dengan Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: |
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.