Method: spreadsheets.batchUpdate

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

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 câu trả lời sẽ phản ánh các yêu cầu. Ví dụ: nếu bạn áp dụng 4 bản cập nhật và bản cập nhật thứ 3 có một câu trả lời, thì phản hồi sẽ có 2 câu trả lời trống, câu trả lời thực tế và một câu trả lời trống khác, theo thứ tự đó.

Do tính chất cộng tác của bảng tính, nên không có gì đảm bảo rằng bảng tính sẽ phản ánh chính xác các thay đổi của bạn sau khi hoàn tất. Tuy nhiên, có thể đảm bảo rằng các nội dung cập nhật trong yêu cầu sẽ được áp dụng cùng nhau một cách nguyên tử. 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ảng tính sẽ phản ánh những thay đổi của bạn.

Yêu cầu HTTP

POST https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:batchUpdate

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

Tham số đường dẫn

Thông số
spreadsheetId

string

Bảng tính để á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)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean,
  "commentsViewMode": enum (CommentsViewMode)
}
Trường
requests[]

object (Request)

Danh sách các nội dung cập nhật cần áp dụng cho bảng tính. Các yêu cầu sẽ được áp dụng theo thứ tự mà bạn chỉ định. Nếu có yêu cầu không hợp lệ, thì không yêu cầu nào được áp dụng.
includeSpreadsheetInResponse

boolean

Xác định xem phản hồi cập nhật có nên bao gồm tài nguyên bảng tính hay không.
responseRanges[]

string

Giới hạn các dải ô có trong bảng tính phản hồi. Chỉ có ý nghĩa nếu includeSpreadsheetInResponse là "true".
responseIncludeGridData

boolean

Giá trị true nếu dữ liệu lưới cần được trả về. Chỉ có ý nghĩa nếu includeSpreadsheetInResponse là "true". Tham số này sẽ bị bỏ qua nếu bạn đặt một mặt nạ trường trong yêu cầu.
commentsViewMode

enum (CommentsViewMode)

Chế độ xem bình luận sẽ áp dụng cho bảng tính. Nhờ đó, bạn có thể xem bảng tính có hoặc không có nhận xét. Nếu bạn không chỉ định một giá trị, hệ thống sẽ sử dụng COMMENTS_VIEW_MODE_OMITTED. Chỉ có ý nghĩa nếu includeSpreadsheetInResponse là "true".

Nội dung phản hồi

Phản hồi cho việc cập nhật hàng loạt bảng tính.

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 
{
  "spreadsheetId": string,
  "replies": [
    {
      object (Response)
    }
  ],
  "updatedSpreadsheet": {
    object (Spreadsheet)
  },
  "commentUpdateState": enum (CommentUpdateState)
}
Trường
spreadsheetId

string

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

object (Response)

Phản hồi đối với thông tin 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.
updatedSpreadsheet

object (Spreadsheet)

Bảng tính sau khi áp dụng các nội dung cập nhật. Bạn chỉ đặt thuộc tính này nếu BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response là true.
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/spreadsheets

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

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 Chưa xác định được trạng thái cập nhật bình luận.
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.