Ограничения и квоты использования

Ограничения и квоты защищают инфраструктуру Google от автоматизированных процессов, использующих API настроек администратора ненадлежащим образом. Чрезмерное количество запросов к API может быть результатом безобидной опечатки или неэффективной работы системы, выполняющей ненужные вызовы API. Независимо от причины, блокировка трафика из определенного источника после достижения им определенного уровня необходима для общей работоспособности системы Google Workspace. Это гарантирует, что действия одного разработчика не смогут негативно повлиять на всё сообщество.

В маловероятном случае, если ваш API-запрос не удастся, вы получите ответ с кодом состояния HTTP. Код состояния 403 содержит информацию об ошибке, связанной с некорректными входными данными, а код состояния HTTP 503 содержит информацию об ошибке, указывающую на превышение квот API. Эти ответы позволяют вашему пользовательскому приложению обнаруживать эти ошибки и предпринимать соответствующие действия.

Если ваши запросы должны быть выполнены за фиксированный период времени, отправляйте их параллельно или используйте несколько потоков в вашем Java- или C#-приложении. Например, разбейте запросы по месяцам или другому временному периоду. В случае использования потоков попробуйте начать с 10 потоков, по одному потоку на каждый запрос. Обратите внимание, что рекомендация по количеству потоков имеет свои компромиссы и не подходит для всех ситуаций с API. Если количество запросов станет слишком большим, возникнут ошибки квотирования.

Для всех ошибок, связанных со временем (максимум N событий в течение X секунд на поток), особенно ошибок с кодом состояния 503, мы рекомендуем вашему коду перехватывать исключение и, используя алгоритм экспоненциальной задержки , ждать небольшую паузу перед повторной попыткой неудачного вызова. Например, в случае с API настроек электронной почты для одного потока следует подождать 5 секунд и повторить неудачный вызов. Если запрос успешен, повторите этот шаблон для других потоков. Если второй запрос не удался, ваше приложение должно уменьшить частоту запросов до тех пор, пока вызов не будет успешным. Например, увеличьте начальную задержку в 5 секунд до 10 секунд и повторите неудачный вызов снова. Также определите лимит повторных попыток. Например, повторите запрос от 5 до 7 раз с разным временем задержки, прежде чем ваше приложение вернет пользователю ошибку.

Категории квот API Квоты
Токены аутентификации ClientLogin Действителен в течение 24 часов. Ошибка: '401 token expired'.
Генерация открытых и закрытых ключей

С помощью вашего поставщика удостоверений сгенерируйте набор открытых и закрытых ключей, используя алгоритмы 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. Если вы обновили свои записи, а статус проверки остается `false`, это может означать, что обновления ваших MX-записей не были распространены или в записи есть опечатка. Для распространения обновлений мы рекомендуем подождать время, определенное значением `Time To Live` (TTL) для MX-записи, и повторить попытку.

коды стран

Если название организации не было изменено, по умолчанию используется ваше основное доменное имя. Информацию о символах в названии организации см. в разделе «Использование символов» .

Свойство creationTime , числовое представление дат и времени.

См. стандарт ISO 8601 «Числовое представление дат и времени».

Теги кодировки языка

См. языковые теги RFC 3066, принимаемые Google Mail.

Название организации

Если название организации не было изменено, по умолчанию используется ваше основное доменное имя. Информацию о символах в названии организации см. в разделе «Использование символов» .

Запросить увеличение квоты по каждому проекту.

В зависимости от объема используемых ресурсов вашего проекта, вам может потребоваться запросить корректировку квоты. Вызовы API, выполняемые сервисным аккаунтом, считаются использованием одного аккаунта. Подача заявки на корректировку квоты не гарантирует ее одобрения. Запросы на корректировку квоты, которые значительно увеличат ее значение, могут обрабатываться дольше.

Не все проекты имеют одинаковые квоты. По мере того, как вы будете все больше использовать Google Cloud, значения ваших квот могут потребовать увеличения. Если вы ожидаете значительного увеличения использования в будущем, вы можете заблаговременно запросить корректировку квот на странице «Квоты» в консоли Google Cloud.

Для получения более подробной информации ознакомьтесь со следующими ресурсами: