Ограничения и квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API реселлеров. Чрезмерное количество запросов может быть результатом опечатки или неэффективной архитектуры системы. Для обеспечения работоспособности системы Google Workspace Google блокирует трафик из определенных источников, когда он достигает определенного уровня. Это гарантирует, что действия одного разработчика не окажут негативного влияния на сообщество.
Сбои запросов API
Если запрос к API завершается неудачей, ваше приложение получает код состояния HTTP. Код состояния 403 указывает на некорректные входные данные, а код состояния 503 — на превышение квот API. Используйте эти ответы для обнаружения ошибок и принятия соответствующих мер.
Ошибки, зависящие от времени
Для ошибок, связанных со временем, особенно с кодами состояния 503 , используйте алгоритм экспоненциальной задержки . Подождите небольшую паузу, прежде чем повторять неудачный вызов. Например, подождите 5 секунд и повторите попытку. В случае успеха повторите шаблон для других потоков. Если второй запрос не удался, уменьшите частоту запросов, пока один из вызовов не будет успешным. Также рекомендуется установить ограничение на количество повторных попыток, например, от 5 до 7 раз.
Пределы
| Категории ограничений API | Пределы |
|---|---|
purchaseOrderId на подписку | Данное свойство допускает до 80 символов обычного текста. |
Subscription maxResults | В строке запроса maxResults может быть от 1 до 100 результатов. Значение по умолчанию — 20 результатов. |
Токен для передачи ( customerAuthToken ) | Срок действия токена перевода клиента составляет 30 дней с момента его генерации. |
| Максимальное количество пользователей для клиента | В зависимости от условий вашего договора, максимальное количество пользователей может составлять 50 000 или максимальное количество, указанное в вашем договоре с реселлером. |
| Несанкционированные запросы | Google не разрешает несанкционированные запросы к API реселлеров. Запрос считается несанкционированным, если не предоставлен токен авторизации. Для получения дополнительной информации см. раздел «Подробнее об аутентификации и авторизации» . |
Другие типы ограничений
| Другие типы ограничений | Ограничения и рекомендации |
|---|---|
| Формат данных | Формат данных — JavaScript Object Notation ( JSON ). JSON — это распространённый в интернете формат для представления произвольных структур данных. Это независимый от языка текстовый формат, использующий соглашения, знакомые программистам, работающим с языками семейства C, включая C, C++, C#, Java, JavaScript, Perl и Python. |
| Формат времени | Для указания дат и времени используется конвертер Epoch в миллисекунды. Этот формат применяется ко времени создания подписки, времени начала и окончания действия тарифного плана, а также времени окончания бесплатного пробного периода. |