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ả tập lệnh được liên kết với tài liệu Google 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à những dự án khác chạy bằng thông tin đăng nhập 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 của bạn.
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. Khu vực điều hướng bên trái của trang tổng quan chia các dự án này thành những 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. 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. Những dự án 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 đề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 dữ liệu và biểu đồ Tỷ lệ lỗi, Số lần thực thi và Số người dùng về dự án, cũng như các phạm vi OAuth được yêu cầu đối với 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 trường hợp ngoại lệ chưa được phát hiện. Tỷ lệ 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 khoảng thời gian xác định.
- 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ố lượng 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. Chúng tôi không theo dõi người dùng ẩn danh, do đó, họ không được tính vào số lượng người dùng hoặc biểu đồ.
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 Project Details (Thông tin dự án) trước dữ liệu và biểu đồ; hãy chọn thẻ để xem dữ liệu liên quan cho lần triển khai đó. Khi bạn chọn TẤT CẢ, dữ liệu tổng hợp sẽ xuất hiện cho tất cả các bản triển khai của dự án và từ các lượt 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 sẽ không xuất hiện dưới dạng được triển khai trong trang tổng quan Apps Script.
Theo dõi dự án
Đánh dấu dự án bằng cách gắn dấu sao. Việc gắn dấu sao cho dự án cũng giúp bạn theo dõi các biểu đồ và số liệu thống kê tổng hợp về mức sử dụng 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 trình đơn điều hướng bên trái, hãy chọn Dự án được gắn dấu sao để xem những 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 Số người dùng ở đầu trang để xem các biểu đồ liên quan cho tất 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 đó rồi chọn Xoá dấu sao.
Quản lý việc 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 Các lần thực thi của tôi trong trình đơn điều hướng bên trái.
Bảng điều khiển My Executions (Các 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 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ần thực thi hàm trong những dự án mà bạn không có quyền truy cập nếu các hàm đó 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. Thao tác này không cho thấy mọi hàm được gọi trong quá trình thực thi đó.
Kiểm soát loại hoạt động 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 chế độ xem. Mỗi hàng trong nhật ký đại diện cho một lượ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ề 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 cho bạn.
Cột Loại cho biết yếu tố nào đã bắt đầu quá trình thực thi. Các giá trị bao gồm:
- Add On (Thêm tiện ích). Hoạt động 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ừ một lệnh gọi API Apps Script.
- Dựa trên thời gian. Việc 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. Hoạt động 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 tập lệnh Apps Script.
Kết thúc quá trình thực thi
Các hoạt động thực thi diễn ra trong thời gian dài và đang tiến hành được biểu thị bằng Trạng thái "Đang chạy". Để dừng các lượt 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 > Kết thúc.
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 trình đơn điều hướng bên trái.
Trong bảng Settings (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 của bạn.
Để 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ở một bảng điều khiển mới có văn bản cảnh báo và một công tắc 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 uỷ quyền đều có thể dùng API này để 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 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 về quyền truy cập vào API Apps Script.