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

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

Обзор

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

В этом видео рассматриваются общие квоты Google Analytics API, а также специфические квоты Management API и Reporting API.

Общие квоты

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

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

Management API

Запросы на запись

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

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

Если при реализации алгоритма экспоненциальной задержки возвращается ответ 500 или 503, попытку запроса можно повторить. Эта квота предусмотрена для неудачных запросов на запись:

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

Импорт данных

В отношении ресурса Uploads действуют следующие квоты:

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

Эксперименты

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

  • 12 экспериментов на представление (профиль). При этом учитываются эксперименты со следующими значениями параметра status: DRAFT, READY_TO_RUN и RUNNING. В эту квоту не включаются эксперименты, которые в течение нескольких дней имеют статус ENDED.

Полные отчеты

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

  • Создание полного отчета учитывается в рамках общей квоты в отношении запросов на запись.
  • В API используется тот же принцип выдачи токенов на день и на ресурс, что и при создании полного отчета в веб-интерфейсе.

Разрешения пользователя

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

  • 100 связанных аккаунтов на одного пользователя.

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

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

Provisioning API

Запросы на запись

Эта квота действует в отношении запросов на запись (например, createAccountTicket) для Provisioning API:

  • 50 запросов в день на один проект.

Reporting API

Эти квоты распространяются на все API отчетности, включая Core Reporting API, Realtime API, Multi-channel Funnel API версии 3 и Analytics Reporting API версии 4:

  • 10 000 запросов в день на представление (профиль).
  • 10 параллельных запросов на представление (профиль).

Ошибки в отчетах

Эти квоты действуют в отношении ошибок в запросах отчетов (5XX):

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

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

По любым запросам сверх лимита API Google Analytics возвращает ошибку Код статуса HTTP 403: запрещено, а также сообщение о превышении назначенной квоты. Подробнее читайте в Условиях использования.

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

Вы можете запросить увеличение квоты только на количество запросов в день на проект или запросов в день на запись. О том, как это сделать, читайте ниже.

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

  1. Если у вас нет платежного аккаунта для проекта, создайте его.
  2. В API Console откройте эту страницу и выберите API.
  3. Чтобы настроить квоты, нажмите Квоты. Если вас интересует статистика, выберите Использование.

Изучите доступную информацию и следуйте инструкциям в форме запроса квоты, перед тем как запросить увеличение. Напоминаем, что API отчетности версии 4 в Developers Console называется Analytics Reporting API V4. Все остальные API версии 3 (Management API V3, Core Reporting API V3, Real Time Reporting API V3 и др.) отображаются в Developers Console под единым названием Analytics API.

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