К API данных применяются следующие ограничения и квоты.
Как применяются квоты
Все запросы к Google Analytics Data API v1 требуют наличия проекта Google Cloud и подлежат квотам, указанным на этой странице. Квоты расходуются независимо от метода идентификации вызывающего проекта, включая:
- Запросы аутентифицированы с использованием учетных данных OAuth 2.0.
- Запросы аутентифицируются с использованием только ключа API.
Ключи API используются для привязки запроса к конкретному проекту Google Cloud в целях квотирования и выставления счетов. Все вызовы API, выполненные с использованием учетных данных или ключа API из вашего проекта, будут учитываться в рамках применимых квот вашего проекта и ресурса Google Analytics.
Категории квот
API данных имеет три категории квот запросов: Core, Realtime и Funnel. Запросы к методам Core используют квоты Core. Запросы к методам Realtime используют квоты Realtime. Каждый запрос потребляет только один тип квоты.
| Категория квоты | Методы 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 |
- Количество одновременных запросов измеряется числом запросов, выполняемых одновременно. Чтобы уменьшить количество одновременных запросов, дождитесь завершения предыдущих запросов, прежде чем отправлять новые.
- Ошибки сервера обозначаются кодами 500 и 503. Квота на обработку ошибок сервера взимается только в том случае, если запрос приводит к ошибке сервера. Когда квота на обработку ошибок сервера исчерпана для пары проект-свойство, все запросы к этому свойству из проекта блокируются. Полный список ответов об ошибках см. в разделе «Ответы об ошибках» .
- Каждый запрос расходует квоту как на количество токенов на объект в час, так и на количество токенов на проект на объект в час. Это означает, что для исчерпания квоты «Токены на объект в час» необходимо, чтобы к одному объекту обращались более 3 проектов, прежде чем квота «Токены на проект на объект в час» будет исчерпана.
Допускается до 120 потенциально пороговых запросов в час для каждого параметра. Пороговые значения могут быть установлены для таких параметров, как userAgeBracket , userGender , brandingInterest , audienceId и audienceName . Пороговые значения применяются для предотвращения возможности определения демографических данных или интересов отдельных пользователей при просмотре отчета.
квота токенов недвижимости
Токены расходуются при каждом запросе к API данных Google Analytics версии 1. Количество списанных токенов зависит от сложности запроса. Хотя большинство запросов потребляют 10 или менее токенов, более сложные запросы потребляют больше.
Факторы, влияющие на потребление токенов
Точная стоимость токена для запроса определяется в момент его выполнения, что затрудняет точный предварительный расчет. На стоимость влияет сочетание факторов, связанных с самим запросом и базовыми данными в ресурсе Google Analytics. Эти факторы могут привести к увеличению стоимости:
- Количество строк: Запрашивается большее количество строк.
- Количество измерений и показателей: Увеличение количества измерений и показателей.
- Сложность фильтра: использование сложных выражений фильтра.
- Длина диапазона дат: Запросы по более длинным периодам времени.
- Кардинальность данных: Измерения с высокой кардинальностью (много уникальных значений, таких как
pagePath, пользовательские измерения) могут значительно увеличить стоимость токена. - Объём событий, связанных с объектами недвижимости: Запросы к объектам недвижимости с большим объёмом событий могут потреблять больше токенов, чем тот же запрос к объекту недвижимости с меньшим объёмом данных.
Мониторинг использования токенов
Наиболее эффективный способ определить стоимость токенов для конкретных вызовов API — добавить параметр "returnPropertyQuota": true в тело запроса. В ответе API будет содержаться объект PropertyQuota , в котором подробно указано количество токенов, потребленных конкретным запросом, и оставшийся баланс квоты.