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 lainnya tidak perlu menampilkan informasi; setiap permintaan ini menampilkan respons kosong. Urutan balasan sesuai 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 dapat mengedit presentasi, presentasi mungkin tidak mencerminkan perubahan Anda secara persis: perubahan Anda dapat diubah sehubungan dengan perubahan kolaborator. Jika tidak ada kolaborator, presentasi akan mencerminkan perubahan Anda. Bagaimanapun juga, pembaruan dalam permintaan Anda dijamin akan diterapkan bersama secara atomik.

Permintaan HTTP

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

URL ini menggunakan sintaksis gRPC Transcoding.

Parameter jalur

Parameter
presentationId

string

Presentasi yang akan menerapkan update.

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 pada presentasi.
writeControl

object (WriteControl)

Memberikan kontrol atas cara eksekusi permintaan tulis.

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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Kolom
presentationId

string

Presentasi tempat pembaruan diterapkan.
replies[]

object (Response)

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

object (WriteControl)

Kontrol penulisan yang diperbarui setelah menerapkan permintaan.
commentUpdateState

enum (CommentUpdateState)

Apakah pembaruan komentar diterapkan dalam permintaan batch.

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 penulisan 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 saat ini presentasi, permintaan tidak diproses dan menampilkan error permintaan buruk 400.

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

CommentUpdateState

Status pembaruan komentar dalam permintaan batch.

Enum
COMMENT_UPDATE_STATE_UNSPECIFIED Status pembaruan komentar tidak ditentukan.
NO_UPDATES_REQUESTED Tidak ada pembaruan komentar yang diminta dalam permintaan batch.
ALL_SAVED Semua pembaruan komentar yang diminta diterapkan dalam permintaan batch.
ALL_FAILED_UNKNOWN_REASON Semua pembaruan komentar yang diminta gagal.