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 Đại lý theo cách không phù hợp. Việc đưa ra quá nhiều yêu cầu từ một API 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 mức nhất định là điều cần thiết để đảm bảo tình trạng chung của hệ thống Google Workspace. Phương thức này đảm bảo rằng 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.
Yêu cầu API không thành công
Trong trường hợp hiếm gặp là yêu cầu API không thành công, ứng dụng sẽ nhận được phản hồi của mã trạng thái HTTP. Mã trạng thái của 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 của 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 cho phé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.
Lỗi dựa trên thời gian
Đối với tất cả các lỗi dựa trên thời gian (tối đa N giây trong N giây trên mỗi luồng), đặc biệt là lỗi mã trạng thái 503, bạn nên dùng mã của mình để 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, đợi một khoảng thời gian trễ ngắn trước khi thử lại lệnh gọi không thành công. Ví dụ về API của Đại lý 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 sẽ giảm tần suất yêu cầu cho đến khi lệnh 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 lệnh gọi không thành công. Ngoài ra, hãy quyết định giới hạn số lần thử lại.
Ví dụ: thử lại một 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 trả về lỗi cho người dùng.
Giới hạn
| Danh mục giới hạn API | Giới hạn |
|---|---|
Gói thuê bao purchaseOrderId |
Cơ sở lưu trú 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ể từ 1 đến 100 kết quả.
Giá trị mặc định là 20 kết quả.
|
Mã thông báo chuyển (customerAuthToken) |
Mã chuyển của khách hàng có hiệu lực trong 30 ngày kể từ 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ố người dùng tối đa có thể là 50.000 hoặc số người dùng tối đa được xác định trong hợp đồng 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 gửi đến API đại lý. Yêu cầu được coi là trái phép nếu bạn không cung cấp mã thông báo 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 giới hạn khác
| 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 |
Định dạng dữ liệu là JSON của JavaScript Object Notation.
JSON là một định dạng Internet phổ biến trên Internet cung cấp phương thức trình bày các cấu trúc dữ liệu tuỳ ý. JSON là một định dạng văn bản hoàn toàn độc lập về ngôn ngữ nhưng sử dụng các quy ước quen thuộc với lập trình viên thuộc họ ngôn ngữ C, bao gồm cả C, C++, C#, Java, JavaScript, Perl và Python. |
| Định dạng thời gian | Tất cả ngày giờ đều tính bằng mili giây trong Trình chuyển đổi Epoch. Định dạng này áp dụng cho các giá trị 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 gói dùng thử miễn phí 30 ngày. |