Method: presentations.batchUpdate

Áp dụng một hoặc nhiều nội dung cập nhật cho bản trình bày.

Mỗi request đều được xác thực trước khi áp dụng. Nếu có bất kỳ yêu cầu nào không hợp lệ, thì toàn bộ yêu cầu sẽ không thành công và sẽ không có yêu cầu nào được áp dụng.

Một số yêu cầu có replies để cung cấp cho bạn một số thông tin về cách áp dụng các yêu cầu đó. Các yêu cầu khác không cần trả lại thông tin; mỗi kết quả trả về một câu trả lời trống. Thứ tự của câu trả lời khớp với thứ tự của yêu cầu.

Ví dụ: giả sử bạn gọi BulkUpdate với 4 bản cập nhật và chỉ bản cập nhật thứ ba trả về thông tin. Phản hồi sẽ có hai phản hồi trống: phản hồi cho yêu cầu thứ ba và một phản hồi trống khác theo thứ tự đó.

Do những người dùng khác có thể đang chỉnh sửa bản trình bày, bản trình bày có thể không phản ánh chính xác các thay đổi của bạn: các thay đổi của bạn có thể thay đổi theo các thay đổi của cộng tác viên. Nếu không có cộng tác viên nào, bản trình bày sẽ phản ánh các thay đổi của bạn. Trong mọi trường hợp, các nội dung cập nhật trong yêu cầu của bạn đều được đảm bảo áp dụng thật tỉ mỉ.

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Tham số
presentationId

string

Bản trình bày để áp dụng nội dung cập nhật.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Trường
requests[]

object (Request)

Danh sách nội dung cập nhật để áp dụng cho bản trình bày.
writeControl

object (WriteControl)

Cho phép kiểm soát cách thực thi các yêu cầu ghi.

Nội dung phản hồi

Thư phản hồi từ bản cập nhật hàng loạt.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "presentationId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "writeControl": {
    object (WriteControl)
  }
}
Trường
presentationId

string

Bản trình bày đã áp dụng nội dung cập nhật.
replies[]

object (Response)

Câu trả lời về thông tin cập nhật. Thao tác này liên kết 1:1 với nội dung cập nhật, mặc dù thư trả lời cho một số yêu cầu có thể bị trống.
writeControl

object (WriteControl)

Chế độ điều khiển ghi được cập nhật sau khi áp dụng yêu cầu.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • 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

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.

WriteControl

Cho phép kiểm soát cách thực thi các yêu cầu ghi.

Biểu diễn dưới dạng JSON 
{
  "requiredRevisionId": string
}
Trường
requiredRevisionId

string

revision ID của bản trình bày cần thiết cho yêu cầu ghi. Nếu được chỉ định và mã bản sửa đổi được yêu cầu không khớp với mã bản sửa đổi hiện tại của bản trình bày thì yêu cầu đó sẽ không được xử lý và trả về lỗi yêu cầu không hợp lệ 400.

Khi một mã bản sửa đổi bắt buộc được trả về trong phản hồi, mã này sẽ cho biết mã bản sửa đổi của tài liệu sau khi áp dụng yêu cầu.