Method: projects.databases.documents.batchWrite

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/v1/{database=projects/*/databases/*}/documents:batchWrite

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
database

string

Wajib diisi. Nama {i>database<i}. Dalam format: projects/{projectId}/databases/{databaseId}.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "labels": {
    string: string,
    ...
  }
}
Kolom
writes[]

object (Write)

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

map (key: string, value: string)

Label yang terkait dengan penulisan batch ini.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Isi respons

Respons dari Firestore.BatchWrite.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "status": [
    {
      object (Status)
    }
  ]
}
Kolom
writeResults[]

object (WriteResult)

Hasil penerapan penulisan.

Hasil penulisan ke-i ini sesuai dengan penulisan ke-i dalam permintaan.
status[]

object (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.