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 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à 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 yêu cầu. Các phản hồi sẽ phản ánh 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ứ ba có câu trả lời, thì câu trả lời sẽ có 2 câu trả lời trống, câu trả lời thực 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, 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, tuy nhiên, điều đó đảm bảo rằng các cập nhật trong yêu cầu sẽ được áp dụng cùng nhau về mặt nguyên tử. Thay đổi của bạn có thể được thay đổi theo những 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

Các tham số
spreadsheetId

string

Bảng tính để áp dụng bản 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 như sau:

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

object (Request)

Danh sách các nội dung cập nhật sẽ á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ó bất kỳ yêu cầu nào không hợp lệ thì 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ó 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 phản hồ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 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.

Nội dung phản hồi

Trả lờ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)
  }
}
Các trường
spreadsheetId

string

Bảng tính đã áp dụng bản cập nhật.
replies[]

object (Response)

Phản hồi về nội dung cập nhật. Thao tác này sẽ ánh xạ 1:1 với nội dung cập nhật, mặc dù các 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 cập nhật đã được áp dụng. Bạn chỉ đặt trường này nếu BatchUpdateSpreadsheetRequest.include_spreadsheet_in_response là true.

Phạm vi ủy 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 ủy quyền.