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

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

Написание API

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

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

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

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

  • 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 МБ данных за 2014 октября за вторую загрузку, вы достигли предела в 100 МБ за 10 октября 2014 г. для этого набора данных. .

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

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

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

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

  • DRAFT
  • READY_TO_RUN
  • RUNNING

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

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

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

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

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

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

  • Пользователь может иметь не более 100 аккаунтов Google 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 — Google Analytics Reporting API . Все остальные API v3 (например, Management API v3, Core Reporting API v3, API отчетов в реальном времени v3, API удаления пользователей v3) перечислены в разделе Analytics API в консоли Google API.

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