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