Method: presentations.batchUpdate

Menerapkan satu atau beberapa update 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 sejumlah informasi tentang cara penerapannya. Permintaan lain tidak perlu menampilkan informasi; masing-masing mengembalikan jawaban kosong. Urutan balasan sesuai dengan permintaan.

Misalnya, Anda memanggil hdpi dengan empat update, dan hanya yang 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 sedang mengedit presentasi, presentasi mungkin tidak persis mencerminkan perubahan Anda: perubahan Anda mungkin berubah sehubungan dengan perubahan kolaborator. Jika tidak ada kolaborator, presentasi akan mencerminkan perubahan Anda. Bagaimanapun, pembaruan dalam permintaan Anda dijamin akan diterapkan bersama 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 update 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 dijalankan.

Isi respons

Pesan respons dari batch update.

Jika berhasil, isi respons memuat data dengan struktur berikut:

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

string

Presentasi tempat pembaruan diterapkan.
replies[]

object (Response)

Balasan atas pembaruan. Hal ini dipetakan 1:1 dengan pembaruan, 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 informasi selengkapnya, lihat Panduan otorisasi.

WriteControl

Memberikan kontrol atas cara permintaan tulis dijalankan.

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 buruk 400.

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