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

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 Reseller 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ả, dẫn đế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 cho trạng thái tổng thể của hệ thống Google Workspace. Việc này đả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.

Không gửi được yêu cầu API

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, ứng dụng của bạn sẽ nhận được một 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.

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 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ề Reseller API cho một luồng 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 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 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ụ: hãy 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 của bạn trả về lỗi cho người dùng.

Giới hạn

Các 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ã 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 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 đạ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. Một yêu cầu được coi là trái phép nếu không có mã uỷ quyền nào được cung cấp. Để 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à JavaScript Object Notation JSON.

JSON là một định dạng phổ biến trên Internet, cung cấp phương thức biểu thị 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ới ngôn ngữ nhưng sử dụng các quy ước quen thuộc với các lập trình viên thuộc họ ngôn ngữ C, bao gồm C, C++, C#, Java, JavaScript, Perl và Python.
Định dạng giờ Tất cả ngày giờ đều được tính bằng Bộ chuyển đổi thời gian bắt đầu của hệ thống theo mili giây. Định dạng này áp dụng cho các giá trị về 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 của gói dùng thử miễn phí 30 ngày.