Menerapkan batch operasi tulis.
Metode documents.batchWrite tidak menerapkan operasi tulis secara atomik dan dapat menerapkannya secara tidak berurutan. Metode tidak mengizinkan lebih dari satu penulisan per dokumen. Setiap penulisan berhasil atau gagal secara terpisah. Lihat BatchWriteResponse
untuk mengetahui status keberhasilan setiap penulisan.
Jika Anda memerlukan kumpulan penulisan yang diterapkan secara atomik, gunakan documents.commit
.
Permintaan HTTP
POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:batchWrite
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. Metode tidak menerapkan penulisan secara atomik dan tidak menjamin pengurutan. Setiap penulisan berhasil atau gagal secara terpisah. Anda tidak dapat menulis ke dokumen yang sama lebih dari sekali per permintaan. |
labels |
Label yang terkait dengan penulisan batch ini. Objek yang berisi daftar pasangan |
Isi respons
Respons dari Firestore.BatchWrite
.
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. |
status[] |
Status penerapan penulisan. Status penulisan ke-i ini sesuai dengan penulisan ke-i dalam permintaan. |
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.