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 đượ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 được thực hiện 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 đó. Các thư trả lời sẽ phản ánh 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 nội dung trả lời, thì nội dung phản hồi sẽ có 2 nội dung trả lời trống, nội dung trả lời thực tế và một nội dung trả lời trống khác, theo thứ tự đó.

Do bản 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, chúng tôi đả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 vẹn. Nội dung thay đổi của bạn có thể bị thay đổi theo nội dung 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 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 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 cần á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 nào không hợp lệ, thì hệ thống sẽ không áp dụng yêu cầu nào.
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 dải ô có trong bảng tính phản hồi. Chỉ có ý nghĩa nếu includeSpreadsheetInResponse là "true".
responseIncludeGridData

boolean

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

Nội dung phản hồi

Nội dung trả lời để 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)
  }
}
Trường
spreadsheetId

string

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

object (Response)

Nội dung trả lời về nội dung cập nhật. Việc này sẽ liên kết 1:1 với nội dung 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 bản cập nhật. Bạn chỉ có thể đặt giá trị này 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.