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

В этом документе описаны ограничения и квоты на запросы API управления и API отчетов.

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

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

Общие лимиты квот

Следующие квоты применяются к Management API , Core Reporting API v3 , MCF Reporting API , Metadata API , API удаления пользователей и API отчетов в реальном времени :

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

API отчетности

Следующие квоты применяются ко всем API отчетов, включая Core Reporting API v3 , Analytics Reporting API v4 , Real Time API v3 и Multi-channel Funnel API v3 :

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

Отчеты об ошибках запросов API

Если ваш запрос к Reporting API завершается ошибкой сервера, вы получаете код ответа 500 или 503 . Вы можете повторно отправить запрос; однако не отправляйте этот запрос повторно более одного раза, если он неоднократно терпит неудачу. Google Аналитика позволяет:

  • 10 неудачных запросов сервера по ошибке на проект на просмотр (профиль) в час
  • 50 неудачных запросов сервера на проект на просмотр (профиль) в день

Если количество неудачных запросов превышает эти квоты, вы получите следующую ошибку:

Quota Error: The number of recent reporting API requests failing by server error is too high.
You are temporarily blocked from the reporting API for at least an hour.
Please send fewer server errors in the future to avoid being blocked.

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

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

Квоты частоты ошибок сервера применяются в течение промежутков времени для каждой из ежечасных и ежедневных квот частоты ошибок. Через час после первой ошибки сервера пары проекта и представления квота сбрасывается. Если пара проекта и представления отправляет 10 ошибок сервера в течение одного часа, пара проекта и представления блокируется от API до тех пор, пока не пройдет час после истечения первой ошибки сервера.

Например, если пара проекта и представления не отправляла ошибку сервера за последние 24 часа, этот проект и представление будут использовать 0 из 50 квот. Допустим, этот проект и представление теперь отправляют ошибку сервера в 6:12 утра. Если этот проект и представление отправят 49 дополнительных ошибок сервера до 6:12 следующего дня, этот проект и представление будут заблокированы до 6:12 следующего дня. На следующий день в 6:12 квота частоты ошибок сервера будет полностью сброшена для этого проекта и просмотра.

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

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

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

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

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

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

Чтобы запросить увеличение максимальной суммы квоты, воспользуйтесь формой запроса квоты Analytics API . Обязательно проверьте информацию и следуйте инструкциям в форме запроса квоты перед отправкой запроса. Для Reporting API v4 имя API в консоли Google API — Google Analytics Reporting API . Все остальные API версии 3 (например, Management API v3, Core Reporting API v3, API отчетов в реальном времени v3, API удаления пользователей v3) перечислены в разделе Analytics API в консоли Google API.

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