Quản lý dự án

Phần này cung cấp thông tin tổng quan về các phương thức Google Apps Script API mà bạn có thể dùng để tạo, đọc, sửa đổi và giám sát các dự án Google Apps Script. Trang mẫu Quản lý dự án cho thấy các ví dụ về yêu cầu quản lý API. Tài liệu tham khảo cho từng phương thức cung cấp thông tin chi tiết về cách triển khai.

Tổng quan về phương thức API
Tạo dự án

projects.create

Kết quả: Tạo một dự án cơ bản, trống không có tệp dự án và tệp kê khai dự án mặc định.

Tuỳ chọn: Bạn có thể cung cấp tiêu đề dự án. Bạn cũng có thể tạo một tập lệnh ràng buộc bằng cách cung cấp mã Google Drive của tệp Google Tài liệu, Google Trang tính, Google Biểu mẫu hoặc Google Trang trình bày để đóng vai trò là tệp mẹ của tập lệnh.

Đọc siêu dữ liệu dự án

projects.get

Kết quả: Truy xuất đối tượng đại diện cho siêu dữ liệu dự án.Project Dữ liệu này bao gồm tiêu đề dự án, mã tập lệnh, người dùng tạo, thời gian tạo và các thông tin chi tiết khác.

Đọc nội dung dự án

projects.getContent

Kết quả: Trả về một mảng các File đối tượng, một đối tượng cho mỗi tệp mã và tệp HTML trong dự án. Danh sách này cũng bao gồm tệp kê khai dự án dưới dạng tệp JSON. Các đối tượng tệp chứa nội dung nguồn của tệp (File.source) và siêu dữ liệu khác, chẳng hạn như danh sách các hàm trong tệp (File.functionSet).

Tuỳ chọn: Bạn có thể chỉ định phiên bản nội dung cần truy xuất bằng tham số truy vấn.

Cập nhật nội dung dự án

projects.updateContent

Kết quả: Thay đổi nội dung tệp trong một dự án tập lệnh. Bạn cung cấp nội dung mới dưới dạng một mảng các File đối tượng. Một trong các đối tượng File này phải có loại JSON và đại diện cho tệp kê khai dự án mới của dự án tập lệnh dự án. Nội dung mới được lưu trữ dưới dạng phiên bản HEAD của dự án. Nội dung này được dùng khi tập lệnh thực thi dưới dạng trình kích hoạt, trong trình chỉnh sửa tập lệnh, ở chế độ xem trước tiện ích bổ sung Google Workspace hoặc dưới dạng một ứng dụng web hoặc Apps Script API ở chế độ phát triển.

Lưu ý: Để cập nhật nội dung dự án tập lệnh, trước tiên, hãy đưa ra yêu cầu projects.getContent để truy xuất một mảng các File hiện có, thực hiện các thay đổi dự định đối với các đối tượng đó, sau đó sử dụng các File làm dữ liệu đầu vào cho yêu cầu projects.updateContent.

Cảnh báo: Nội dung mới sẽ thay thế tất cả các tệp hiện có trong dự án tập lệnh. Các tệp không được cập nhật theo yêu cầu sẽ bị xoá.

Đọc chỉ số dự án

projects.getMetrics

Kết quả: Đọc một số chỉ số về dự án. Các chỉ số này bao gồm số người dùng, tổng số lần thực thi , tổng số lỗi thực thi và các thông tin chi tiết khác. Sử dụng MetricType để chỉ định thông tin mà bạn đang yêu cầu.

Tuỳ chọn: Giới hạn kết quả cho các bản triển khai hoặc hàm tập lệnh cụ thể bằng MetricsFilter. Bạn cũng có thể xác định một khoảng thời gian chỉ số cụ thể bằng MetricsIntervalConfig.