Mẫu

Phần này trình bày một lớp học lập trình mà bạn có thể sử dụng để làm quen với API Google Trang tính. Ngoài ra, chúng tôi cũng cung cấp một bộ ví dụ về "công thức" minh hoạ cách chuyển đổi một thao tác dự định trên Google Trang tính thành một yêu cầu API.

Thông thường, có nhiều cách để hoàn thành một nhiệm vụ nhất định bằng API. Khi bạn quyết định cách tiếp cận một nhiệm vụ, hãy lưu ý những điều sau:

  • Nếu bạn cần đọc hoặc ghi giá trị ô, thì bộ sưu tập spreadsheets.values sẽ là lựa chọn tốt hơn so với bộ sưu tập spreadsheets. Giao diện của lớp trước dễ sử dụng hơn cho các thao tác đọc/ghi đơn giản.

  • Bất cứ khi nào có thể, hãy sử dụng các phương thức theo lô (spreadsheet.batchUpdate, spreadsheet.values.batchGet và spreadsheet.values.batchUpdate) để gói nhiều yêu cầu vào một lệnh gọi phương thức. Việc sử dụng các phương thức xử lý hàng loạt này sẽ cải thiện hiệu quả vì các phương thức này:

    • Giảm mức hao tổn HTTP của ứng dụng.
    • Giảm số lượng truy vấn được thực hiện.
    • Giảm số lần sửa đổi trên tài liệu.
    • Đảm bảo tính nguyên tử của tất cả thay đổi trong lô.

Công thức nấu ăn

Các ví dụ được liệt kê trong phần này minh hoạ cách thể hiện các thao tác phổ biến trong Trang tính dưới dạng yêu cầu Sheets API v4.

Các ví dụ này được trình bày dưới dạng yêu cầu HTTP để không phân biệt ngôn ngữ. Để tìm hiểu cách triển khai giao thức yêu cầu API Trang tính bằng một ngôn ngữ cụ thể thông qua thư viện ứng dụng API của Google, hãy xem hướng dẫn Đọc và ghi giá trị ô và Cập nhật bảng tính.

Các công thức nấu ăn trong phần này được chia thành các danh mục sau:

  • Đọc cơ bản – Công thức cho biết cách đọc giá trị từ một trang tính.
  • Ghi cơ bản – Công thức cho biết cách ghi giá trị vào một trang tính.
  • Định dạng cơ bản – Công thức cho biết cách thay đổi giao diện của trang tính và ô.
  • Biểu đồ – Công thức cho biết cách tạo và thay đổi biểu đồ trong một trang tính.
  • Định dạng có điều kiện – Công thức cho biết cách thay đổi giao diện của ô dựa trên các điều kiện.
  • Thao tác dữ liệu – Công thức cho biết cách tạo, di chuyển và thao tác với dữ liệu trong bảng tính.
  • Dải ô được đặt tên và bảo vệ – Công thức cho biết cách tạo, cập nhật và xoá dải ô được đặt tên và bảo vệ trong trang tính.
  • Bảng tổng hợp – Công thức cho biết cách tạo bảng tổng hợp trong một trang tính.
  • Thao tác với hàng và cột – Công thức cho biết cách thêm, xoá và di chuyển hàng và cột, cũng như cập nhật thuộc tính của các hàng và cột đó.
  • Thao tác trên trang tính – Công thức cho biết cách tạo, xoá, sao chép và xoá trang tính, đồng thời kiểm soát các thuộc tính của trang tính.