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
Dưới đây là danh sách các thuật ngữ phổ biến được dùng trong API Trang tính:
- 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 ô. Đáp Tài nguyên trong bảng tính đại diện cho mọi bảng tính và có giá trị
spreadsheetIdduy nhất, 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. Đáp Tài nguyên trang tính đại diện cho từng trang tính và có tiêu đề và số duy nhất Giá trị
sheetId. 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 ô. Đáp Tài nguyên CellData đại diện cho từng ô, nhưng nó không có giá trị ID duy nhất. Thay vào đó, hàng và toạ độ cột 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. Đâ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:B2tham chiếu đến hai ô đầu tiên trong hai hàng trên cùng 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 hai ô đầu tiên trong hai hàng trên cùng của trang tính hiển thị đầu tiên.Sheet1tham chiếu đến tất cả các ô trong Sheet1.'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". 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ố.'My Custom Sheet'tham chiếu đến tất cả các ô trong "Trang tính tuỳ chỉnh của tôi".
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" tham chiếu đến tất cả các ô trong trang tính có tên A1. Tương tự, Sheet1 tham chiếu đến tất cả các ô trong Sheet1. Tuy nhiên, nếu có một dải ô được đặt tên là "Sheet1", thì Sheet1 đó chính là dải ô được đặt tên và "Sheet1" tham chiếu đế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 so với ký hiệu A1, nhưng có thể hữu ích khi tham chiếu một dải ô tương ứng với một ô nhất định vị trí.
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 tuỳ chỉnh để đơn giản hoá xuyên suốt ứng dụng. Đáp 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. Đáp Tài nguyên Protected Range đại diện cho một dải ô được bảo vệ.
Các bước tiếp theo
Để 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át triển trên Google Workspace.
Để tìm hiểu cách định cấu hình và chạy một ứng dụng API Trang tính đơn giản, hãy đọc Tổng quan nhanh.