Tổng quan về API Google Trang tính

API Google Trang tính là một giao diện RESTful cho phép bạn đọc và sửa đổi dữ liệu của bảng tính. API Trang tính cho phép bạn:

  • Tạo bảng tính
  • Đọc và ghi giá trị của các ô trong bảng tính
  • Cập nhật định dạng bảng tính
  • Quản lý Trang tính được liên kết

Sau đây là danh sách các thuật ngữ thường dùng trong API Trang tính:

Bảng tính

Đối tượng chính trong Google Trang tính. Tệp này có thể chứa nhiều Sheets, mỗi Sheets có thông tin có cấu trúc nằm trong Cells. Tài nguyên spreadsheets đại diện cho một bảng tính. Tệp này chứa một giá trị spreadsheetId duy nhất.

Mã bảng tính
Giá trị nhận dạng duy nhất của một bảng tính. Đây là một chuỗi cụ thể chứa chữ cái, số và một số ký tự đặc biệt tham chiếu đến một bảng tính. Chuỗi này có thể được lấy từ URL của bảng tính. Mã nhận dạng bảng tính luôn ổn định, ngay cả khi tên bảng tính thay đổi.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Trang tính

Trang hoặc thẻ trong bảng tính. Tài nguyên Sheets đại diện cho một trang tính. Nó chứa một giá trị sheetId dạng số duy nhất và trang tính title trong đối tượng SheetProperties.

Mã trang tính
Mã nhận dạng duy nhất của một trang tính cụ thể trong bảng tính. Đây là một chuỗi cụ thể chứa chữ cái, số và một số ký tự đặc biệt tham chiếu đến một trang tính và có thể được lấy từ URL của trang tính. Mã trang tính luôn ổn định, ngay cả khi tên trang tính thay đổi. Để biết ví dụ, hãy xem phần Mã bảng tính.
Ô

Một trường văn bản hoặc dữ liệu riêng lẻ trong một trang tính. Các ô được sắp xếp theo hàng và cột, đồng thời có thể được nhóm thành một dải ô. Tài nguyên Cells đại diện cho từng ô, nhưng không có giá trị mã nhận dạng duy nhất. Thay vào đó, toạ độ của hàng và cột sẽ xác định các ô.

Ký hiệu A1
Cú pháp dùng để xác định một ô hoặc dải ô bằng một chuỗi chứa tên trang tính cùng với toạ độ ô bắt đầu và kết thúc bằng cách sử dụng chữ cái cột và số hàng. Phương thức này là phổ biến và hữu ích nhất khi tham chiếu một dải ô tuyệt đối.

Hiện ví dụ

  • Sheet1!A1:B2 tham chiếu đến tất cả các ô trong hai hàng và cột đầu tiên của Trang tính 1.
  • Sheet1!A:A tham chiếu đến tất cả các ô trong cột đầu tiên của Trang tính 1.
  • Sheet1!1:2 đề cập đến tất cả các ô trong hai hàng đầu tiên của Trang tính 1.
  • Sheet1!A5:A bao gồm tất cả các ô trong cột đầu tiên của Trang tính 1, từ hàng 5 trở đi.
  • A1:B2 tham chiếu đến tất cả các ô trong hai hàng và cột đầu tiên của trang tính hiển thị đầu tiên.
  • Sheet1 tham chiếu đến tất cả các ô trong Trang tính 1.
  • 'Jon's_Data'!A1:D5 tham chiếu đến tất cả các ô trong năm hàng và bốn cột đầu tiên của trang tính có tên là "Jon's_Data".
  • 'My Custom Sheet'!A:A tham chiếu đến tất cả các ô trong cột đầu tiên của một trang tính có tên là "Trang tính tuỳ chỉnh của tôi".
  • 'My Custom Sheet' tham chiếu đến tất cả các ô trong "Trang tính tuỳ chỉnh của tôi".

Bạn phải dùng dấu ngoặc đơn đơn cho tên trang tính có khoảng trắng, ký tự đặc biệt hoặc tổ hợp chữ và số.

Mẹo: Nếu có thể, hãy sử dụng tên riêng biệt cho các đối tượng trong bảng tính. Ví dụ: A1 (không có dấu ngoặc kép) tham chiếu đến ô A1 trong trang tính hiển thị đầu tiên. 'A1' tham chiếu đến một trang tính có tên A1. Tương tự, Sheet1 tham chiếu đến một trang tính có tên là Sheet1. Tuy nhiên, nếu có một dải ô được đặt tên là "Trang tính1", thì Trang tính 1 đề cập đến dải ô được đặt tên và 'Sheet1' đề cập đến trang tính.
Ký hiệu R1C1
Cú pháp dùng để xác định một ô hoặc dải ô bằng một chuỗi chứa tên trang tính cùng với toạ độ ô bắt đầu và kết thúc bằng cách sử dụng số hàng và số cột. Phương thức này ít phổ biến hơn ký hiệu A1, nhưng có thể hữu ích khi tham chiếu một dải ô so với vị trí của một ô nhất định.

Hiện ví dụ

  • Sheet1!R1C1:R2C2 đề cập đến hai ô đầu tiên trong hai hàng trên cùng của Trang tính 1.
  • R1C1:R2C2 đề cập đến hai ô đầu tiên trong hai hàng trên cùng của trang tính hiển thị đầu tiên.
  • Sheet1!R[3]C[1] đề cập đến ô nằm ở ba hàng bên dưới và một cột bên phải ô hiện tại.
Dải ô được đặt tên
Một ô hoặc dải ô đã xác định có tên tuỳ chỉnh để đơn giản hoá các tệp tham chiếu trong toàn bộ một ứng dụng. Tài nguyên FilterView đại diện cho một dải ô được đặt tên.
Dải ô được bảo vệ
Một ô hoặc dải ô đã xác định không thể sửa đổi được. Tài nguyên ProtectedRange đại diện cho một dải ô được bảo vệ.