Write

Belgeye yazı yazmak.

JSON gösterimi 
{
  "updateMask": {
    object (DocumentMask)
  },
  "updateTransforms": [
    {
      object (FieldTransform)
    }
  ],
  "currentDocument": {
    object (Precondition)
  },

  // Union field operation can be only one of the following:
  "update": {
    object (Document)
  },
  "delete": string,
  "transform": {
    object (DocumentTransform)
  }
  // End of list of possible types for union field operation.
}
Alanlar
updateMask

object (DocumentMask)

Bu yazmada güncellenecek alanlar.

Bu alan yalnızca update olduğunda ayarlanabilir. update için maske ayarlanmadıysa ve doküman mevcutsa mevcut tüm verilerin üzerine yazılır. Maske ayarlanırsa ve sunucudaki dokümanda maskenin kapsamadığı alanlar varsa bunlar değiştirilmeden bırakılır. Maskede başvurulan ancak giriş dokümanında bulunmayan alanlar sunucudaki dokümandan silinir. Bu maskedeki alan yolları, ayrılmış alan adı içermemelidir.
updateTransforms[]

object (FieldTransform)

Güncellemeden sonra gerçekleştirilecek dönüşümler.

Bu alan yalnızca update olduğunda ayarlanabilir. Varsa bu yazma işlemi, aynı belgede atomik ve sırayla update ve transform işlemi gerçekleştirmekle eşdeğerdir.
currentDocument

object (Precondition)

Dokümandaki isteğe bağlı bir ön koşul.

Bu ayar yapılırsa ve hedef doküman tarafından karşılanmazsa yazma başarısız olur.
Birleştirme alanı operation. Yürütülecek işlem. operation şunlardan yalnızca biri olabilir:
update

object (Document)

Yazılacak doküman.
delete

string

Silinecek doküman adı. Belirtilen biçimde: projects/{projectId}/databases/{databaseId}/documents/{document_path}.
transform

object (DocumentTransform)

Bir dokümana dönüşüm uygular.

Doküman Dönüşümü

Bir dokümanın dönüşümü.

JSON gösterimi 
{
  "document": string,
  "fieldTransforms": [
    {
      object (FieldTransform)
    }
  ]
}
Alanlar
document

string

Dönüştürülecek dokümanın adı.
fieldTransforms[]

object (FieldTransform)

Dokümanın alanlarına sırayla uygulanacak dönüşümlerin listesi. Bu alan boş bırakılamaz.

Alan Dönüşümü

Dokümandaki bir alanın dönüşümü.

JSON gösterimi 
{
  "fieldPath": string,

  // Union field transform_type can be only one of the following:
  "setToServerValue": enum (ServerValue),
  "increment": {
    object (Value)
  },
  "maximum": {
    object (Value)
  },
  "minimum": {
    object (Value)
  },
  "appendMissingElements": {
    object (ArrayValue)
  },
  "removeAllFromArray": {
    object (ArrayValue)
  }
  // End of list of possible types for union field transform_type.
}
Alanlar
fieldPath

string

Alanın yolu. Alan yolu söz dizimi referansı için Document.fields sayfasına bakın.
Birleştirme alanı transform_type. Alana uygulanacak dönüşüm. transform_type şunlardan yalnızca biri olabilir:
setToServerValue

enum (ServerValue)

Alanı, verilen sunucu değerine ayarlar.
increment

object (Value)

Verilen değeri alanın mevcut değerine ekler.

Bu, bir tam sayı veya çift değer olmalıdır. Alan tam sayı veya çift değilse ya da alan henüz mevcut değilse dönüştürme işlemi, alanı verilen değere ayarlar. Verilen değerden veya geçerli alan değerinden biri çift olursa her iki değer de çift olarak yorumlanır. Çift aritmetik ve çift değerlerin gösterimi IEEE 754 anlamında geçerlidir. Pozitif/negatif tam sayı taşması varsa alan, en büyük büyüklükteki pozitif/negatif tam sayıya çözümlenir.
maximum

object (Value)

Alanı, geçerli değerinin ve verilen değerin maksimum değerine ayarlar.

Bu, bir tam sayı veya çift değer olmalıdır. Alan tam sayı veya çift değilse ya da alan henüz mevcut değilse dönüştürme işlemi, alanı verilen değere ayarlar. Alan ve giriş değerinin karma türde olduğu (yani biri tam sayı, diğeri çift sayı olduğu) bir maksimum işlem uygulanırsa, alan daha büyük işlenenin türünü alır. İşlem görenler eşdeğerse (ör. 3 ve 3.0) alan değişmez. 0, 0,0 ve -0,0 değerlerinin tamamı sıfırdır. Sıfır depolanan değerin ve sıfır giriş değerinin maksimum değeri her zaman depolanan değerdir. x ve NaN sayısal değerlerinin maksimum değeri NaN'dir.
minimum

object (Value)

Alanı, geçerli değerinin ve verilen değerin minimum değerine ayarlar.

Bu, bir tam sayı veya çift değer olmalıdır. Alan tam sayı veya çift değilse ya da alan henüz mevcut değilse dönüştürme işlemi, alanı giriş değerine ayarlar. Alan ve giriş değerinin karma türde olduğu (yani biri tam sayı, diğeri çift sayı olduğu) minimum işlem uygulanırsa, alan daha küçük işlenenin türünü alır. İşlem görenler eşdeğerse (ör. 3 ve 3.0) alan değişmez. 0, 0,0 ve -0,0 değerlerinin tamamı sıfırdır. Sıfır saklanan değerin ve sıfır giriş değerinin minimum değeri her zaman depolanan değerdir. x ve NaN sayısal değerlerinin minimum değeri NaN'dir.
appendMissingElements

object (ArrayValue)

Geçerli alan değerinde zaten mevcut değillerse belirtilen öğeleri sırayla ekleyin. Alan bir dizi değilse veya alan henüz mevcut değilse önce boş diziye ayarlanır.

Bir değerin eksik olup olmadığı kontrol edilirken farklı türdeki eşdeğer sayıların (ör. 3L ve 3.0) eşit olduğu kabul edilir. NaN, NaN'ye eşittir. Boş değer ise Null'a eşittir. Giriş birden fazla eşdeğer değer içeriyorsa yalnızca ilki dikkate alınır.

Karşılık gelen transform_result, boş değer olur.
removeAllFromArray

object (ArrayValue)

Alandaki diziden belirtilen öğelerin tümünü kaldırın. Alan bir dizi değilse veya alan henüz mevcut değilse boş diziye ayarlanır.

Bir öğenin kaldırılıp kaldırılmayacağına karar verilirken farklı türlerin eşdeğer sayıları (ör. 3L ve 3,0) eşit kabul edilir. NaN, NaN'ye eşittir. Boş değer ise Null'a eşittir. Bu işlem, yinelenen öğeler varsa tüm eşdeğer değerleri kaldırır.

Karşılık gelen transform_result, boş değer olur.

Sunucu Değeri

Sunucu tarafından hesaplanan bir değerdir.

Sıralamalar
SERVER_VALUE_UNSPECIFIED Belirtilmedi. Bu değer kullanılmamalıdır.
REQUEST_TIME Sunucunun isteği milisaniyelik hassasiyetle işlediği zaman. Bir işlemde birden fazla alanda (aynı veya farklı dokümanlar) kullanılırsa tüm alanlara aynı sunucu zaman damgası gönderilir.