Ограничения и квоты на запросы к 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.

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

Analytics Reporting API версии 4

Квоты ниже относятся только к Analytics Reporting API версии 4.

  • Группа квот:
    • 50 000 запросов в сутки на проект.
    • 10 000 запросов в сутки на представление (профиль) (нельзя увеличить).
    • 2000 запросов за 100 секунд на проект.
    • 100 запросов за 100 секунд на пользователя и проект (можно увеличить до 1000 в Google API Console).
  • Запросы обнаружения:
    • 17 000 запросов за 100 секунд.

Узнать, какие квоты применяются к вашему проекту, можно в Google API Console.

Ресурсные квоты

В Analytics Reporting API версии 4 также действуют ресурсные квоты, которые предполагают более высокие пороги выборки для пользователей Аналитики 360.

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

Если лимит на количество запросов превышен, 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.

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