Giới hạn và hạn mức

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 Enterprise License Manager theo cách không phù hợp. Việc đưa ra quá nhiều yêu cầu 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 bạn thực hiện các lệnh gọi API không cần thiết. Bất kể nguyên nhân là gì, bạn đều cần chặn lưu lượng truy cập từ một nguồn cụ thể khi nó đạt đến một mức nhất định để đảm bảo tình trạng chung của hệ thống Google Workspace. Quy trình này đảm bảo rằng hành động của một nhà phát triển không được ả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 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ề thông tin đầ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 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.

Nếu các yêu cầu của bạn cần được hoàn thành trong một khoảng thời gian cố định, hãy gửi các yêu cầu được nhóm với nhau. Tuỳ thuộc vào mục đích của API và nếu số lượng yêu cầu quá cao, sẽ xảy ra lỗi hạn mức.

Nếu bạn không thể sử dụng tính năng yêu cầu theo lô API được đề xuất, hãy sử dụng thuật toán thời gian đợi luỹ thừa. Đối với tất cả các lỗi dựa trên thời gian (tối đa N thứ trong X 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à sử dụng thuật toán thời gian đợi luỹ thừa, đợi một độ trễ nhỏ trước khi thử lại lệnh gọi không thành công. Ví dụ về API Enterprise License Manager cho một luồng là chờ 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 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.

Danh mục hạn mức API	Hạn mức
Số truy vấn mỗi giây (QPS)	Hạn mức QPS là 1.

Danh mục giới hạn API	Giới hạn
Chuỗi truy vấn maxResults	Kích thước tối đa của maxResults là 100.

Các loại giới hạn khác	Giới hạn và nguyên tắc
Yêu cầu theo lô	API hỗ trợ gửi các yêu cầu hàng loạt.
Định dạng dữ liệu trong phản hồi của API	Định dạng dữ liệu của phản hồi là JavaScript Object Notation (JSON).
Bật Enterprise License Manager API	Bạn phải bật API cấp phép trước khi thực hiện lệnh gọi tới API trình quản lý giấy phép doanh nghiệp. Trong bảng điều khiển của bạn, hãy truy cập trang Cài đặt của thẻ Người dùng và nhóm và bật API cấp phép. Lưu các thay đổi. Ngoài ra, dịch vụ Google Groups phải được bật và kích hoạt.
Yêu cầu trái phép	API không chấp nhận bất kỳ yêu cầu trái phép nào. 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 Uỷ quyền yêu cầu.