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. Sử dụng trang tổng quan để:
- 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ệu Google Workspace.
- Tạo dự án mới.
- Xem thông tin chi tiết về dự án, chẳng hạn như phạm vi OAuth mà dự án sử dụng.
- Giám sát 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à những 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 sử dụng API này tương tác với các dự án tập lệnh.
Xem và tìm kiếm dự án
Trang tổng quan Apps Script liệt kê tất cả cá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. Các dự án mà bạn đang giám sát.
- Dự án của tôi. Các dự án mà bạn là chủ sở hữu.
- Tất cả dự án. Các 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 hiển thị 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 liên kết.
Xem thông tin chi tiết về dự án
Mỗi dự án đều có một chế độ xem để xem thông tin chi tiết về nhà phát triển của 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 thông tin chi tiết về dự án cho thấy 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ư phạm vi OAuth được yêu cầu của bất kỳ người dùng nào của dự án. 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 được do các ngoại lệ không được phát hiện. Chỉ số này được tính bằng cách chia số lần thực thi không thành công cho tổng số lần thực thi trong khoảng thời gian được xác định.
- Số lần thực thi. Số lần một dự án đã được "chạy" hoặc thực thi. Hãy xem phần Các loại thực thi để biết thêm thông tin về cách chạy một dự án.
- Người dùng. Số tài khoản người dùng 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, do đó, không được phản ánh trong số lượng người dùng hoặc biểu đồ.
Mỗi bản triển khai của dự án đều xuất hiện dưới dạng một thẻ trên trang Thông tin chi tiết về dự án trước dữ liệu và biểu đồ; hãy chọn thẻ để xem dữ liệu được liên kết cho bản triển khai đó. Khi bạn chọn TẤT CẢ , dữ liệu tổng hợp sẽ hiển thị 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.
Các dự án được xuất bản dưới dạng tiện ích bổ sung không xuất hiện dưới dạng đã triển khai trong trang tổng quan Apps Script.
Giám sát dự án
Đánh dấu dự án bằng cách 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 giám sát số liệu thống kê và biểu đồ về mức sử dụng tổng hợp và tỷ lệ lỗi.
Để 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 thanh điều hướng bên trái, hãy chọn Dự án được gắn dấu sao để xem các dự án mà bạn đã đá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 đồ được liên kết cho tất cả các dự án được gắn dấu sao trong 7 ngày qua.
Xoá dấu sao khỏi một dự án bằng cách nhấp vào biểu tượng Tuỳ chọn khác trong hàng dự án của dự án đó rồi chọn Xoá dấu sao.
Quản lý số lần thực thi
Sử dụng trang tổng quan Apps Script để xem và quản lý từng lần thực thi các hàm của dự án Apps Script. Tìm nhật ký đầy đủ về các lần thực thi gần đây bằng cách chọn Số lần thực thi của tôi trong thanh điều hướng bên trái.
Bảng điều khiển Số lần thực thi của tôi cho thấy nhật ký của tất cả các lần 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ần thực thi hàm trong các dự án mà bạn không có quyền truy cập nếu các dự án đó 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ỉ hiển thị hàm ban đầu được gọi để bắt đầu thực thi. Danh sách này không hiển thị mọi hàm được gọi trong quá trình thực thi đó.
Kiểm soát loại thực thi được báo cáo trong nhật ký bằng các bộ lọc ở đầu chế độ xem. Mỗi hàng của nhật ký đại diện cho một lần thực thi. Các cột Thời gian bắt đầu, Thời lượng và Trạng thái cho thấy thông tin tương ứng về lần thực thi đó.
Cột Hàm cho thấy tên của hàm đã bắt đầu 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 lần thực thi nhưng dự án đó đã chạy thay cho bạn.
Cột Loại cho biết yếu tố đã bắt đầu thực thi. Các giá trị bao gồm:
- Tiện ích bổ sung. Lần thực thi bắt nguồn từ một tiện ích bổ sung.
- API thực thi. Lần thực thi bắt nguồn từ một lệnh gọi API Apps Script.
- Dựa trên thời gian. Lần thực thi do một sự kiện thời gian gây ra.
- Điều kiện kích hoạt. Lần thực thi bắt nguồn từ một nguồn điều kiện kích hoạt.
- Ứng dụng web. Lần thực thi bắt nguồn từ một ứng dụng web đã triển khai.
- Người chỉnh sửa. Lần thực thi bắt nguồn từ trình chỉnh sửa tập lệnh Apps Script.
Chấm dứt số lần thực thi
Các lần 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 lần thực thi này, ở bên phải hàng dự án, hãy nhấp vào Tuỳ chọn khác > Chấm dứt.
Cài đặt
Đ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 có một nút bật/tắt cho API Apps Script. Điều này cho phép bạn cấp quyền truy cập API vào các dự án tập lệnh của mình.
Để truy cập vào nút bật/tắt này, hãy nhấp vào nhãn API Google Apps Script trong bảng điều khiển Cài đặt. Thao tác này sẽ mở một bảng điều khiển mới có văn bản cảnh báo và 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 được tắt theo mặc định để đảm bảo an toàn. Sau khi bạn cấp quyền truy cập, mọi ứng dụng của bên thứ ba mà bạn uỷ quyền đều có thể sử dụng API này để sửa đổi tập lệnh và bản triển khai của bạn. 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 về quyền truy cập API Apps Script.