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ó yêu cầu không hợp lệ, thì toàn bộ yêu cầu sẽ không thành công và không có gì được áp dụng.

Một số yêu cầu có biểu tượng replies để cung cấp cho bạn 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ả về thông tin; mỗi yêu cầu này sẽ trả về một câu trả lời trống. Thứ tự của các câu trả lời khớp với thứ tự của các yêu cầu.

Ví dụ: giả sử bạn gọi batchUpdate 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ó 2 câu trả lời trống: câu trả lời cho yêu cầu thứ ba và một câu trả lời trống khác, theo thứ tự đó.

Vì những người dùng khác có thể đang chỉnh sửa bản trình bày, nên 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ể bị 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, bản trình bày sẽ phản ánh những 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 cùng nhau một cách nguyên tử.

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

Thông số
presentationId

string

Bản trình bày cần á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 với 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 các nội dung cập nhật cần áp dụng cho bản trình bày.
writeControl

object (WriteControl)

Cung cấp quyền kiểm soát cách thực hiện các yêu cầu ghi.

Nội dung phản hồi

Thông báo phản hồi từ một bản cập nhật theo lô.

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)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Trường
presentationId

string

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

object (Response)

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

object (WriteControl)

Quyền ghi đã cập nhật sau khi áp dụng yêu cầu.
commentUpdateState

enum (CommentUpdateState)

Liệu các nội dung cập nhật bình luận có được áp dụng trong yêu cầu hàng loạt hay không.

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

Cung cấp quyền kiểm soát cách thực hiện 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 bạn chỉ định và mã nhận dạng bản sửa đổi bắt buộc không khớp với mã nhận dạng 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 400 yêu cầu không hợp lệ.

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

CommentUpdateState

Trạng thái của các nội dung cập nhật bình luận trong yêu cầu hàng loạt.

Enum
COMMENT_UPDATE_STATE_UNSPECIFIED Trạng thái cập nhật bình luận là không xác định.
NO_UPDATES_REQUESTED Không có yêu cầu cập nhật bình luận nào trong yêu cầu hàng loạt.
ALL_SAVED Tất cả nội dung cập nhật bình luận theo yêu cầu đều đã được áp dụng trong yêu cầu hàng loạt.
ALL_FAILED_UNKNOWN_REASON Không cập nhật được tất cả bình luận theo yêu cầu.