Method: spreadsheets.values.batchGet

Trả về một hoặc nhiều dải ô chứa giá trị từ một bảng tính. Phương thức gọi phải chỉ định mã nhận dạng bảng tính và một hoặc nhiều dải ô.

Yêu cầu HTTP

GET https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

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

Tham số đường dẫn

Thông số
spreadsheetId

string

Mã của bảng tính để truy xuất dữ liệu.

Tham số truy vấn

Thông số
ranges[]

string

Ký hiệu A1 hoặc ký hiệu R1C1 của dải ô để truy xuất giá trị.
majorDimension

enum (Dimension)

Phương diện chính mà kết quả sẽ sử dụng.

Ví dụ: nếu dữ liệu bảng tính là: A1=1,B1=2,A2=3,B2=4, thì việc yêu cầu ranges=["A1:B2"],majorDimension=ROWS sẽ trả về [[1,2],[3,4]], trong khi yêu cầu ranges=["A1:B2"],majorDimension=COLUMNS sẽ trả về [[1,3],[2,4]].
valueRenderOption

enum (ValueRenderOption)

Cách trình bày các giá trị trong kết quả. Tuỳ chọn kết xuất mặc định là ValueRenderOption.FORMATTED_VALUE.
dateTimeRenderOption

enum (DateTimeRenderOption)

Cách trình bày ngày, giờ và thời lượng trong kết quả. Giá trị này sẽ bị bỏ qua nếu valueRenderOption là FORMATTED_VALUE. Tuỳ chọn hiển thị dateTime mặc định là SERIAL_NUMBER.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Phản hồi khi truy xuất nhiều dải ô giá trị 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,
  "valueRanges": [
    {
      object (ValueRange)
    }
  ]
}
Trường
spreadsheetId

string

Mã nhận dạng của bảng tính mà dữ liệu được truy xuất.
valueRanges[]

object (ValueRange)

Các giá trị được yêu cầu. Thứ tự của ValueRanges giống với thứ tự của các dải ô được yêu cầu.

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.readonly
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/spreadsheets
  • https://www.googleapis.com/auth/spreadsheets.readonly

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