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

В этой статье описываются ограничения и квоты на запросы к Management API и Reporting API.

Google Аналитика используется на огромном количестве сайтов. Чтобы защитить этот сервис от перегрузки и равномерно распределить его ресурсы, были установлены квоты – ограничения на количество запросов к API. Размер квот может меняться со временем.

В этом видео мы приводим рекомендации по управлению квотами на запросы к Google Analytics API.

Общие квоты

Для Management API, Core Reporting API версии 3, MCF Reporting API, Metadata API, User Deletion API и Real Time Reporting API установлены следующие квоты:

  • 50 000 запросов в сутки на один проект (можно увеличить).
  • 10 запросов в секунду на один IP-адрес.
    • В API Console предусмотрена аналогичная квота – запросов за 100 секунд на одного пользователя. По умолчанию она составляет 100, но может быть увеличена до 1000. Однако количество запросов к API на одного пользователя не может превышать 10 в секунду.
    • Если ваше приложение отправляет все запросы к API с одного IP-адреса (например, от лица сотрудников вашей компании), присваивайте запросам параметр userIP или quotaUser, чтобы для каждого пользователя была доступна полная квота на количество запросов в секунду. Подробнее о стандартных параметрах запроса

API для отчетов

Эти квоты распространяются на все Reporting API, включая Core Reporting API версии 3, Analytics Reporting API версии 4, Realtime API версии 3 и Multi-channel Funnel API версии 3:

  • 10 000 запросов в сутки на одно представление или профиль (нельзя увеличить).
  • 10 параллельных запросов на одно представление или профиль (нельзя увеличить).

Ошибки в запросах к Reporting API

Если выполнить запрос к Reporting API не удастся и будет возвращен код 500 или 503, отправьте запрос снова. Обратите внимание, что в Google Аналитике установлены следующие лимиты:

  • 10 неудачных запросов на один проект в каждом профиле за час.
  • 50 неудачных запросов на один проект в каждом профиле за сутки.

В случае превышения этих лимитов будет выдано сообщение об ошибке:

Quota Error: The number of recent failed writes is too high.

Рекомендуем реализовать для повторной отправки запросов алгоритм экспоненциальной выдержки.

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

Если лимит на количество запросов превышен, Google Analytics API возвращает код ошибки 403 или 429, а также сообщение о превышении квоты. Подробнее об этом рассказывается в Условиях использования.

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

Вы можете запросить увеличение только следующих квот:

Чтобы посмотреть или изменить квоты для проекта либо запросить их увеличение, выполните следующие действия:

  1. Если у вас нет платежного аккаунта для проекта, создайте его.
  2. В API Console откройте эту страницу и выберите API.
  3. Чтобы настроить квоты, нажмите Квоты. Если вас интересует статистика, выберите Использование.

Чтобы запросить увеличение квоты, заполните эту форму. Перед этим изучите информацию и выполните инструкции, указанные в форме запроса. Напоминаем, что Reporting API версии 4 в Google API Console называется Google Analytics Reporting API. Все остальные API версии 3 (Management API, Core Reporting API, Real Time Reporting API и др.) представлены в Google API Console под единым названием Analytics API.

Подробнее об управлении квотами и настройке приложения для их использования