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ó, bao gồm cả các tập lệnh giới hạn đính kèm với Google 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 dự án tập lệnh.
- Xem nhật ký thực thi cho các dự á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 Apps Script API để cho phép hoặc ngăn các ứng dụng dùng API để 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. Trình đơn bên trái của trang tổng quan sẽ 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 theo dõi.
- 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. 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 đã xóa khỏi Google Drive.
Danh sách dự án cho thấy 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 chi tiết dự án
Mỗi dự án bao gồm một chế độ xem để xem thông tin chi tiết về dự án cho 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ị Tỷ lệ lỗi, Lượt thực thi và Số người dùng và biểu đồ về dự án, cũng như các phạm vi OAuth của yêu cầu bất kỳ người dùng cuối nào 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ượt thực thi không chạy được do các 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.
- Lượt thực thi. Số lần một dự án được "chạy" hoặc thực thi. Hãy xem phần 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ố người dùng (tài khoản) riêng biệt đã chạy dự án một hoặc nhiều lần trong khoảng thời gian đã chỉ đị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 người dùng hoặc biểu đồ.
Mỗi lượt 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ẻ này để xem dữ liệu liên quan đến hoạt động triển khai đó. Việc chọn TẤT CẢ sẽ hiển thị 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 hoạt động thực thi do nhà phát triển chạy dự án thực hiện từ trong trình chỉnh sửa mã Tập lệnh Apps.
Giám sát các 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 thường xuyên sử dụng hoặc quản lý. Để đánh dấu các dự án để dễ dàng truy cập, bạn có thể gắn dấu sao cho các dự án đó. Việc 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ê tổng hợp về việc sử dụng và tỷ lệ lỗi cũng như biểu đồ trên những dự án đó.
Để gắn dấu sao một dự án, ở bên phải hàng của dự án, hãy nhấp vào biểu tượng Thêm > Thêm dấu sao. Bạn cũng có thể gắn dấu sao 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 bảng đ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à bạn đã đánh dấu. Nhấp vào thẻ điểm Tỷ lệ lỗi, Lượt thực thi hoặc Số người dùng ở đầu trang để xem biểu đồ liên kết cho tất cả dự án có gắn dấu sao của bạn 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 Thêm trong hàng dự án đó và 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 quá trình thực thi từng chức năng của dự án Apps Script. Bạn có thể tìm thấy toàn bộ nhật ký thực thi gần đây của mình bằng cách chọn mục Thực thi của tôi trong trình đơn điều hướng bên trái.
Theo mặc định, bảng Thực thi của tôi hiển thị nhật ký của tất cả các quá trình thực thi trước đây và hiện đ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 việc thực thi hàm trong các 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 thực thi. Hàm 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 nào được báo cáo trong nhật ký bằng cách sử dụng bộ lọc ở đầu chế độ xem. Mỗi hàng của 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 hiển thị thông tin tương ứng về quá trình thực thi đó.
Cột Hàm hiển thị tên của hàm đã khởi tạo 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 đó thay mặt bạn chạy.
Cột Type (Loại) cho biết những gì đã khởi tạo quá trình thực thi. Các giá trị bao gồm:
- Thêm vào. Quá trình thực thi bắt nguồn từ một tiện ích bổ sung.
- API thực thi. Quá trình thực thi bắt nguồn từ lệnh gọi API Apps Script.
- Theo thời gian. Việc thực thi là do một sự kiện thời gian.
- Trình kích hoạt. Quá trình thực thi bắt nguồn từ một nguồn trình 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 đã được 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 quá trình thực thi dài hạn hiện đang diễn ra sẽ biểu thị bằng một Trạng thái "Đang chạy". Để dừng các lượt thực thi này, hãy nhấp vào biểu tượng Thêm > Chấm dứt ở bên phải hàng dự án.
Cài đặt
Bạn có thể điều chỉnh chế độ cài đặt trên trang tổng quan bằng cách chọn Settings (Cài đặt) trong bảng điều hướng bên trái.
Trong bảng Settings (Cài đặt), bạn sẽ thấy 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 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 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 chuyển 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 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ể sử dụng API để sửa đổi tập lệnh và phương thức triển khai. Bạn có thể thu hồi quyền truy cập này trong bảng Cài đặt bất kỳ lúc nào.
Vui lòng tìm thêm thông tin trong Hướng dẫn truy cập API Apps Script.
Hỗ trợ
Nếu gặp lỗi hoặc cần trợ giúp về cách sử dụng trang tổng quan Apps Script, bạn nên bắt đầu bằng cách tìm kiếm hoặc đăng lên Stack Overflow:
Lỗi
Nếu đã xác định được nguyên nhân của vấn đề là do lỗi trong chính trang tổng quan, bạn có thể tìm kiếm Công cụ theo dõi lỗi để xác định xem đó có phải là vấn đề đã biết hay không. Nếu có, bạn có thể gắn dấu sao cho vấn đề (nhấp vào dấu sao bên cạnh số phát hành) – chúng tôi ưu tiên các lỗi nhận được nhiều sao hơn. Bạn cũng có thể thêm nhận xét vào các vấn đề hiện có, nhưng chỉ nên thêm nhận xét nếu bạn đang thêm ngữ cảnh hoặc thông tin bổ sung về vấn đề.
Nếu sự cố hoàn toàn mới, bạn cũng có thể báo cáo sự cố đó trên Công cụ theo dõi lỗi của chúng tôi. Nếu bạn làm như vậy, hãy nhớ đưa thông tin sau vào nội dung mô tả lỗi:
- Nội dung mô tả vấn đề và hành vi mà bạn mong đợi.
- Danh sách các bước có thể sử dụng để tái hiện vấn đề.
- Nội dung mô tả kết quả mà bạn mong đợi và những gì thực sự xảy ra. Bao gồm mọi thông báo lỗi bạn nhận được.
- Thông tin về môi trường phát triển của bạn, bao gồm ngôn ngữ lập trình, phiên bản thư viện, v.v.
Xin lưu ý rằng các vấn đề có thể tương đối yên tĩnh trong một thời gian. Điều này không có nghĩa là chúng tôi sẽ không bao giờ khắc phục vấn đề; điều này chỉ có nghĩa là hiện không có bản cập nhật nào.
Tính năng còn thiếu
Nếu có một tính năng hoặc chức năng bị thiếu trong bảng điều khiển mà bạn muốn có, thì bạn có thể tìm Công cụ theo dõi lỗi của chúng tôi để xác định xem người khác có yêu cầu hay không. Nếu đã yêu cầu vấn đề, hãy gắn dấu sao cho vấn đề (nhấp vào dấu sao bên cạnh số vấn đề)—chúng tôi ưu tiên các lỗi nhận được nhiều sao hơn. Bạn cũng có thể thêm nhận xét vào các vấn đề hiện có, nhưng chỉ nên thực hiện việc này nếu bạn đang thêm ngữ cảnh hoặc thông tin bổ sung về vấn đề.
Nếu tính năng này chưa được yêu cầu, bạn có thể gửi yêu cầu về tính năng trên Công cụ theo dõi lỗi của chúng tôi. Vui lòng mô tả chức năng cụ thể mà bạn muốn thêm, cũng như các lý do bạn cho là quan trọng. Nếu có thể, hãy thêm các thông tin chi tiết cụ thể về trường hợp sử dụng của bạn và những cơ hội mới mà tính năng này sẽ cho phép.