Google Trang tính 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. Sau đây là những cách phổ biến nhất để sử dụng API này: nhiệm vụ:
- 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ý các trang tính liên kết
Sau đây là danh sách các thuật ngữ phổ biến được sử dụng trong API này:
- Bảng tính
Đối tượng chính trong Google Trang tính có thể chứa nhiều trang tính, mỗi trang tính với thông tin có cấu trúc nằm trong các ô.
Spreadsheettài nguyên đại diện cho mỗi và có một tham số duy nhấtspreadsheetId, có chứa chữ cái, số, dấu gạch nối hoặc dấu gạch dưới. Bạn có thể tìm thấy mã bảng tính trong URL Google Trang tính:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0- Trang tính
Trang hoặc thẻ trong bảng tính.
Sheettài nguyên đại diện cho mỗi và có tiêu đề cũng như số duy nhấtsheetId. Bạn có thể tìm thấy mã trang tính trong URL Google Trang tính:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId- Ô
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 và có thể được nhóm lại thành một dải ô.
CellDatatài nguyên đại diện cho mỗi nhưng không có giá trị mã nhận dạng duy nhất. Thay vào đó, hàng và cột xác định toạ độ của 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. Đây là phương pháp phổ biến và hữu ích nhất khi tham chiếu dải ô tuyệt đối.
Hiện ví dụ
Sheet1!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 1.Sheet1!A:Atham chiếu đến tất cả các ô trong cột đầu tiên của Trang tính 1.Sheet1!1:2tham chiếu đế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 ô trong 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 hiển thị đầu tiên.Sheet1tham chiếu đến tất cả các ô trong Sheet1.'Jon's_Data'!A1:D5tham 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:Atham chiếu đến tất cả các ô trong cột đầu tiên của 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ắt buộc phải có dấu ngoặc đơn đối với tên trang tính có dấu cách, 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 đề cập đến ô A1 trong trang tính hiển thị đầu tiên, trong khi
A1đề cập đến tất cả các ô trong trang tính có tên là "A1". Tương tự,Sheet1tham chiếu đến tất cả các ô trong Trang tính 1. 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 ô liên quan đến một dải ô vị trí của ô.
Hiện ví dụ
Sheet1!R1C1:R2C2tham chiếu đế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 ô có 3 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 tùy chỉnh để đơn giản hóa
xuyên suốt ứng dụng.
FilterViewtài nguyên đạ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. Đáp
ProtectedRangetài nguyên đại diện cho một dải ô được bảo vệ.
Chủ đề có liên quan
Để tìm hiểu về cách phát triển bằng API của Google Workspace, bao gồm cả cách xử lý xác thực và uỷ quyền, hãy tham khảo phần Phát triển trên Google Workspace.
Để tìm hiểu cách định cấu hình và chạy ứng dụng API Trang tính, hãy đọc Tổng quan nhanh.