Toplu yazma işlemi uygular.
documents.batchWrite yöntemi, yazma işlemlerini atomik olarak uygulamaz ve bunları sıra dışı bir şekilde uygulayabilir. Yöntem, belge başına birden fazla yazmaya izin vermiyor. Her yazma işlemi bağımsız olarak başarılı veya başarısız olur. Her yazma işleminin başarı durumunu görmek için BatchWriteResponse
göz atın.
Atomik olarak uygulanmış bir yazma grubu gerekiyorsa bunun yerine documents.commit
kullanın.
HTTP isteği
POST https://firestore.googleapis.com/v1/{database=projects/*/databases/*}/documents:batchWrite
URL, gRPC Kod Dönüştürme söz dizimini kullanır.
Yol parametreleri
Parametreler | |
---|---|
database |
Zorunlu. Veritabanı adı. Biçimi: |
İstek içeriği
İsteğin gövdesi, aşağıdaki yapıya sahip veriler içerir:
JSON gösterimi |
---|
{
"writes": [
{
object ( |
Alanlar | |
---|---|
writes[] |
Uygulanacak yazmalar. Yöntem, yazma işlemlerini atomik olarak uygulamaz ve sıralamayı garanti etmez. Her yazma işlemi bağımsız olarak başarılı veya başarısız olur. Aynı dokümana istek başına birden fazla kez yazamazsınız. |
labels |
Bu toplu yazma işlemiyle ilişkili etiketler.
|
Yanıt gövdesi
Firestore.BatchWrite
adlı kullanıcının yanıtı.
Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:
JSON gösterimi |
---|
{ "writeResults": [ { object ( |
Alanlar | |
---|---|
writeResults[] |
Yazmalar uygulandığında elde edilen sonuç. Bu yazma sonucu, istekteki son yazma işlemine karşılık gelir. |
status[] |
Yazmaların uygulanma durumu. Bu yazma durumu, istekteki son yazma işlemine karşılık gelir. |
Yetkilendirme kapsamları
Aşağıdaki OAuth kapsamlarından birini gerektirir:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
Daha fazla bilgi için Kimlik Doğrulamaya Genel Bakış sayfasına göz atın.