Hạn mức và giới hạn giúp bảo vệ cơ sở hạ tầng của Google khỏi một quy trình tự động sử dụng Email Audit API 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ả không gây hại hoặc có thể là do một hệ thống được thiết kế không hiệu quả, khiến các lệnh gọi API không cần thiết. Bất kể nguyên nhân là gì, việc chặn lưu lượng truy cập từ một nguồn cụ thể khi lưu lượng truy cập đạt đến một mức nhất định là cần thiết để đảm bảo hệ thống Google Workspace hoạt động ổn định. 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ể ảnh hưởng tiêu cực đến cộng đồng lớn hơn.
Trong trường hợp không mong muốn là yêu cầu API của bạn không thành công, bạn sẽ nhận được phản hồi mã trạng thái HTTP. Mã trạng thái 403 có thông tin lỗi về dữ liệu đầ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 bạn đã 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à thực hiện hành động thích hợp.
Nếu các yêu cầu của bạn cần được hoàn tất trong một khoảng thời gian cố định, hãy gửi các yêu cầu song song hoặc sử dụng nhiều luồng trong ứng dụng Java hoặc C# của bạn. Ví dụ về các yêu cầu song song là yêu cầu các lô nhỏ email từ nhiều người dùng thay vì thêm hoặc xoá nhiều email của một người dùng cùng một lúc. Trong trường hợp có nhiều luồng, hãy thử bắt đầu với 10 luồng, mỗi luồng một email người dùng. Xin lưu ý rằng đề xuất về luồng có những điểm hạn chế và không hữu ích cho mọi trường hợp sử dụng API. Nếu số lượng yêu cầu quá cao, 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 Email Audit API về tốc độ tải lên thư tối đa nói chung. Tốc độ tải lên là một yêu cầu API – mỗi giây – mỗi người dùng, bất kể có bao nhiêu luồng đang 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 mục trong N giây cho mỗi luồng), đặc biệt là các lỗi mã trạng thái 503, bạn nên để mã của mình bắt ngoại lệ và bằng cách sử dụng thuật toán thời gian chờ luỹ tiến, hãy đợi một khoảng thời gian ngắn trước khi thử lại lệnh gọi không thành công. Ví dụ về Email Audit API cho một luồng là đợi 5 giây và thử lại lệnh gọ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 nên giảm tần suất yêu cầu cho đến khi một lệnh gọi thành công. Ví dụ: tăng độ trễ ban đầu từ 5 giây lên 10 giây và thử lại cuộc gọi không thành công. Ngoài ra, hãy quyết định số lần thử lại tối đa. Ví dụ: thử lại yêu cầu từ 5 đến 7 lần với các khoảng thời gian trễ khác nhau trước khi ứng dụng của bạn trả về lỗi cho người dùng.
Bảng sau đây liệt kê các hạn mức của Email Audit API:
| Danh mục giới hạn API | Giới hạn |
|---|---|
| Tạo tệp hộp thư đã mã hoá |
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ư được mã hoá, lỗi khi xoá |
Khi Xoá hộp thư được mã hoá và xảy ra lỗi, yêu cầu sẽ có trạng thái |
Bảng sau đây liệt kê hạn mức cho Email Audit API:
| 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à |
| Định dạng ngày |
Chuyển đổi tất cả ngày sang định dạng Giờ phối hợp quốc tế (UTC) trước khi sử dụng với Email Audit API. Để biết thêm thông tin, hãy xem Trình chuyển đổi UTC. |
|
Tệp hộp thư đã mã hoá, bản tóm tắt |
Google lưu giữ các tệp hộp thư đã mã hoá trong 3 tuần. Sau thời gian đó, các tệp này 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ư đã mã hoá, định dạng |
Các tệp hộp thư được mã hoá có định dạng mbox. |
| Tệp hộp thư được mã hoá, số lượng yêu cầu tạo tối đa |
Số lượng yêu cầu tạo tệp xuất hộp thư tối đa mỗi ngày là 100 yêu cầu của tất cả quản trị viên trong miền. |
| Trạng thái 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ư, các phản hồi có thể trả về một lượng lớn dữ liệu. Email Audit API sẽ chia dữ liệu này thành các trang, mỗi trang chứa tối đa 100 mục và một URI trong thẻ |
| Giám sát email |
Số lượng yêu cầu tối đa về tính năng giám sát email mỗi ngày là 1.500. Giới hạn này áp dụng cho miền và bao gồm tất cả yêu cầu do bất kỳ quản trị viên nào thực hiện trong ngày. |
| Khoá công khai |
Email Audit API chỉ hỗ trợ một khoá. Khoá công khai sử dụng phần mềm GNU Privacy Guard (GPG). Khoá này có định dạng PGP và là khoá mã hoá RSA được mã hoá bằng ASCII. Trước khi tải khoá công khai lên, trước tiên, bạn phải chuyển đổi khoá đó thành một chuỗi được mã hoá bằng base64. Tệp khoá công khai phải đọc bằng bộ ký tự US-ASCII (tên bộ ký tự ưu tiên IANA cho ASCII). |
| Tìm kiếm |
Các tham số |