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

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

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

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

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

Следующие квоты применяются к Management API , Core Reporting API v3 , MCF Reporting API , Metadata API , User Deletion API и Real Time Reporting 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 Analytics позволяет:

  • 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 отчетов аналитики v4

Эти квоты применяются только к Analytics Reporting API v4 :

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

Вы можете просмотреть квоты вашего проекта в Google API Console .

Квота на основе ресурсов

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

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

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

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

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

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

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

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

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