Method: projects.databases.documents.commit

İsteğe bağlı olarak belgeleri güncellerken bir işlem gerçekleştirir.

HTTP isteği

POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
database

string

Zorunlu. Veritabanı adı. Belirtilen biçimde: projects/{projectId}/databases/{databaseId}.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
Alanlar
writes[]

object (Write)

Uygulanacak yazma işlemleri.

Her zaman atomik ve sıralı bir şekilde yürütülür.

transaction

string (bytes format)

Ayarlanırsa bu işlemdeki tüm yazmaları uygular ve kaydeder.

base64 kodlu bir dize.

Yanıt gövdesi

Firestore.Commit için yanıt.

Başarılı olursa yanıt gövdesi aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
Alanlar
writeResults[]

object (WriteResult)

Yazma işlemlerinin uygulanmasının sonucu.

Bu i-'inci yazma sonucu, istekteki i'inci yazmaya karşılık gelir.

commitTime

string (Timestamp format)

Kaydetmenin gerçekleştiği zaman. readTime değerine eşit veya daha yüksek olan tüm okumalar, kaydetmenin etkilerini görecektir.

RFC3339 UTC "Zulu" biçiminde, nanosaniye çözünürlüğüne ve en fazla dokuz kesirli basamağa sahip bir zaman damgası. Örnekler: "2014-10-02T15:01:23Z" ve "2014-10-02T15:01:23.045123456Z".

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ış başlıklı makaleye bakın.