Giới thiệu

Google Apps Script API cho phép bạn tự động hoá việc tạo, quản lý và thực thi tập lệnh trong Google Apps Script. Bạn có thể tạo, sửa đổi và triển khai các dự án Google Apps Script theo phương thức lập trình, đồng thời thực thi các hàm Apps Script từ xa – những thao tác mà nếu không thì bạn phải sử dụng trình chỉnh sửa tập lệnh Apps Script hoặc giao diện người dùng của trình chỉnh sửa này.

API này thường được dùng để:

  • Tạo và quản lý các dự án cũng như bản triển khai Apps Script.
  • Thêm hoặc cập nhật các hàm trong dự án tập lệnh.
  • Thực thi các hàm Apps Script từ các ứng dụng khác.
  • Theo dõi nhật ký và trạng thái thực thi tập lệnh.

API Apps Script cũng thay thế và mở rộng API thực thi Apps Script. Bạn có thể sử dụng Apps Script API để thực thi các hàm Apps Script từ xa, giống như khi sử dụng Execution API.

Để sử dụng API này trong ứng dụng, bạn phải bật API này để sử dụng.

Để cho phép các ứng dụng khác quản lý tập lệnh của bạn, bạn phải cấp quyền truy cập cho các ứng dụng đó.

Tổng quan về API

Apps Script API được chia thành nhiều tài nguyên, mỗi tài nguyên có một mục đích cụ thể và một tập hợp các yêu cầu mà bạn có thể đưa ra. Các tài nguyên này như sau:

  • projects – Biểu thị một dự án tập lệnh. API này cung cấp các phương thức để tạo, đọc, theo dõi và sửa đổi dự án. Sử dụng tài nguyên này để quản lý các tệp tập lệnh và siêu dữ liệu của dự án.
  • projects.deployments – Biểu thị việc triển khai tập lệnh. API này cung cấp các phương thức để tạo, liệt kê, cập nhật và xoá các bản triển khai dự án tập lệnh. Sử dụng quy trình triển khai để cung cấp tập lệnh dưới dạng ứng dụng web, tiện ích bổ sung hoặc tệp thực thi.
  • projects.versions – Biểu thị một phiên bản dự án tập lệnh. API này cung cấp các phương thức để tạo và đọc các phiên bản dự án. Sử dụng các phiên bản để theo dõi nhiều lần lặp lại của dự án tập lệnh.
  • processes – Biểu thị quá trình thực thi hàm tập lệnh. API này cung cấp các phương thức để liệt kê các quy trình hiện có và thu thập thông tin về các quy trình đó, chẳng hạn như loại và trạng thái hiện tại. Sử dụng tài nguyên này để theo dõi các hoạt động thực thi tập lệnh được bắt đầu bằng phương thức scripts.run.
  • scripts – Điểm cuối cung cấp các phương thức để thực thi từ xa các hàm Apps Script. Dùng tài nguyên này để chạy các hàm trong dự án tập lệnh từ ứng dụng của bạn.