Các giới hạn và hạn mức bảo vệ cơ sở hạ tầng của Google khỏi quy trình tự động sử dụng API Báo cáo theo cách không phù hợp. Việc một API gửi quá nhiều yêu cầu có thể dẫn đến lỗi chính tả vô 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 nguồn đó đạt đến một cấp nhất định là cần thiết để đảm bảo hoạt động chung của hệ thống Google Workspace. Giúp đảm bảo hành động của một nhà phát triển không thể gây ảnh hưở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 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 nhập không chính xác và mã trạng thái HTTP 503 có thông tin lỗi cho biết hạn mức API nào đã bị vượt quá. Những phản hồi này giúp ứng dụng tuỳ chỉnh của bạn phát hiện những lỗi này và có biện pháp xử lý thích hợp.
Nếu bạn cần hoàn tất yêu cầu 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#. Một ví dụ về yêu cầu song song là yêu cầu nhiều 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 lúc. Đối với chuỗi, hãy thử bắt đầu với 10 chuỗi, mỗi chuỗi 1 email người dùng. Lưu ý rằng đề xuất về luồng có một số đánh đổi và không hữu ích cho tất cả các trường hợp API. Nếu số lượng yêu cầu quá cao, lỗi hạn mức sẽ xảy ra.
Đối với tất cả các lỗi dựa trên thời gian (tối đa N lỗi trong N giây mỗi luồng), đặc biệt là lỗi mã trạng thái 503, bạn nên dùng mã để phát hiện 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 độ trễ nhỏ rồi thử lại lệnh gọi không thành công. Ví dụ về API Báo cáo cho một chuỗi là đợi 5 giây rồi 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 sẽ giảm tần suất 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ử lại cuộc gọi không thành công. Ngoài ra, hãy quyết định giới hạn thử lại. Ví dụ: thử lại một yêu cầu 5 đến 7 lần với các khoảng thời gian trễ khác nhau trước khi ứng dụng trả về lỗi cho người dùng.
| Danh mục giới hạn API | Giới hạn |
|---|---|
| Báo cáo tỷ lệ QPS và QPD | API này giới hạn số lượng yêu cầu cho dự án của bạn trên Google Cloud.
Giá trị mặc định trong bảng điều khiển của Google Cloud là 2.400 truy vấn/phút/người dùng/dự án trên Google Cloud.
Bạn có thể tăng hạn mức này trên trang Hạn mức API SDK dành cho quản trị viên trong dự án Google Cloud của mình.
Nếu vượt quá các giới hạn này, máy chủ sẽ trả về mã trạng thái HTTP 503. Sử dụng thuật toán thời gian đợi luỹ thừa khi thử lại các yêu cầu của bạn. |
| Danh mục hạn mức API | Hạn mức |
| kết quả tối đa | Số lượng bản ghi được liệt kê trong mỗi trang phản hồi của API là từ 1 đến 1000 sự kiện. Giá trị mặc định là 1000 bản ghi. |
| Các loại giới hạn khác | Giới hạn và nguyên tắc |
|---|---|
| Định dạng dữ liệu, mặc định | Định dạng dữ liệu mặc định là JSON. API này cũng hỗ trợ định dạng Atom. |
| Yêu cầu trái phép | Google không cho phép gửi các yêu cầu trái phép đối với API này. Yêu cầu sẽ bị coi là trái phép nếu bạn không cung cấp mã uỷ quyền. Để biết thêm thông tin, hãy xem bài viết Uỷ quyền cho yêu cầu. |
| Thông báo cảnh báo |
|