Ограничения и квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API настроек групп. Чрезмерное количество запросов от API может быть результатом безобидной опечатки или неэффективно спроектированной системы, которая выполняет ненужные вызовы API. Независимо от причины, блокировка трафика из определенного источника после достижения им определенного уровня необходима для общего состояния системы Google Workspace.
Ошибки запроса API
В том маловероятном случае, если ваш запрос API завершится неудачно, ваше приложение получит ответ с кодом состояния HTTP. Код состояния HTTP 403 содержит информацию об ошибке, указывающую, какие квоты API были превышены. Ответ позволяет вашему пользовательскому приложению обнаруживать ошибки и предпринимать соответствующие действия.
Запросы, чувствительные ко времени
Если ваши запросы необходимо выполнить в течение фиксированного периода времени, отправляйте их параллельно или используйте несколько потоков в приложении Java или C#. Например, разбейте свои запросы по месяцам или другому периоду времени. В случае с потоками попробуйте начать с 10 потоков, по одному потоку на запрос. Рекомендация по потоку имеет компромиссы и полезна не для всех ситуаций API. Если количество запросов становится слишком большим, возникают ошибки квоты.
Ошибки, основанные на времени
Для всех ошибок, основанных на времени (максимум N событий в течение X секунд на поток), особенно ошибок кода состояния 503 , мы рекомендуем, чтобы ваш код перехватывал исключение и, используя экспоненциальный алгоритм отсрочки , подождал небольшую задержку перед повторной попыткой. неудавшийся звонок. Пример API настроек групп для одного потока — подождать 5 секунд и повторить неудачный вызов. Если запрос успешен, повторите этот шаблон для других потоков. Если второй запрос не увенчался успехом, ваше приложение должно уменьшить частоту запроса до тех пор, пока вызов не будет успешным. Например, увеличьте начальную задержку в 5 секунд до 10 секунд и повторите неудачный вызов еще раз. Также определите лимит повторов. Например, повторите запрос 5–7 раз с разным временем задержки, прежде чем ваше приложение вернет пользователю ошибку.
Квоты
| Категории квот API | Квоты |
|---|---|
| Запросов в день | Вы можете делать до 100 000 запросов в день. Если вам нужна емкость, превышающая этот предел, вы можете отправить запрос со страницы «Квоты» в консоли Google Cloud. |
| Описание группы, максимальный размер | Вы можете ввести описание группы длиной до 4096 символов. |
| Название группы, максимальный размер | Имя группы может содержать до 60 символов. |
defaultMessageDenyNotificationText | Текст уведомления может содержать до 10 000 символов. Дополнительные сведения о свойстве defaultMessageDenyNotificationText см. в справочнике по API . |
maxMessageBytes | Максимальный размер сообщения по умолчанию составляет 1 МБ. Дополнительные сведения о свойстве maxMessageBytes см. в справочнике по API . |
Пределы
| Виды лимитов | Ограничения и рекомендации |
|---|---|
| Формат данных, по умолчанию | Формат данных по умолчанию — JSON. API также поддерживает формат Atom. Форматы данных JSON и Atom поддерживают полные возможности чтения и записи. Дополнительные сведения см. в разделе Форматы данных JSON и Atom . |
| API настроек групп, включение | Прежде чем вызывать API настроек групп, необходимо включить API каталога. Дополнительную информацию см. в разделе Включение API Google Workspace. |