Trang này được dịch bởi Cloud Translation API.

Hạn mức và hạn mức sử dụng

Hạn mức và hạn mức giúp bảo vệ cơ sở hạ tầng của Google khỏi quy trình tự động sử dụng API Kiểm tra email theo cách không phù hợp. Yêu cầu quá mức từ một API có thể là do lỗi chính tả vô hại hoặc có thể do một hệ thống được thiết kế không hiệu quả thực hiện các lệnh gọi API không cần thiết. Bất kể lý do là gì, bạn phải chặn lưu lượng truy cập từ một nguồn cụ thể khi đạt đến một cấp nhất định đối với tình trạng tổng thể của hệ thống Google Workspace. Các giới hạn giúp đảm bảo rằng hành động của một nhà phát triển không thể tác động tiêu cực đến cộng đồng lớn hơn.

Trong trường hợp hiếm gặp là yêu cầu API không thành công, bạn sẽ nhận được phản hồi về trạng thái HTTP. Mã trạng thái 403 có thông tin lỗi về thông tin đầu vào không chính xác, và mã trạng thái HTTP 503 có thông tin lỗi cho biết đã vượt quá hạn mức API nào. Những phản hồi này cho phép ứng dụng tuỳ chỉnh của bạn phát hiện các lỗi này và có biện pháp xử lý thích hợp.

Nếu yêu cầu của bạn cần được hoàn thành trong một khoảng thời gian cố định, hãy gửi song song các yêu cầu hoặc sử dụng nhiều luồng trong ứng dụng Java hoặc C#. Một ví dụ về các yêu cầu song song là yêu cầu gửi hàng loạt email từ nhiều người dùng thay vì thêm hoặc xoá nhiều email từ một người dùng. Đối với luồng (thread), hãy thử bắt đầu bằng 10 luồng, một email cho mỗi người dùng. Xin lưu ý rằng đề xuất luồng này sẽ có những điểm đánh đổi, và không hữu ích trong tất cả các tình huống API. Nếu số lượng yêu cầu quá lớn, lỗi hạn mức sẽ xảy ra. Một ví dụ khác về sự đánh đổi là hạn mức cho API kiểm tra email đối với tốc độ tải thư tối đa tổng thể lên. Tốc độ tải lên là một yêu cầu API – mỗi giây – trên mỗi người dùng, bất kể số lượng luồng thực hiện yêu cầu tải lên.

Đối với tất cả các lỗi dựa trên thời gian (tối đa N nội dung cho N giây mỗi luồng), đặc biệt là các lỗi mã trạng thái 503, bạn nên phát hiện trường hợp ngoại lệ và bằng cách sử dụng thuật toán thời gian đợi luỹ thừa, hãy đợi một chút chậm trễ trước khi thử lại lệnh gọi không thành công. Một ví dụ về API kiểm tra email cho một chuỗi là đợi 5 giây rồi thử gọi lại không thành công. Nếu yêu cầu thành công, hãy lặp lại mẫu này cho các luồng khác. Nếu yêu cầu thứ hai không thành công, ứng dụng của bạn sẽ phải điều chỉnh lại tần suất của yêu cầu cho đến khi cuộc gọi thành công. Ví dụ: tăng độ trễ 5 giây ban đầu lên 10 giây rồi thử gọi lại không thành công. Ngoài ra, bạn cũng có thể quyết định giới hạn thử lại. Ví dụ: thử yêu cầu lại từ 5 đến 7 lần với thời gian trễ khác nhau trước khi ứng dụng trả về lỗi cho người dùng.

Bảng sau đây liệt kê các giới hạn đối với API kiểm tra email:

Danh mục giới hạn API Các giới hạn

Tệp hộp thư đã mã hoá, tạo Quá trình tạo tệp hộp thư được mã hoá có thể mất vài ngày để hệ thống chuẩn bị, tuỳ thuộc vào kích thước.

Tệp hộp thư đã mã hoá, lỗi đã xoá Khi Xóa hộp thư được mã hóa và lỗi xảy ra, yêu cầu sẽ có trạng thái MARKED_DELETE. Các bản tóm tắt và xuất tệp này sẽ tự động được Google xoá lại trong vòng 24 giờ (với các tệp còn lại có thể). Nếu trạng thái của MARKED_DELETE được trả về nhất quán, hãy thử một chiến lược thời gian đợi luỹ thừa.

Danh mục giới hạn API	Các giới hạn
Tệp hộp thư đã mã hoá, tạo	Quá trình tạo tệp hộp thư được mã hoá có thể mất vài ngày để hệ thống chuẩn bị, tuỳ thuộc vào kích thước.
Tệp hộp thư đã mã hoá, lỗi đã xoá	Khi Xóa hộp thư được mã hóa và lỗi xảy ra, yêu cầu sẽ có trạng thái `MARKED_DELETE`. Các bản tóm tắt và xuất tệp này sẽ tự động được Google xoá lại trong vòng 24 giờ (với các tệp còn lại có thể). Nếu trạng thái của `MARKED_DELETE` được trả về nhất quán, hãy thử một chiến lược thời gian đợi luỹ thừa.

Bảng sau đây liệt kê hạn mức cho API Kiểm tra email:

Danh mục hạn mức API	Hạn mức
Mã thông báo xác thực ClientLogin	Có hiệu lực trong 24 giờ. Lỗi là `401 token expired`.
Định dạng ngày	Hãy chuyển đổi tất cả ngày tháng sang định dạng Phối hợp tiêu chuẩn quốc tế (UTC) trước khi sử dụng chúng với API Kiểm tra email để biết thêm thông tin, hãy xem bài viết Trình chuyển đổi UTC.
Tệp hộp thư được mã hoá, bản tóm tắt `EXPIRED` và tệp xuất	Google lưu giữ các tệp hộp thư đã mã hoá trong 3 tuần. Sau thời gian đó, chúng sẽ bị xoá. Quản trị viên miền có trách nhiệm tải các tệp hộp thư này xuống trong khoảng thời gian này.
Tệp hộp thư được mã hoá, định dạng	Các tệp hộp thư đã mã hoá có định dạng mbox.
Tệp hộp thư đã mã hoá, yêu cầu tạo tối đa	Tổng số yêu cầu tạo hộp thư xuất tối đa mỗi ngày là tổng cộng 100 yêu cầu từ tất cả quản trị viên trong miền.
Trạng thái của tệp hộp thư đã mã hoá, phân trang	Khi yêu cầu trạng thái của tất cả các yêu cầu hộp thư, phản hồi có thể trả về một lượng lớn dữ liệu. API Kiểm tra email gửi dữ liệu này thành nhiều trang, mỗi trang chứa tối đa 100 mục và URI trong thẻ `link rel='next'` trỏ đến trang kết quả tiếp theo. Khi phát triển ứng dụng, mã của bạn cần quản lý các kết quả bổ sung này.
Giám sát email	Số lượng yêu cầu giám sát email tối đa mỗi ngày là 1500. Giới hạn này là dành cho miền và bao gồm tất cả các yêu cầu do quản trị viên đưa ra trong ngày.
Khoá công khai	API kiểm tra email chỉ hỗ trợ một khoá. Khoá công khai này sử dụng phần mềm GNU Privacy Guard (GPG). Tệp có định dạng PGP và là khoá mã hoá RSA được mã hoá ASCII. Trước khi tải khoá công khai lên, bạn phải chuyển đổi khoá đó thành một chuỗi đã mã hoá base64. Tệp khóa công khai phải được đọc bằng bộ ký tự US- ASCII, (tên bộ ký tự ưu tiên cho Unicode).
Tìm kiếm	Các tham số `searchQuery` và `includeDeleted` loại trừ lẫn nhau. Không thể tìm kiếm truy vấn nếu `includeDeleted="true"`.