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

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

Введение

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

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

Ресурсная квота

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

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

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

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

  • Стандарт аналитики: 500 тыс. сеансов.
  • Аналитика 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
}

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

Квота ресурса Аналитики 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. Чтобы просмотреть и изменить настройки, связанные с квотами, выберите «Квоты» . Чтобы просмотреть статистику использования, выберите «Использование» .