Ограничения и квоты защищают инфраструктуру Google от автоматических процессов, которые используют Admin Settings API ненадлежащим образом. Чрезмерное количество запросов от API может быть результатом безобидной опечатки или неэффективно спроектированной системы, которая делает ненужные вызовы API. Независимо от причины, блокировка трафика из определенного источника после достижения определенного уровня необходима для общей работоспособности системы Google Workspace. Это гарантирует, что действия одного разработчика не смогут негативно повлиять на сообщество в целом.
Если запрос к API не будет выполнен, вы получите код статуса HTTP. Код статуса 403 содержит информацию об ошибке, связанной с неверными входными данными, а код статуса HTTP 503 – информацию о том, какие квоты API были превышены. Эти ответы позволяют вашему приложению обнаруживать ошибки и принимать соответствующие меры.
Если запросы должны быть выполнены в течение фиксированного периода времени, отправляйте их параллельно или используйте несколько потоков в приложении Java или C#. Например, разбейте запросы по месяцам или другим периодам времени. Если вы используете потоки, начните с 10 потоков (один поток на запрос). Обратите внимание, что рекомендация по потокам имеет компромиссы и полезна не для всех ситуаций API. Если количество запросов слишком велико, возникнут ошибки квоты.
При возникновении ошибок, связанных со временем (максимум N объектов за X секунд на поток), особенно ошибок с кодом статуса 503, рекомендуем перехватывать исключение и, используя алгоритм экспоненциальной выдержки, повторять вызов через небольшой промежуток времени. Например, в случае с Email Settings API можно подождать пять секунд и повторить неудачный вызов. Если запрос выполнен успешно, повторите этот шаблон для других цепочек. Если второй запрос не будет выполнен, приложение должно снизить частоту запросов, пока вызов не будет выполнен успешно. Например, увеличьте начальную задержку с 5 до 10 секунд и повторите неудачный вызов. Также определите лимит повторных попыток. Например, повторите запрос 5–7 раз с разными задержками, прежде чем приложение вернет пользователю ошибку.
| Категории квот API | Квоты |
|---|---|
| Токены аутентификации ClientLogin | Действует 24 часа. Ошибка 401: срок действия токена истек. |
| Как создать открытый и закрытый ключи |
С помощью поставщика идентификационной информации создайте набор открытых и закрытых ключей, используя алгоритм DSA или RSA. Открытый ключ находится в сертификате формата X.509. Дополнительную информацию о ключах подписи для системы единого входа на базе SAML можно найти в статье Как создать ключи и сертификаты для системы единого входа Google Workspace. |
| Логотип |
Файл логотипа аккаунта может быть в формате JPEG, PNG или GIF. Рекомендуемый размер – 143 x 59 пикселей, а размер файла не должен превышать 20 КБ. При использовании собственных логотипов не забывайте соблюдать Условия использования Google. Не используйте логотипы Google, Gmail и любые другие эмблемы Google в своем логотипе. Подробнее о правилах в отношении логотипов и целевых страниц… |
| ssoWhitelist |
ssoWhitelist – это IP-адрес маски сети в формате бесклассовой адресации (CIDR). |
| Другие типы ограничений | Ограничения и рекомендации |
|---|---|
| Статус проверки записи MX |
По умолчанию для статуса проверки записи MX задано значение false. Это означает, что либо система Google не проверяла конфигурацию записи MX в последнее время, либо записи MX не настроены так, чтобы указывать на системы Google. Если вы обновили записи, но статус подтверждения не изменился, возможно, изменения ещё не вступили в силу или в записи есть опечатка. Рекомендуем подождать, пока изменения вступят в силу. Это может занять столько времени, сколько указано в значении TTL (Time To Live) записи MX. |
| Коды стран |
Если название организации не было изменено, по умолчанию используется имя основного домена. Подробнее об использовании символов… |
Свойство creationTime, числовое представление дат и времени |
Подробную информацию вы найдете в статье ISO 8601. |
| Теги кодировки языка |
Ознакомьтесь с языковыми тегами RFC 3066, которые поддерживаются в Google Mail. |
| Название организации |
Если название организации не было изменено, по умолчанию используется имя основного домена. Подробнее об использовании символов… |
Как запросить увеличение квоты для проекта
В зависимости от особенностей использования ресурсов в проекте может возникнуть необходимость запросить корректировку квоты. Вызовы API, выполняемые сервисным аккаунтом, считаются вызовами, выполняемыми одним аккаунтом. Запрос на изменение квоты может быть отклонен. Для одобрения запросов на значительное увеличение квот может потребоваться больше времени.
Квоты для разных проектов могут различаться. По мере того как вы будете все больше использовать Google Cloud, вам может потребоваться увеличить квоты. Если вы ожидаете значительного увеличения использования, вы можете заранее запросить корректировку квот на странице Quotas & System Limits (Квоты и системные ограничения) в консоли Google Cloud.
Дополнительную информацию можно найти в следующих ресурсах: