Ресурсные квоты

Здесь описана система ресурсных квот, используемая в Google Analytics Reporting API версии 4 и доступная только клиентам Analytics 360. Все ограничения перечислены в статье Ограничения и квоты API.

Введение

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

Система ресурсных квот позволяет клиентам Analytics 360 задавать более высокие пороговые значения выборки при использовании Analytics Reporting API. Эта система не является обязательной и не зависит от существующих ограничений на представления и проекты, например указанных на странице квот в Google API Console.

Ресурсные квоты

Не все запросы выполняются одинаково: некоторые требуют больше вычислений, чем другие. Система ресурсных квот предназначена для поддержки более высокого порога выборки и защиты инфраструктуры отчетности Google Analytics.

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

Порог выборки

Запросы данных с использованием Google Analytics API версии 4 выполняются с определенными общими порогами выборки в зависимости от количества сеансов в заданном диапазоне дат (на уровне ресурса):

  • Google Analytics: 500 000 сеансов;
  • Analytics 360: 1 млн сеансов;
  • Analytics 360 с ресурсными квотами: 100 млн сеансов.

Как включить ресурсные квоты

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

{
  "reportRequests": [{object(ReportRequest)}],
  "useResourceQuotas": boolean,
}

Пример:

{
  "reportRequests":[
  {
    "viewId":"XXXX",
    "dateRanges":[
      {
        "startDate":"2017-06-15",
        "endDate":"2017-06-30"
      }],
    "metrics":[
      {
        "expression":"ga:sessions"
      }],
    "dimensions": [
      {
        "name":"ga:browser"
      }]
    }],
  "useResourceQuotas": true
}

Поле стоимости запроса

В ответе на вызов batchGet есть поле queryCost.

{
  "reports": [{ object(Report) }],
  "queryCost": number
}

Поле queryCost – целое число, представляющее общую стоимость всех запросов ReportRequests в запросе batchGet. Пример:

{
  "reports": [
    {
      "columnHeader": {...},
      "data": {
        "rows": [...]
      }
    }
  ],
  "queryCost": 1337
}

Распределение квот

Analytics 360 property quota

  • 100 000 единиц запросов в день на каждый ресурс.
  • 25 000 единиц запросов в час на каждый ресурс.

Если вы превысите квоту, то получите сообщение об ошибке RESOURCE_EXHAUSTED. Подробнее…

Расчет стоимости

Стоимость запроса зависит от следующих факторов:

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

Ограничения и использование API

Кроме ресурсных квот, в отношении API также действуют ограничения и квоты Analytics API v4.

Примечания

  • Поле queryCost представляет собой вычислительные затраты на обработку запроса. Это не денежная стоимость – API можно использовать бесплатно.
  • Данные за текущий день и за давние периоды (более года) могут по-прежнему подвергаться выборке, независимо от значения параметра useResourceQuotas.
  • Если для запроса не мог использоваться более высокий порог выборки, то вы не потратите токены ресурсной квоты (ответы с выборкой данных всегда имеют нулевую стоимость ресурсной квоты).
  • Если в ответе есть поля samplesReadCounts и samplingSpaceSizes, значит использовалась выборка.

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

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