Halaman ini diterjemahkan oleh Cloud Translation API.
Switch to English

Metode: projects.databases.documents.commit

Melakukan transaksi, sementara secara opsional memperbarui dokumen.

Permintaan HTTP

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

URL menggunakan sintaks Transkoding gRPC .

Parameter jalur

Parameter
database

string

Yg dibutuhkan. Nama basis data. Dalam format: projects/{project_id}/databases/{database_id} .

Minta badan

Badan permintaan berisi data dengan struktur berikut:

Representasi JSON
 {
  "writes" :  [
    {
      object ( Write )
    }
  ] ,
  "transaction" :  string
} 
Bidang
writes[]

object ( Write )

Menulis untuk diterapkan.

Selalu dieksekusi secara atom dan teratur.

transaction

string ( bytes format)

Jika diatur, terapkan semua penulisan dalam transaksi ini, dan lakukanlah.

String yang dikodekan base64.

Respon tubuh

Jika berhasil, badan respons berisi data dengan struktur berikut:

Tanggapan untuk Firestore.Commit .

Representasi JSON
 {
  "writeResults" :  [
    {
      object ( WriteResult )
    }
  ] ,
  "commitTime" :  string
} 
Bidang
writeResults[]

object ( WriteResult )

Hasil penerapan menulis.

Hasil penulisan ke-i ini sesuai dengan penulisan ke-i dalam permintaan.

commitTime

string ( Timestamp format)

Waktu di mana komit terjadi. Setiap bacaan dengan readTime sama atau lebih besar dijamin untuk melihat efek dari komit.

Stempel waktu dalam format "Zulu" UTC RFC3339, dengan resolusi nanodetik dan hingga sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z" .

Lingkup Otorisasi

Membutuhkan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Untuk informasi lebih lanjut, lihat Ikhtisar Otentikasi .