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. Bạn có thể sử dụng trang tổng quan để làm bất kỳ việc nào sau đây:
- 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ớiGoogle 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ư 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. Thanh đ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. 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 không thuộc quyền sở hữu của bạn 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 được 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ư phạm vi OAuth được yêu cầu của mọi người dùng cuối sử dụng 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 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 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 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 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 lượt 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 chỉnh sửa 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 số dự án bạn sử dụng hoặc quản lý thường xuyên. Để đánh dấu dự án và dễ dàng truy cập, bạn có thể gắn dấu sao cho dự án. Việc gắn dấu sao cho dự án cũng giúp bạn theo dõi số liệu thống kê tổng hợp về mức sử dụng và tỷ lệ lỗi cũng như biểu đồ của những dự án đó.
Để 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, bạn có thể 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 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.
Bạn có thể 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
Bạn có thể 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. Bạn có thể tìm thấy nhật ký đầy đủ về các lần 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 thanh điều hướng bên trái.
Theo mặc định, bảng điều khiển My Executions (Các lần thực thi của tôi) sẽ hiện nhật ký của tất cả các lần thực thi trước đây và hiện đ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ệnh 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 lệnh đó chạy thay cho bạn (ví dụ: những 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. Nó không cho thấy mọi hàm được gọi trong quá trình thực thi đó.
Bạn có thể 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ần 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 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:
- Tiện ích bổ sung. 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. Hoạt động 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 Apps Script.
Chấm dứt quá trình thực thi
Các hoạt động thực thi diễn ra trong thời gian 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 lần 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
Bạn có thể đ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 điều khiển Cài đặt, có 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.
Để 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 cho phép đề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 bất cứ lúc nào trong bảng điều khiển Cài đặt.
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.