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ó 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 đó. Thư trả lời sẽ đồng bộ hoá các 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ó một 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 sự và một thư 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, chúng tôi không thể đảm bảo rằng bảng tính sẽ phản ánh chính xác những thay đổi của bạn sau khi quá trình này hoàn tất. Tuy nhiên, chúng tôi đảm bảo rằng các bản cập nhật trong yêu cầu sẽ được áp dụng đồng nhất một cách tỉ mỉ. Thay đổi của bạn có thể thay đổi theo thay đổi của cộng tác viên. Nếu không có cộng tác viên nào, 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ự được chỉ định. Nếu có yêu cầu 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ủa bản 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 có trong bảng tính câu trả lời. Chỉ có nghĩa nếu includeSpreadsheetInResponse là "true".
responseIncludeGridData

boolean

Đúng nếu trả về dữ liệu lưới. Chỉ có ý nghĩa khi 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.

Nội dung phản hồi

Câu trả lời cho yêu cầu cập nhật hàng loạt trong 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)

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.
updatedSpreadsheet

object (Spreadsheet)

Bảng tính sau khi áp dụng nội dung cập nhật. Chế độ 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:

  • 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.