Ограничения и квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API Enterprise License Manager. Чрезмерные запросы от API могут быть результатом безобидной опечатки или неэффективно спроектированной системы, которая выполняет ненужные вызовы API. Независимо от причины, блокировка трафика из определенного источника после достижения им определенного уровня необходима для общего состояния системы Google Workspace. Это гарантирует, что действия одного разработчика не смогут негативно повлиять на более широкое сообщество.
В том маловероятном случае, если ваш запрос API завершится неудачей, вы получите ответ с кодом состояния HTTP. Код состояния 403 содержит информацию об ошибке неправильного ввода, а код состояния HTTP 503 содержит информацию об ошибке, указывающую, какие квоты API были превышены. Эти ответы позволяют вашему пользовательскому приложению обнаружить эти ошибки и предпринять соответствующие действия.
Если ваши запросы необходимо выполнить в течение фиксированного периода времени, отправляйте их пакетно . В зависимости от цели вашего API и если количество запросов станет слишком большим, возникнут ошибки квоты.
Если вы не можете использовать рекомендуемую функцию пакетных запросов API, используйте алгоритм экспоненциальной отсрочки. Для всех ошибок, основанных на времени (максимум N событий в течение X секунд на поток), особенно ошибок кода состояния 503, мы рекомендуем вашему коду перехватить исключение и, используя алгоритм экспоненциальной задержки , подождать небольшую задержку, прежде чем повторить неудачную попытку. вызов. Пример API Enterprise License Manager для одного потока — подождать 5 секунд и повторить неудачный вызов. Если запрос успешен, повторите этот шаблон для других потоков. Если второй запрос не увенчался успехом, ваше приложение должно уменьшить частоту запроса до тех пор, пока вызов не будет успешным. Например, увеличьте начальную задержку в 5 секунд до 10 секунд и повторите неудачный вызов еще раз. Также определите лимит повторов. Например, повторите запрос 5–7 раз с разным временем задержки, прежде чем ваше приложение вернет пользователю ошибку.
| Категории квот API | Квоты |
|---|---|
| Запросов в секунду (QPS) | Квота QPS равна 1. |
| Категории ограничений API | Пределы |
|---|---|
| строка запроса maxResults | Максимальный размер maxResults — 100. |
| Другие типы лимитов | Ограничения и рекомендации |
|---|---|
| Пакетные запросы | API поддерживает отправку пакетных запросов . |
| Формат данных в ответах API | Формат данных ответа — нотация объектов Javascript ( JSON ). |
| Включение API Enterprise License Manager | API обеспечения необходимо включить перед вызовами API Enterprise License Manager. В панели управления перейдите на страницу настроек вкладки «Пользователи и группы» и включите API предоставления. Сохраните изменения. Кроме того, необходимо включить и активировать службу групп Google. |
| Несанкционированные запросы | API не принимает несанкционированные запросы. Запрос считается неавторизованным, если не предоставлен токен авторизации. Дополнительную информацию см. в разделе Авторизация запросов. . |