Mẫu

Phần này giới thiệu một codelab mà bạn có thể sử dụng để làm quen với Google Sheets API. 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ự kiến trên Google Trang tính thành một yêu cầu API.

Thường thì có nhiều cách để hoàn thành một tác 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 phù hợp hơn so với bộ sưu tập spreadsheets. Giao diện của phương thức 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) để kết hợp nhiều yêu cầu thành một lệnh gọi phương thức duy nhất. Việc sử dụng các phương thức theo lô này giúp 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 máy khách.
    • Giảm số lượng truy vấn được thực hiện.
    • Giảm số lượng bản sửa đổi trên tài liệu.
    • Đảm bảo tính nguyên tử của tất cả các thay đổi trong lô.

Recipe

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 phiên bản 4.

Các ví dụ này được trình bày dưới dạng yêu cầu HTTP để không phụ thuộc vào ngôn ngữ. Để tìm hiểu cách triển khai các giao thức yêu cầu của 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 trong phần này được chia thành các danh mục sau:

  • Đọc cơ bản – Các công thức cho biết cách đọc giá trị từ một trang tính.
  • Viết cơ bản – Các 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à sửa đổ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 dữ liệu trong bảng tính.
  • Phạm vi được đặt tên và được bảo vệ – Các công thức cho biết cách tạo, cập nhật và xoá phạm vi được đặt tên và được bảo vệ trong bảng 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ác 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ách cập nhật các thuộc tính của 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, cũng như kiểm soát các thuộc tính của trang tính.