Method: spreadsheets.get

Trả về bảng tính có mã nhận dạng đã cho. Người gọi phải chỉ định mã bảng tính.

Theo mặc định, dữ liệu trong lưới không được trả về. Bạn có thể thêm dữ liệu lưới theo một trong 2 cách:

  • Chỉ định một mặt nạ trường liệt kê các trường bạn muốn bằng cách sử dụng tham số URL fields trong HTTP

  • Đặt tham số URL includeGridData thành true. Nếu bạn đặt một mặt nạ trường, thì tham số includeGridData sẽ bị bỏ qua

Đối với các bảng tính lớn, tốt nhất là bạn chỉ nên truy xuất những trường cụ thể mà bạn muốn trong bảng tính.

Để chỉ truy xuất các tập hợp con của dữ liệu trong bảng tính, hãy sử dụng tham số URL ranges. Bạn có thể chỉ định các dải ô bằng cách sử dụng ký hiệu A1. Bạn có thể xác định một ô (ví dụ: A1) hoặc nhiều ô (ví dụ: A1:D5). Bạn cũng có thể lấy các ô từ những trang tính khác trong cùng một bảng tính (ví dụ: Sheet2!A1:C4) hoặc truy xuất nhiều dải ô cùng một lúc (ví dụ: ?ranges=A1:D5&ranges=Sheet2!A1:C4). Việc giới hạn dải ô chỉ trả về những phần của bảng tính giao với các dải ô được yêu cầu.

Yêu cầu HTTP

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

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 yêu cầu.

Tham số truy vấn

Thông số
ranges[]

string

Các dải ô cần truy xuất từ bảng tính.
includeGridData

boolean

Giá trị true nếu dữ liệu lưới cần được trả về. 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.
excludeTablesInBandedRanges

boolean

True nếu bạn muốn loại trừ các bảng trong dải ô có màu. Sai nếu không được đặt.
commentsViewMode

enum (CommentsViewMode)

Chế độ xem bình luận sẽ áp dụng cho bảng tính. Nhờ đó, bạn có thể xem bảng tính có hoặc không có nhận xét. Nếu bạn không chỉ định một giá trị, hệ thống sẽ sử dụng COMMENTS_VIEW_MODE_OMITTED.

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

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của Spreadsheet.

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.