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