Method: presentations.batchUpdate

Menerapkan satu atau beberapa pembaruan pada presentasi.

Setiap request divalidasi sebelum diterapkan. Jika ada permintaan yang tidak valid, seluruh permintaan akan gagal dan tidak ada yang akan diterapkan.

Beberapa permintaan memiliki replies untuk memberi Anda beberapa informasi tentang cara penerapannya. Permintaan lain tidak perlu menampilkan informasi; setiap permintaan ini menampilkan balasan kosong. Urutan balasan cocok dengan urutan permintaan.

Misalnya, Anda memanggil batchUpdate dengan empat pembaruan, dan hanya pembaruan ketiga yang menampilkan informasi. Respons akan memiliki dua balasan kosong: balasan untuk permintaan ketiga, dan balasan kosong lainnya, dalam urutan tersebut.

Karena pengguna lain mungkin mengedit presentasi, presentasi mungkin tidak mencerminkan perubahan Anda secara akurat: perubahan Anda mungkin diubah sehubungan dengan perubahan kolaborator. Jika tidak ada kolaborator, presentasi akan mencerminkan perubahan Anda. Apa pun kasusnya, pembaruan dalam permintaan Anda dijamin akan diterapkan secara bersamaan secara atomik.

Permintaan HTTP

POST https://slides.googleapis.com/v1/presentations/{presentationId}:batchUpdate

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
presentationId

string

Presentasi tempat pembaruan akan diterapkan.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Kolom
requests[]

object (Request)

Daftar pembaruan yang akan diterapkan ke presentasi.
writeControl

object (WriteControl)

Memberikan kontrol atas cara permintaan tulis dieksekusi.

Isi respons

Pesan respons dari update batch.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Kolom
presentationId

string

Presentasi tempat update diterapkan.
replies[]

object (Response)

Balasan pembaruan. Hal ini dipetakan 1:1 dengan update, meskipun balasan untuk beberapa permintaan mungkin kosong.
writeControl

object (WriteControl)

Kontrol tulis yang diperbarui setelah menerapkan permintaan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/presentations
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.

WriteControl

Memberikan kontrol atas cara permintaan tulis dieksekusi.

Representasi JSON 
{
  "requiredRevisionId": string
}
Kolom
requiredRevisionId

string

revision ID presentasi yang diperlukan untuk permintaan tulis. Jika ditentukan dan ID revisi yang diperlukan tidak cocok dengan ID revisi presentasi saat ini, permintaan tidak akan diproses dan menampilkan error permintaan tidak valid 400.

Jika ID revisi yang diperlukan ditampilkan dalam respons, ID tersebut menunjukkan ID revisi dokumen setelah permintaan diterapkan.