Квоты

Квоты защищают инфраструктуру Google от автоматизированных процессов, которые ненадлежащим образом используют API Менеджера кампаний 360. Они гарантируют, что действия одного разработчика не могут негативно повлиять на более широкое сообщество.

Пределы квоты

Следующие квоты по умолчанию являются общими для всех ресурсов и методов API Менеджера кампаний 360.

  • 50 000 запросов на проект в день - можно увеличить .
  • 1 запрос в секунду (QPS) на проект.
    • В Google API Console эта квота называется запросами в минуту на пользователя и по умолчанию установлена ​​на 60. Этот лимит может быть увеличен по мере необходимости, максимум до 600 (10 запросов в секунду).

Построитель отчетов применяет дополнительные ограничения квоты, которые зависят от учетной записи. Дополнительные сведения см. в этой статье Справочного центра и в таблице ниже.

Превышение квоты

В том маловероятном случае, когда ваш запрос не будет выполнен из-за превышения квоты, API возвращает код состояния HTTP и причину ошибки. Кроме того, тело ответа содержит подробное описание причины ошибки. См. руководство по сообщениям об ошибках для примера ответа на ошибку.

В следующем списке показаны возможные ошибки и рекомендуемые действия при сбоях запросов, вызванных превышением квоты.

Код Причина Сообщение Рекомендованное действие
403 dailyLimitExceeded Дневной лимит превышен Не повторяйте попытку, не устранив проблему. Изучите свое использование с помощью Google API Console и измените свой рабочий процесс, чтобы делать меньше запросов. Вы можете запросить дополнительную квоту, если считаете, что ваше использование разумно.
403 квота превышена В этом аккаунте превышена квота на x отчетов в день. Не пытайтесь больше запускать отчеты для этой учетной записи в этот день. Обратитесь за помощью к менеджеру своего аккаунта.
403 квота превышена Этот профиль пользователя превысил квоту на x отчетов в день. Не пытайтесь больше запускать отчеты для этого профиля пользователя в этот день. Переключитесь на другой профиль пользователя или обратитесь за помощью к менеджеру своего аккаунта.
403 квота превышена В этой учетной записи превышена квота на x активных запланированных отчетов. Деактивируйте запланированные отчеты, которые вам не нужны, прежде чем повторять этот запрос.
403 квота превышена Профиль пользователя, которому принадлежит этот отчет, превысил свою квоту x активных запланированных отчетов. Попросите владельца этого отчета деактивировать запланированные отчеты, которые ему не нужны, прежде чем повторять запрос.
403 квота превышена Этот профиль пользователя превысил свою квоту x активных запланированных отчетов. Деактивируйте запланированные отчеты, которые вам не нужны, прежде чем повторять этот запрос.
403 квота превышена Невозможно выполнить это действие, так как превышена одна из ваших квот. Обратитесь за помощью к вашему менеджеру аккаунта. Обратитесь за помощью к менеджеру своего аккаунта.
403 userRateLimitExceeded Превышен предел скорости пользователя Увеличьте лимит на пользователя в Google API Console или уменьшите скорость отправки запросов с помощью экспоненциальной отсрочки . Не рекомендуется делать одновременные запросы на запись или использовать ограничение скорости выше 10 запросов в секунду с этим API.

Запрос дополнительной дневной квоты

Если вы считаете, что для вашего приложения требуется дополнительная дневная квота, вы можете запросить ее, следуя приведенным ниже инструкциям.

Следующие инструкции применимы только к проектам, в которых возникла ошибка dailyLimitExceeded . Рекомендуемые действия для других ошибок квот приведены в таблице выше .

  1. Перейдите к API Менеджера кампаний 360 в консоли Google API.
  2. Просмотрите статистику использования на странице «Метрики» , чтобы убедиться, что ваше приложение работает должным образом. Прежде чем продолжить, обратите особое внимание на методы, которые были вызваны, и устраните их неожиданное или чрезмерное использование.
  3. Если использование выглядит нормальным, перейдите на страницу «Квоты» , щелкните значок редактирования рядом с «Запросов в день» и щелкните ссылку «Подать заявку на увеличение квоты».

Обязательно ознакомьтесь с информацией и следуйте инструкциям, включенным в форму запроса квоты, прежде чем отправлять запрос на увеличение.