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 memberikan beberapa informasi tentang cara penerapannya. Permintaan lain tidak perlu menampilkan informasi; masing-masing menampilkan balasan kosong. Urutan balasan sesuai dengan urutan permintaan.

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

Karena pengguna lain mungkin sedang mengedit presentasi, presentasi mungkin tidak mencerminkan perubahan Anda secara tepat: perubahan tersebut dapat berubah sesuai dengan perubahan kolaborator. Jika tidak ada kolaborator, presentasi harus mencerminkan perubahan Anda. Apa pun kasusnya, pembaruan dalam permintaan Anda dijamin akan diterapkan secara atomis.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
presentationId

string

Presentasi yang akan diterapkan pembaruan.

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 dijalankan.

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 pembaruan yang diterapkan.
replies[]

object (Response)

Balasan pembaruan. 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.

TulisKontrol

Memberikan kontrol atas cara permintaan tulis dijalankan.

Representasi JSON 
{
  "requiredRevisionId": string
}
Kolom
requiredRevisionId

string

revision ID presentasi 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 buruk 400.

Jika ID revisi yang diperlukan ditampilkan sebagai respons, hal ini menunjukkan ID revisi dokumen setelah permintaan diterapkan.