Ограничения и квоты защищают инфраструктуру 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 токен истек". |
| Генерация открытых и закрытых ключей | Вместе с поставщиком удостоверений сгенерируйте набор открытых и закрытых ключей, используя алгоритмы DSA или RSA. Открытый ключ находится в сертификате в формате X.509. Дополнительные сведения о ключах подписи единого входа на основе SAML см. в разделе Создание ключей и сертификатов для службы единого входа Google Workspace . |
| Логотип | Файл изображения логотипа учетной записи может быть в формате JPEG, PNG или GIF. Рекомендуемый размер — 143 x 59 пикселей, размер файла не должен превышать 20 КБ. При использовании собственных логотипов не забывайте соблюдать Условия использования Google. И воздержитесь от использования логотипа Google, логотипа Gmail или любых других логотипов Google. Дополнительные сведения см. в разделе Политики в отношении логотипов и целевых страниц . |
| ssoБелый список | ssoWhitelist — это IP-адрес сетевой маски в формате бесклассовой междоменной маршрутизации (CIDR) . |
| Другие типы лимитов | Ограничения и рекомендации |
|---|---|
| Статус проверки записи MX | Статус проверки записи MX по умолчанию — «ложь», что означает, что либо система Google недавно не проверяла конфигурацию вашей записи MX, либо ваши записи MX не были настроены так, чтобы они указывали на системы Google. Если вы обновили свои записи, а статус проверки остается ложным, это может означать, что обновления ваших записей MX не были распространены или в записи есть опечатка. Для распространения рекомендуется подождать время, определяемое значением времени жизни (TTL) записи MX, и повторить попытку. |
| Коды стран | Если имя организации не было настроено, по умолчанию используется ваше основное доменное имя. Сведения о символах названия организации см. в разделе Использование символов . |
Свойство creationTime , числовое представление даты и времени | См. ISO 8601 , Числовое представление дат и времени. |
| Теги кодировки языка | См. языковые теги RFC 3066, принятые Google Mail. |
| Название организации | Если имя организации не было настроено, по умолчанию используется ваше основное доменное имя. Сведения о символах названия организации см. в разделе Использование символов . |