Hạn mức và giới hạn giúp bảo vệ cơ sở hạ tầng của Google khỏi các quy trình tự động sử dụng API Đại lý một cách không phù hợp. Yêu cầu quá mức có thể là do lỗi chính tả hoặc thiết kế hệ thống không hiệu quả. Để đảm bảo hệ thống Google Workspace hoạt động ổn định, Google sẽ chặn lưu lượng truy cập từ một số nguồn cụ thể khi lưu lượng truy cập đạt đến một số mức nhất định. Điều này giúp đảm bảo rằng hành động của một nhà phát triển không ảnh hưởng tiêu cực đến cộng đồng.
Yêu cầu API không thành công
Nếu một yêu cầu API không thành công, ứng dụng của bạn sẽ nhận được một mã trạng thái HTTP. Mã trạng thái 403 cho biết dữ liệu đầu vào không chính xác và mã trạng thái 503 cho biết bạn đã vượt quá hạn mức API. Dùng các phản hồi này để phát hiện lỗi và thực hiện hành động.
Lỗi dựa trên thời gian
Đối với các lỗi dựa trên thời gian, đặc biệt là mã trạng thái 503, hãy sử dụng thuật toán thời gian chờ luỹ tiến. Chờ một khoảng thời gian ngắn rồi thử lại cuộc gọi không thành công. Ví dụ: đợi 5 giây rồi thử lại. Nế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, hãy giảm tần suất yêu cầu cho đến khi một lệnh gọi thành công. Bạn cũng nên quyết định số lần thử lại, chẳng hạn như từ 5 đến 7 lần.
Giới hạn
| Danh mục giới hạn API | Giới hạn |
|---|---|
Gói thuê bao purchaseOrderId |
Thuộc tính này chấp nhận tối đa 80 ký tự văn bản thuần tuý. |
Gói thuê bao maxResults |
Chuỗi truy vấn maxResults có thể có từ 1 đến 100 kết quả.
Giá trị mặc định là 20 kết quả.
|
Mã chuyển (customerAuthToken) |
Mã chuyển của khách hàng có hiệu lực trong 30 ngày sau khi được tạo. |
| Số người dùng tối đa cho một khách hàng | Tuỳ thuộc vào hợp đồng của bạn, số lượng người dùng tối đa có thể là 50.000 hoặc số lượng tối đa được xác định trong hợp đồng của bạn với đại lý. |
| Yêu cầu trái phép | Google không cho phép các yêu cầu trái phép đối với Reseller API. Yêu cầu sẽ không được uỷ quyền nếu bạn không cung cấp mã uỷ quyền. Để biết thêm thông tin, hãy xem phần Tìm hiểu về quy trình xác thực và uỷ quyền. |
Các loại hạn mức khác
| Các loại hạn mức khác | Giới hạn và nguyên tắc |
|---|---|
| Định dạng dữ liệu |
Định dạng dữ liệu là Ký hiệu đối tượng JavaScript (JSON).
JSON là một định dạng phổ biến trên Internet để trình bày các cấu trúc dữ liệu tuỳ ý. Đây là một định dạng văn bản độc lập với ngôn ngữ, sử dụng các quy ước quen thuộc với lập trình viên của họ ngôn ngữ C, bao gồm C, C++, C#, Java, JavaScript, Perl và Python. |
| Định dạng giờ | Ngày và giờ sử dụng trình chuyển đổi Epoch tính bằng mili giây. Định dạng này áp dụng cho thời gian tạo gói thuê bao, thời gian bắt đầu và kết thúc cam kết của gói, cũng như thời gian kết thúc thời gian dùng thử miễn phí. |