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

Google Sheets API 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 các giá trị trong ô của bảng tính
  • Cập nhật định dạng bảng tính
  • Quản lý Trang tính 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. Nguồn cấp dữ liệu này có thể chứa nhiều Sheets, mỗi Sheets có thông tin có cấu trúc trong Cells. Tài nguyên spreadsheets biểu thị một bảng tính. Nó chứa một giá trị spreadsheetId duy nhất.

Mã bảng tính
Giá trị nhận dạng riêng biệt của một bảng tính. Đây là một chuỗi cụ thể chứa các chữ cái, chữ số và một số ký tự đặc biệt tham chiếu đến một bảng tính và có thể được lấy từ URL của bảng tính đó. Mã nhận dạng bảng tính có tính ổ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

Một 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 bằng số duy nhất và trang tính title trong đối tượng SheetProperties.

Mã trang tính
Giá trị nhận dạng duy nhất của một trang cụ thể trong bảng tính. Đây là một số nguyên cụ thể chứa các số tham chiếu đến một trang tính và có thể được lấy từ URL của bảng tính. Mã trang tính có tính ổ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ạ độ 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 chữ cái cột và số hàng. Đây là phương thức phổ biến và hữu ích nhất khi tham chiếu đến một dải ô tuyệt đối.
  • Sheet1!A1:B2 đề cập đến tất cả các ô trong 2 hàng và cột đầu tiên của Trang tính 1.
  • Sheet1!A:A đề cập đế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 đề cập đến tất cả các ô của cột đầu tiên của Trang tính 1, từ hàng 5 trở đi.
  • A1:B2 đề cập đến tất cả các ô trong hai hàng và cột đầu tiên của trang tính đầu tiên có thể nhìn thấy.
  • Sheet1 đề cập đến tất cả các ô trong Trang tính 1.
  • 'Jon's_Data'!A1:D5 đề cập đến tất cả các ô trong 5 hàng và 4 cột đầu tiên của một trang tính có tên là "Jon's_Data".
  • 'My Custom Sheet'!A:A đề cập đế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' đề cập đế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 nháy đơn cho tên trang có dấu cách hoặc ký tự đặc biệt.

Lưu ý: 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) là ô A1 trong trang tính đầu tiên mà bạn nhìn thấy. 'A1' đề cập đến một trang tính có tên A1. Tương tự, Sheet1 đề cập đế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ính 1", thì Trang tính 1 sẽ đề cập đến dải ô được đặt tên và 'Sheet1' sẽ đề 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 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 đến một dải ô tương ứng với vị trí của một ô nhất định.
  • 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 2 ô đầu tiên trong 2 hàng trên cùng của trang tính đầu tiên mà người dùng nhìn thấy.
  • Sheet1!R[3]C[1] là ô nằm dưới ô hiện tại 3 hàng và bên phải 1 cột.
Dải ô được đặt tên
Một ô hoặc dải ô được xác định có tên tuỳ chỉnh để đơn giản hoá các tham chiếu trong toàn bộ ứng dụng. Tài nguyên FilterView đại diện cho một dải ô có tên.
Dải ô được bảo vệ
Một ô hoặc dải ô được xác định mà bạn không thể sửa đổi. Tài nguyên ProtectedRange biểu thị một dải ô được bảo vệ.