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 của mình. Bạn có thể sử dụng trang tổng quan để thực hiện bất kỳ việ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 gửi kèm đính kèm vớiGoogle 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 các 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 tài khoản của bạn.
- Bật hoặc tắt Apps Script API để cho phép hoặc ngăn ứng dụng sử dụng API này để tương tác với các 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. 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 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à một dự án độc lập hay là một dự án ràng buộc.
Xem thông tin chi tiết về dự án
Mỗi dự án có một khung hiển thị để xem thông tin chi tiết về nhà phát triển về dự á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 cho thấy dữ liệu Tỷ lệ lỗi, Số lượt thực thi và Số người dùng và biểu đồ về dự án, cũng như phạm vi OAuth mà mọi người dùng cuối sử dụng dự án đều yêu cầu. Các chỉ số dữ liệu được xác định như sau:
- Tỷ lệ lỗi. Tỷ lệ phần trăm số lần thực thi không chạy do chưa nắm bắt được các trường hợp ngoại lệ. Số liệu này được tính bằng cách lấy số lần thực thi không thành công chia cho tổng số lần thực thi trong một khoảng thời gian xác định.
- Thực thi. Số lần một dự án được "chạy" hoặc được thực thi. Hãy xem bài viết Các loại thực thi để biết thêm thông tin về cách chạy dự án.
- Người dùng. Số lượng người dùng riêng biệt (tài khoản) đã chạy dự án một hoặc nhiều lần trong khoảng thời gian cụ thể. Người dùng ẩn danh không được theo dõi và do đó không được phản ánh trong biểu đồ hoặc số lượng người dùng.
Mỗi lần triển khai dự án của bạn xuất hiện dưới dạng một thẻ trên trang Project Details (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Ả dữ liệu, bạn sẽ thấy dữ liệu tổng hợp cho tất cả các hoạt động triển khai của dự án và từ các quá trình thực thi xuất phát từ việc nhà phát triển chạy dự án trong trình soạn thảo mã Apps Script.
Theo dõi 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 những dự án bạn sử dụng hoặc quản lý thường xuyên. Để đánh dấu dự án nhằm dễ dàng truy cập, bạn có thể gắn dấu sao cho các dự án đó. Gắn dấu sao các dự án cũng cho phép bạn theo dõi số liệu thống kê cũng như biểu đồ tổng hợp về mức sử dụng và tỷ lệ lỗi của các dự án đó.
Để gắn dấu sao cho một dự án, ở bên phải của một 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 trình đơn điều hướng bên trái, bạn có thể chọn Starred Projects (Dự án có gắn dấu sao) để xem các dự án đã đánh dấu. Nhấp vào thẻ điểm Tỷ lệ lỗi, Số lượt thực thi hoặc Số người dùng ở đầu trang để xem biểu đồ liên quan cho tất cả các dự án có gắn dấu sao trong 7 ngày qua.
Bạn có thể xoá một 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 và chọn Remove star (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ý các lần thực thi riêng lẻ của các chức năng của dự án Apps Script. Bạn có thể tìm thấy nhật ký đầy đủ các tệp thực thi gần đây bằng cách chọn mục My Executions (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 Lượt thực thi của tôi hiển thị nhật ký gồm tất cả các lượt thực thi trước đó và đang chạy của 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 quá trình 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ụ: các tiện ích bổ sung mà bạn đã cài đặt và chạy). Danh sách thực thi chỉ hiển thị hàm ban đầu được gọi để bắt đầu quá trình thực thi. Cột 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 quá trình 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ề quá trình thực thi đó.
Cột Function hiển thị tên của hàm đã bắt đầu thực thi. Sẽ 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 lượt thực thi nhưng tập lệnh đó đã chạy thay mặt bạn.
Cột Loại (Type) cho biết điều gì đã bắt đầu 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 (API thực thi). Quá trình thực thi bắt nguồn từ lệnh gọi của API Apps Script.
- Thời gian chạy. Việc thực thi 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 đ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. Quá trình 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 lượt thực thi chạy trong thời gian dài hiện đ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 > Chấm dứt.
Cài đặt
Bạn có thể điều chỉnh các chế độ cài đặt của trang tổng quan bằng cách chọn Settings (Cài đặt) trong phần điều hướng bên trái.
Trong bảng điều khiển Settings (Cài đặt) là nút bật/tắt cho Apps Script API. Việ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 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 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 tập lệnh và phiên bản triển khai. 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 thêm thông tin trong Hướng dẫn truy cập API Apps Script.