Hạn mức cho các dịch vụ của Google

Các dịch vụ của Google Apps Script có hạn mức và giới hạn hằng ngày đối với một số tính năng. Nếu vượt quá hạn mức hoặc giới hạn, tập lệnh của bạn sẽ gửi một trường hợp ngoại lệ và quá trình thực thi sẽ dừng lại.

Một số tính năng có hạn mức bổ sung từ sản phẩm Google được liên kết. Việc sử dụng dịch vụ Apps Script của một sản phẩm sẽ được tính vào tất cả hạn mức dự trữ được liên kết. Một tính năng sẽ không dùng được nếu bạn đạt đến bất kỳ hạn mức nào được liên kết.

Hạn mức hiện tại

Hạn mức được đặt ở nhiều cấp độ cho người dùng tài khoản người dùng cá nhân (chẳng hạn như gmail.com) và tài khoản Google Workspace. Hạn mức được tính trên mỗi người dùng và được đặt lại sau 24 giờ kể từ yêu cầu đầu tiên.

Hãy sử dụng các hạn mức sau để kiểm thử tập lệnh. Tất cả hạn mức đều có thể bị loại bỏ, giảm hoặc thay đổi bất cứ lúc nào mà không cần thông báo.

Tính năng Tài khoản người dùng cá nhân (ví dụ: gmail.com) Tài khoản Google Workspace
Số sự kiện lịch được tạo 5.000 / ngày 10.000 / ngày
Số liên hệ được tạo 1.000 / ngày 2.000 / ngày
Đã tạo tài liệu 250 / ngày 1.500 / ngày
Số tệp được chuyển đổi 2.000 / ngày 4.000 / ngày
Số người nhận email mỗi ngày (ví dụ: bằng MailApp) 100* / ngày 1.500* / ngày
Số người nhận email mỗi ngày trong miền (ví dụ: bằng MailApp) 100* / ngày 2.000 / ngày
Số lượt đọc/ghi email (không bao gồm lượt gửi) 20.000 / ngày 50.000 / ngày
Số lượt đọc từ nhóm 2.000 / ngày 10.000 / ngày
Số kết nối JDBC 10.000 / ngày 50.000 / ngày
Số kết nối JDBC bị lỗi 100 / ngày 500 / ngày
Số bản trình bày có thể tạo 250 / ngày 1.500 / ngày
Số lượt đọc/ghi thuộc tính 50.000 / ngày 500.000 / ngày
Số trang trình bày được tạo 250 / ngày 1.500 / ngày
Số bảng tính được tạo 250 / ngày 3.200 / ngày
Tổng thời gian chạy trình kích hoạt 90 phút / ngày 6 giờ / ngày
Số lệnh gọi tìm nạp URL 20.000 / ngày 100.000 / ngày
Số lượt kết xuất Bản đồ tĩnh 1.000 / ngày 10.000 / ngày
Số truy vấn Đường đi trên Google Maps 1.000 / ngày 10.000 / ngày
Số lệnh gọi Geocode trên Google Maps 1.000 / ngày 10.000 / ngày
Số lệnh gọi dịch 5.000 / ngày 20.000 / ngày
Số truy vấn mẫu độ cao trên Google Maps 1.000 / ngày 10.000 / ngày
Số dự án Apps Script 50 / ngày 50 / ngày

Có áp dụng thêm các giới hạn đối với tài khoản dùng thử. Sau khi bạn chuyển từ tài khoản dùng thử miễn phí sang gói đăng ký có tính phí, hạn mức trong tài khoản của bạn sẽ tự động tăng lên khi bạn đáp ứng cả hai điều kiện sau:

  • Miền của bạn đã thanh toán tổng cộng tối thiểu là 100 USD (hoặc số tiền tương đương).
  • Ít nhất 60 ngày đã trôi qua kể từ khi đạt ngưỡng thanh toán đó.

Các điểm hạn chế hiện tại

Hãy sử dụng các giới hạn sau để kiểm thử tập lệnh. Tất cả giới hạn đều có thể bị loại bỏ, giảm hoặc thay đổi bất cứ lúc nào mà không cần thông báo.

Tính năng Tài khoản người dùng cá nhân (ví dụ: gmail.com) Tài khoản Google Workspace
Thời gian chạy tập lệnh 6 phút / lần thực thi 6 phút / lần thực thi
Thời gian chạy hàm tuỳ chỉnh 30 giây / lần thực thi 30 giây / lần thực thi
Thời gian chạy tiện ích bổ sung Google Workspace 30 giây / lần thực thi 30 giây* / lần thực thi
Số lượt thực thi đồng thời trên mỗi người dùng 30 / người dùng 30 / người dùng
Số lượt thực thi đồng thời trên mỗi tập lệnh 1.000 1.000
Tệp đính kèm trong email 250 / thư 250 / thư
Kích thước nội dung email 200 KB / thư 400 KB / thư
Số người nhận email trên mỗi thư 50 / thư 50 / thư
Tổng kích thước các tệp đính kèm của email 25 MB / thư 25 MB / thư
Kích thước giá trị thuộc tính 9 KB / giá trị 9 KB / giá trị
Tổng dung lượng lưu trữ thuộc tính 500 KB / kho lưu trữ thuộc tính 500 KB / kho lưu trữ thuộc tính
Điều kiện kích hoạt 20 / người dùng / tập lệnh 20 / người dùng / tập lệnh
Kích thước phản hồi tìm nạp URL 50 MB / lệnh gọi 50 MB / lệnh gọi
Số tiêu đề trong URLFetch 100 / lệnh gọi 100 / lệnh gọi
Kích thước tiêu đề trong URLFetch 8 KB / lệnh gọi 8 KB / lệnh gọi
Kích thước BÀI ĐĂNG trong URLFetch 50 MB / lệnh gọi 50 MB / lệnh gọi
Độ dài URL trong URLFetch 2 KB / lệnh gọi 2 KB / lệnh gọi
Phiên bản 200 / tập lệnh 200 / tập lệnh

Giám sát mức sử dụng hạn mức

Để giám sát mức sử dụng hạn mức và tình trạng thực thi của tập lệnh, hãy sử dụng các phương thức sau:

  • Hạn mức email: Sử dụng MailApp.getRemainingDailyQuota() để kiểm tra số người nhận email còn lại mà bạn có thể gửi trong phần còn lại của ngày.
  • Giám sát quá trình thực thi: Sử dụng trang tổng quan Apps Script để xem nhật ký thực thi và tình trạng của tập lệnh. Trang Lượt thực thi của tôi cho biết trạng thái (ví dụ: Completed, Failed hoặc Running) của mỗi lượt thực thi tập lệnh. Bạn có thể giám sát số lượt thực thi đồng thời bằng cách lọc các lượt thực thi có Trạng thái là Running.
  • Bảng điều khiển Cloud: Nếu dự án Apps Script sử dụng dự án Google Cloud tiêu chuẩn, bạn có thể giám sát hạn mức dành riêng cho dịch vụ và mức sử dụng API trong bảng điều khiển Cloud.

Thông báo trường hợp ngoại lệ

Nếu một tập lệnh đạt đến hạn mức hoặc giới hạn, tập lệnh đó sẽ gửi một trường hợp ngoại lệ có thông báo tương tự như sau:

  • Limit exceeded: Email Attachments Per Message. Điều này cho biết rằng tập lệnh đã vượt quá một trong các hạn mức hoặc giới hạn được liệt kê trong phần Hạn mức hiện tại hoặc Các điểm hạn chế hiện tại.
  • Service invoked too many times: Calendar. Điều này cho biết rằng tập lệnh đã gọi dịch vụ đã cho quá nhiều lần trong một ngày.
  • Service invoked too many times in a short time: Calendar. Try Utilities.sleep(1000) between calls. Điều này cho biết rằng tập lệnh đã gọi dịch vụ đã cho quá nhiều lần trong một khoảng thời gian ngắn.
  • Service using too much computer time for one day. Điều này cho biết rằng tập lệnh đã vượt quá tổng thời gian thực thi cho phép trong một ngày. Trường hợp này thường xảy ra nhất đối với các tập lệnh chạy trên một trình kích hoạt, có giới hạn hằng ngày thấp hơn so với các tập lệnh được thực thi theo cách thủ công.
  • Script invoked too many times per second for this Google user account. Điều này cho biết rằng tập lệnh bắt đầu thực thi quá nhiều lần trong một khoảng thời gian ngắn. Trường hợp này thường xảy ra nhất đối với các hàm tuỳ chỉnh được gọi lặp lại trong một bảng tính. Để tránh lỗi này, hãy viết mã cho các hàm tuỳ chỉnh sao cho chỉ cần gọi một lần cho mỗi dải ô dữ liệu, như được giải thích trong hướng dẫn về hàm tuỳ chỉnh.
  • There are too many scripts running simultaneously for this Google user account. Điều này cho biết rằng bạn có quá nhiều tập lệnh đang thực thi cùng một lúc, mặc dù không nhất thiết phải là cùng một tập lệnh. Giống như trường hợp ngoại lệ trước đó, trường hợp này thường xảy ra nhất đối với các hàm tuỳ chỉnh được gọi lặp lại trong một bảng tính.