Квота на основе ресурсов

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

Введение

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

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

Квота на основе ресурсов

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

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

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

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

  • Analytics Standard: 500 тыс. сеансов
  • Аналитика 360: 1 млн сеансов
  • Аналитика 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
}

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

Квота ресурса Аналитики 360

  • 100 000 единиц стоимости запроса в день на ресурс.
  • 25 000 единиц стоимости запроса в час на ресурс.

Если вы превысите лимит квоты, вы получите сообщение об ошибке RESOURCE_EXHAUSTED . Дополнительные сведения см. в разделе « Ответы об ошибках».

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

Стоимость запроса пропорциональна:

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

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

В дополнение к системе квот на основе ресурсов API также регулируются ограничениями и квотами в Analytics API v4 .

Заметки

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

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

  1. Если у вас еще нет платежного аккаунта для вашего проекта, создайте его.
  2. Посетите страницу «Включенные API» библиотеки API в консоли API и выберите API из списка.
  3. Чтобы просмотреть и изменить настройки, связанные с квотами, выберите Квоты . Чтобы просмотреть статистику использования, выберите Использование .