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

Google Analytics применяет квоты к запросам к этим API управления:

Написать API

Эти квоты применяются к запросам на запись ( insert , update , patch и delete ):

  • 50 запросов на запись на проект в день, количество которых может быть увеличено
  • 1,5 запроса в секунду (QPS) на идентификатор учетной записи

Ошибки запроса записи

Если ваш запрос на запись не прошел и вы получили код ответа 500 или 503 , вы можете отправить его повторно. Google Analytics позволяет:

  • 50 неудачных запросов на запись в час.

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

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

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

API импорта данных

Эти квоты относятся к ресурсу Uploads :

  • Ограничения на объем хранилища для импорта данных с расширенным сроком службы (не относится к данным об обращениях, отправленным из API и SDK коллекции ):
  • 50 наборов данных на ресурс
  • 50 операций загрузки на ресурс в день
  • 1 ГБ на загруженный файл
  • Конкретные ограничения данных о расходах:
    • 100 МБ на дату ( ga:date ) на набор данных. Например, если вы импортируете 50 МБ данных за 10 октября 2014 года при одной загрузке и 50 МБ данных за 10 октября 2014 года при второй загрузке, вы достигнете предела в 100 МБ для 10 октября 2014 года для этого набора данных. .

API экспериментов

Эта квота применяется только к экспериментам :

  • 12 экспериментов за просмотр (профиль)

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

  • DRAFT
  • READY_TO_RUN
  • RUNNING

Эксперименты, завершенные (статус = ENDED ) более чем на один день, не учитываются в этой квоте.

API полных отчетов

Эти квоты применяются только к полным отчетам :

  • Запросы API на создание полных отчетов учитываются в общей квоте запросов на запись .
  • API использует ту же систему токенов для каждого ресурса и дня , которую веб-интерфейс использует для создания полных отчетов.
  • Максимально допустимое количество полных отчетов – 3 500. Когда этот предел достигнут, попытка создать дополнительные отчеты без выборки с помощью API приводит к следующей ошибке:
    Error creating this entity. You have reached the maximum allowed entities of this type.
    .

API разрешений пользователей

Эта квота применяется только к разрешениям пользователя :

  • У пользователя может быть не более 100 аккаунтов Analytics. Добавление пользователя, у которого есть 100 аккаунтов Google Analytics, в новый аккаунт, вызывает ошибку.

Следующие квоты применяются к пакетным запросам на запись ( delete , insert , update ) разрешений пользователя:

  • 300 запросов на запись прав пользователя на пакетный запрос
  • 30 групповых запросов на запись разрешений пользователей учитываются как 1 запрос на запись

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

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