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

В этой статье описываются ограничения и квоты на запросы к Management API и Reporting API.

Google Analytics используется на огромном количестве сайтов. Чтобы защитить этот сервис от перегрузки и равномерно распределить его ресурсы, были установлены квоты – ограничения на количество запросов к API. Размер квот может меняться со временем.

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

Общие квоты

Для Management API, Core Reporting API версии 3, MCF Reporting API, Metadata API и Real Time Reporting API установлены следующие квоты:

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

Management API

В Google Analytics применяются квоты на запросы к следующим Management API:

Write API

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

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

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

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

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

В случае его превышения вы получите следующее сообщение об ошибке:

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

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

Data Import API

Перечисленные ниже квоты действуют в отношении ресурса Uploads.

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

Experiments API

Эта квота действует только в отношении экспериментов:

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

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

  • DRAFT
  • READY_TO_RUN
  • RUNNING

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

Unsampled Reports API

Эти квоты действуют только в отношении полных отчетов:

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

User Permission API

Эта квота действует в отношении разрешений пользователей:

  • 100 аккаунтов Analytics на одного пользователя. Если добавить пользователя, у которого больше аккаунтов, происходит ошибка.

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

  • 300 запросов в одном пакетированном запросе.
  • 30 пакетированных запросов засчитываются как 1 запрос на запись.

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

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

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