Trang tổng quan Apps Script cho phép bạn quản lý và theo dõi các dự án Apps Script của mình. Bạn có thể sử dụng trang tổng quan này để thực hiện bất kỳ thao tác nào sau đây:
- Xem và tìm kiếm các dự án Apps Script hiện có của bạn, bao gồm cả các tập lệnh ràng buộc được đính kèm trongGoogle Workspace tài liệu.
- Tạo dự án mới.
- Xem thông tin chi tiết về dự án của bạn, chẳng hạn như các phạm vi OAuth mà dự án 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 của các dự án và các dự án khác chạy bằng thông tin đăng nhập tài khoản của bạ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 của 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. Trình đơn đ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 monitoring.
- 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. 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 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. Để xem thông tin 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 hiển thị dữ liệu và biểu đồ về Tỷ lệ lỗi, Các lần thực thi và Người dùng về dự án, cũng như các phạm vi của OAuth được yêu cầu cho bất kỳ người dùng cuối nào 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 trường hợp ngoại lệ chưa nắm bắt đượ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 riêng biệt (tài khoản) đã chạy dự án từ 1 lần trở lên trong khoảng thời gian quy định. Người dùng ẩn danh 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 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 quan cho quá trình triển khai đó. Khi chọn TẤT CẢ, bạn sẽ thấy dữ liệu tổng hợp từ tất cả các lần triển khai của dự án và từ các lượt thực thi do các nhà phát triển chạy dự án đó trong trình chỉnh sửa 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 khi bạn sử dụng hoặc quản lý 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 đó. Dự án có gắn dấu sao cũng cho phép bạn theo dõi số liệu thống kê về tỷ lệ lỗi và mức sử dụng tổng hợp trong các dự án đó.
Để gắn dấu sao cho một dự án, ở bên phải của 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 Thêm 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ượt thực thi của 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 thực thi gần đây bằng cách chọn mục Cá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ượt thực thi của tôi sẽ hiển thị nhật ký về tất cả các lượt thực thi trước đây và đang chạy cho những 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ụ: các 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. Phần này 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ượt thực thi duy nhất. Các cột Thời gian bắt đầu, Thời lượng và Trạng thái hiển thị thông tin tương ứng về lượt 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 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. Hoạt động 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 lâu dài hiện đang diễn ra được biểu thị bằng Trạng thái "Đ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 > Chấm dứt.
Cài đặt
Bạn có thể điều chỉnh các 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 Settings (Cài đặt) là một nút bật/tắt cho Apps Script API. Điều 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 của bạn.
Để truy cập 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 Settings (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ẽ bị tắt để đảm bảo an toàn. 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 này để sửa đổi các 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.