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

Do tính chất cộng tác của bảng tính, chúng tôi không đả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 quá trình này hoàn tất, nhưng chúng tôi đảm bảo rằng các cập nhật trong yêu cầu sẽ được áp dụng cùng nhau một cách tỉ mỉ. Nội dung thay đổi của bạn có thể được điều chỉnh tương ứng với những 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 các 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 có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "requests": [
    {
      object (Request)
    }
  ],
  "includeSpreadsheetInResponse": boolean,
  "responseRanges": [
    string
  ],
  "responseIncludeGridData": boolean
}
Trường
requests[]

object (Request)

Danh sách nội dung cập nhật để áp dụng cho bảng tính. Các yêu cầu sẽ được áp dụng theo thứ tự đã chỉ định. Nếu có bất kỳ yêu cầu nào không hợp lệ, sẽ không có 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ó cần bao gồm tài nguyên bảng tính hay không.
responseRanges[]

string

Giới hạn các phạm vi trong bảng tính câu trả lời. Chỉ có ý nghĩa khi giá trị includeSpreadsheetInResponse là "true".
responseIncludeGridData

boolean

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

Nội dung phản hồi

Câu trả lời cho việc cập nhật hàng loạt mộ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)
  }
}
Trường
spreadsheetId

string

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

object (Response)

Nội dung trả lời của nội dung cập nhật. Bản đồ này sẽ liên kết 1:1 với các bản cập nhật, mặc dù thư 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ập nhật. Giá trị này chỉ được thiết lập nếu BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response là true.

Phạm vi uỷ quyền

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

  • 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 bài viết Hướng dẫn uỷ quyền.