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 API Apps Script mà bạn có thể sử dụng để tạo, đọc, sửa đổi và theo dõi các dự án 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 trống, cơ bản 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 liên kết bằng cách cung cấp mã nhận dạng Google Drive của tệp Google Tài liệu, Google Trang tính, Google Biểu mẫu hoặc 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 Project đại diện cho siêu dữ liệu dự án. 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 đối tượng File, mỗi đối tượng cho một 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. Đố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 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 đối tượng File. 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. Nội dung mới được lưu trữ dưới dạng phiên bản HEAD của dự án. Phương thức 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 hoặc dưới dạng ứng dụng web hoặc API Apps Script ở chế độ phát triển.

Lưu ý: Khi cập nhật nội dung dự án tập lệnh, thông thường, trước tiên, bạn nên đưa ra yêu cầu projects.getContent để truy xuất một mảng các File hiện có, tạo mong muốn cho các đối tượng đó, sau đó sử dụng 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 yêu cầu cập nhật sẽ bị xoá.

Đọc các chỉ số của dự án

projects.getMetrics

Kết quả: Đọc một số chỉ số nhất định về một 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 bạn đang yêu cầu.

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