Trang tổng quan Apps Script cho phép bạn quản lý và giám sát các dự án Apps Script. Bạn có thể sử dụng trang tổng quan để làm những việc sau:
- Xem và tìm kiếm các dự án Apps Script hiện có, bao gồm cả các tập lệnh đã liên kết được đính kèm vào tài liệuGoogle Workspace .
- Tạo dự án mới.
- Xem thông tin chi tiết về các dự án của bạn, chẳng hạn như phạm vi OAuth mà dự án sử dụng.
- Theo dõi tình trạng và mức sử dụng của các dự án tập lệnh.
- Xem nhật ký thực thi cho các dự án của bạn và các dự án khác chạy bằng thông tin xác thực của tài khoản.
- Bật hoặc tắt API Apps Script để cho phép hoặc ngăn các ứng dụng dùng API này tương tác với dự án tập lệnh của bạn.
Xem và tìm dự án
Trang tổng quan Apps Script liệt kê tất cả dự án tập lệnh mà bạn có thể xem hoặc chỉnh sửa. Thanh điều hướng bên trái của trang tổng quan chia các dự án này thành các danh mục sau:
- Dự án được gắn dấu sao. Dự án mà bạn đang theo dõi.
- Dự án của tôi. Những dự án mà bạn là chủ sở hữu.
- Tất cả dự án. Những dự án mà bạn sở hữu hoặc có quyền xem hoặc chỉnh sửa.
- Được chia sẻ với tôi. Các dự án mà bạn không sở hữu nhưng đã được chia sẻ với bạn.
- Thùng rác. Các dự án mà bạn đã xoá khỏi Google Drive.
Danh sách dự án cho biết tên dự án, chủ sở hữu và ngày sửa đổi gần nhất. Các biểu tượng bên cạnh tên dự án cho biết dự án đó là dự án độc lập hay dự án đã liên kết.
Xem thông tin chi tiết về dự án
Mỗi dự án bao gồm một khung hiển thị để xem thông tin chi tiết về dự án của nhà phát triển. Để xem chi tiết về một dự án, hãy nhấp vào hàng trong danh sách dự án.
Chế độ xem chi tiết dự án cho thấy dữ liệu và biểu đồ về Tỷ lệ lỗi, Số lần thực thi và Số người dùng của dự án, cũng như phạm vi OAuth mà mọi người dùng cuối sử dụng dự án yêu cầu. Các chỉ số dữ liệu được định nghĩa như sau:
- Tỷ lệ lỗi. Tỷ lệ phần trăm số lần thực thi không chạy được do ngoại lệ không phát hiện được. Tỷ lệ này được tính bằng cách lấy số lượt thực thi không thành công chia cho tổng số lượt thực thi trong khoảng thời gian đã xác định.
- Các lần thực thi. Số lần một dự án được "chạy" hoặc thực thi. Xem phần Các kiểu thực thi để biết thêm thông tin về cách chạy dự án.
- Người dùng. Số người dùng (tài khoản) riêng biệt đã chạy dự án một hoặc nhiều lần trong khoảng thời gian được chỉ định. Người dùng ẩn danh không được theo dõi và do đó không được phản ánh trong số người dùng hoặc biểu đồ.
Mỗi lần triển khai dự án sẽ xuất hiện dưới dạng một thẻ trên trang Chi tiết dự án ở phía trên dữ liệu và biểu đồ; bạn có thể chọn thẻ đó để xem dữ liệu liên kết cho lần triển khai đó. Khi chọn TẤT CẢ, bạn sẽ thấy dữ liệu tổng hợp cho tất cả các bản triển khai của dự án và từ các lần thực thi do nhà phát triển chạy dự án trong trình soạn thảo mã Apps Script.
Giám sát dự án
Bạn có thể có quyền truy cập vào nhiều dự án Apps Script hơn đáng kể so với số dự án mà bạn thường xuyên sử dụng hoặc quản lý. Để đánh dấu dự án để dễ dàng truy cập, bạn có thể gắn dấu sao cho dự án đó. Việc gắn dấu sao cho dự án cũng cho phép bạn theo dõi số liệu thống kê và biểu đồ về mức sử dụng tổng hợp cũng như tỷ lệ lỗi trên các dự án đó.
Để gắn dấu sao cho một dự án, ở bên phải hàng dự án, hãy nhấp vào biểu tượng Tuỳ chọn khác > Thêm dấu sao. Bạn cũng có thể gắn dấu sao cho một dự án bằng cách nhấp vào biểu tượng Tuỳ chọn khác trong khi xem thông tin chi tiết về dự án.
Trong ngăn điều hướng bên trái, bạn có thể chọn Dự án có gắn dấu sao để xem các dự án mà mình đã đánh dấu. Nhấp vào thẻ điểm Tỷ lệ lỗi, Số lần thực thi hoặc Người dùng ở đầu trang để xem các biểu đồ liên quan của tất cả dự án có gắn dấu sao trong 7 ngày qua.
Bạn có thể xoá dấu sao khỏi dự án bằng cách nhấp vào biểu tượng Tuỳ chọn khác trong hàng dự án rồi chọn Xoá dấu sao.
Quản lý quá trình thực thi
Bạn có thể sử dụng trang tổng quan Apps Script để xem và quản lý từng lần thực thi hàm của dự án Apps Script. Bạn có thể tìm thấy nhật ký đầy đủ về các lần thực thi gần đây bằng cách chọn mục Lần thực thi của tôi trong thanh điều hướng bên trái.
Theo mặc định, bảng điều khiển Lượt thực thi của tôi hiển thị nhật ký của tất cả các lượt thực thi trước đó và đang chạy cho các dự án mà bạn là chủ sở hữu, người chỉnh sửa hoặc người xem. Danh sách này cũng có thể bao gồm các lượt thực thi hàm trong những dự án mà bạn không có quyền truy cập nếu chúng chạy thay cho bạn (ví dụ: tiện ích bổ sung mà bạn đã cài đặt và chạy). Danh sách thực thi chỉ cho thấy hàm ban đầu được gọi để bắt đầu quá trình thực thi. Dấu vết ngăn xếp không hiển thị mọi hàm được gọi trong quá trình thực thi đó.
Bạn có thể kiểm soát loại thực thi được báo cáo trong nhật ký bằng cách sử dụng các bộ lọc ở đầu khung hiển thị. Mỗi hàng của nhật ký đại diện cho một lần thực thi. Các cột Start Time (Thời gian bắt đầu), Duration (Thời lượng) và Status (Trạng thái) cho biết thông tin tương ứng về quá trình thực thi đó.
Cột Function (Hàm) cho biết tên của hàm đã bắt đầu quá trình thực thi. Không có tên trong cột này nếu bạn không có quyền truy cập vào dự án tập lệnh tương ứng của quá trình thực thi nhưng dự án đó đã chạy thay mặt bạn.
Cột Loại cho biết nội dung đã bắt đầu quá trình thực thi. Các giá trị bao gồm:
- Tiện ích bổ sung. Quá trình thực thi bắt nguồn từ một tiện ích bổ sung.
- API thực thi. Hoạt động thực thi bắt nguồn từ lệnh gọi API Apps Script.
- Được điều khiển theo thời gian. Quá trình thực thi là do một sự kiện thời gian gây ra.
- Điều kiện kích hoạt. Quá trình thực thi bắt nguồn từ một nguồn kích hoạt.
- Webapp. Quá trình thực thi bắt nguồn từ một ứng dụng web đã triển khai.
- Trình chỉnh sửa. Quá trình thực thi bắt nguồn từ trình soạn thảo Apps Script.
Chấm dứt thực thi
Các quá trình thực thi chạy trong thời gian dài đang diễn ra được biểu thị bằng Trạng thái là "Đang chạy". Để dừng các quá trình thực thi này, ở bên phải hàng dự án, hãy nhấp vào biểu tượng Tuỳ chọn khác > Thoát.
Cài đặt
Bạn có thể điều chỉnh chế độ cài đặt trang tổng quan bằng cách chọn Cài đặt trong thanh điều hướng bên trái.
Trong bảng điều khiển Cài đặt, bạn sẽ thấy một nút bật/tắt cho Apps Script API. Thao tác này cho phép bạn cấp cho API quyền truy cập vào các dự án tập lệnh.
Để truy cập vào nút bật/tắt này, hãy nhấp vào nhãn Google Apps Script API trong bảng điều khiển Cài đặt. Thao tác này sẽ mở ra một bảng điều khiển mới có văn bản cảnh báo và một nút bật/tắt. Quyền truy cập vào các dự án tập lệnh của bạn sẽ bị tắt theo mặc định để đề phòng bảo mật. Sau khi bạn cấp quyền truy cập, mọi ứng dụng bên thứ ba mà bạn cho phép đều có thể sử dụng API để sửa đổi tập lệnh và hoạt động triển khai của bạn. Bạn có thể thu hồi quyền truy cập này trong bảng điều khiển Cài đặt bất cứ lúc nào.
Bạn có thể tìm thêm thông tin trong Hướng dẫn truy cập vào API Apps Script.