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ể dùng để tạo, đọc, sửa đổi và giám sát các dự án Apps Script. Trang mẫu Quản lý dự án hiển thị ví dụ về các yêu cầu quản lý API. Tài liệu tham khảo cho mỗi phương thức sẽ 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

Dự án.create

Results (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 tên dự án. Bạn cũng có thể tạo tập lệnh liên kết 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 Trang trình bày để đóng vai trò là tệp gốc của tập lệnh.

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

Dự án.get

Kết quả: Truy xuất một đối tượng Project đại diện cho siêu dữ liệu của dự án. Dữ liệu này bao gồm tên 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

project.getContent

Results (Kết quả): Trả về một mảng các đối tượng File, một đối tượng cho mỗi 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

Dự án.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. Mã này được dùng khi tập lệnh thực thi dưới dạng một điều kiện 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 một ứng dụng web hoặc API Apps Script ở chế độ phát triển.

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

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

Dự án.getMetrics

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

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