К API данных применяются следующие ограничения и квоты.
Как применяются квоты
Все запросы к Google Analytics Data API v1 требуют наличия проекта Google Cloud и подлежат квотам, указанным на этой странице. Квоты расходуются независимо от метода идентификации вызывающего проекта, включая:
- Запросы аутентифицированы с использованием учетных данных OAuth 2.0.
- Запросы аутентифицируются с использованием только ключа API.
Ключи API используются для привязки запроса к конкретному проекту Google Cloud в целях квотирования и выставления счетов. Все вызовы API, выполненные с использованием учетных данных или ключа API из вашего проекта, будут учитываться в рамках применимых квот вашего проекта и ресурса Google Analytics.
Категории квот
API данных имеет четыре категории квот запросов: Core, Realtime, Funnel и Chat.
Запросы API к основным методам расходуют квоты основного кода. Запросы API к методам реального времени расходуют квоты реального времени. Запросы API к методам воронки продаж расходуют квоты воронки продаж. Запросы API к методам чата расходуют квоты чата. Каждый запрос потребляет только один тип квоты.
| Категория квоты | Методы API |
|---|---|
| Основной | runReport , runPivotReport , batchRunReports , batchRunPivotReports , runAccessReport , getMetadata , checkCompatibility , createAudienceExports |
| В реальном времени | runRealtimeReport |
| Воронка | runFunnelReport |
| Чат | свойства.чат |
Квоты на аналитические данные
Все запросы расходуют квоты на использование ресурсов.
| Название квоты | Стандартный лимит собственности | Ограничение на использование недвижимости Analytics 360 |
|---|---|---|
| Основные токены на объект недвижимости в день | 200 000 | 2 000 000 |
| Основные токены за объект недвижимости в час | 40 000 | 400 000 |
| Основные токены за проект, за объект недвижимости, за час работы | 14 000 | 140 000 |
| Основные одновременные запросы для каждого объекта | 10 | 50 |
| Ошибки основного сервера по проектам, по объектам недвижимости, в час | 10 | 50 |
| Токены в реальном времени на каждый объект недвижимости в день | 200 000 | 2 000 000 |
| Токены в реальном времени за объект недвижимости в час | 40 000 | 400 000 |
| Токены в реальном времени за проект, за объект недвижимости, за час | 14 000 | 140 000 |
| Одновременные запросы в режиме реального времени для каждого объекта недвижимости | 10 | 50 |
| Ошибки сервера в реальном времени по каждому проекту, по каждому объекту недвижимости в час | 10 | 50 |
| Токены воронки продаж на один объект недвижимости в день | 200 000 | 2 000 000 |
| Токены воронки продаж за объект недвижимости в час | 40 000 | 400 000 |
| Токены воронки продаж за проект, за объект недвижимости, за час работы | 14 000 | 140 000 |
| Направление одновременных запросов по каждому объекту недвижимости | 10 | 50 |
| Ошибки сервера воронки продаж на проект, на объект, в час | 10 | 50 |
| Токены чата на объект недвижимости в день | 3 750 000 | 3 750 000 |
| Токены чата за объект недвижимости в час | 500 000 | 500 000 |
- Количество одновременных запросов измеряется числом запросов, выполняемых одновременно. Чтобы уменьшить количество одновременных запросов, дождитесь завершения предыдущих запросов, прежде чем отправлять новые.
- Ошибки сервера обозначаются кодами 500 и 503. Квота на обработку ошибок сервера взимается только в том случае, если запрос приводит к ошибке сервера. Когда квота на обработку ошибок сервера исчерпана для пары проект-свойство, все запросы к этому свойству из проекта блокируются. Полный список ответов об ошибках см. в разделе «Ответы об ошибках» .
- Каждый запрос расходует квоту как на количество токенов на объект в час, так и на количество токенов на проект на объект в час. Это означает, что для исчерпания квоты «Токены на объект в час» необходимо, чтобы к одному объекту обращались более 3 проектов, прежде чем квота «Токены на проект на объект в час» будет исчерпана.
Допускается до 120 потенциально пороговых запросов в час для каждого параметра. Пороговые значения могут быть установлены для таких параметров, как userAgeBracket , userGender , brandingInterest , audienceId и audienceName . Пороговые значения применяются для предотвращения возможности определения демографических данных или интересов отдельных пользователей при просмотре отчета.
квота токенов недвижимости
Токены расходуются при каждом запросе к API данных Google Analytics версии 1. Количество списанных токенов зависит от сложности запроса. Хотя большинство запросов потребляют 10 или менее токенов, более сложные запросы (например, запросы chat Analytics Advisor) потребляют больше.
Факторы, влияющие на потребление токенов
Точная стоимость токена для запроса определяется в момент его выполнения, что затрудняет точный предварительный расчет. На стоимость влияет сочетание факторов, связанных с самим запросом и базовыми данными в ресурсе Google Analytics. Эти факторы могут привести к увеличению стоимости:
- Количество строк: Запрашивается большее количество строк.
- Количество измерений и показателей: Увеличение количества измерений и показателей.
- Сложность фильтра: использование сложных выражений фильтра.
- Длина диапазона дат: Запросы по более длинным периодам времени.
- Кардинальность данных: Измерения с высокой кардинальностью (много уникальных значений, таких как
pagePath, пользовательские измерения) могут значительно увеличить стоимость токена. - Объём событий, связанных с объектами недвижимости: Запросы к объектам недвижимости с большим объёмом событий могут потреблять больше токенов, чем тот же запрос к объекту недвижимости с меньшим объёмом данных.
Мониторинг использования токенов
Наиболее эффективный способ определить стоимость токенов для конкретных вызовов API — добавить параметр "returnPropertyQuota": true в тело запроса. В ответе API будет содержаться объект PropertyQuota , в котором подробно указано количество токенов, потребленных конкретным запросом, и оставшийся баланс квоты.
Использование и мониторинг токенов чата
В запросах chat Analytics Advisor токены представляют собой затраты на вычисление модели, рассуждения и получение базовых данных. На потребление токенов чата влияют следующие факторы:
- Область запроса и анализа: сложность и широта запрашиваемого анализа.
- Входные и выходные токены модели: объем обрабатываемых контекстных данных и сгенерированный текстовый ответ.
- Thinking tokens: Model reasoning steps required to synthesize findings.
- Задержка выполнения: время обработки, необходимое для многоэтапного анализа данных.
Для отслеживания использования токенов чата установите параметр "returnPropertyQuota": true в вашем ChatRequest . В ответе будет содержаться объект PropertyChatQuota , включающий поля tokensPerDay и tokensPerHour с указанием потребленных и оставшихся токенов.