К 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 . Пороговые значения применяются для предотвращения возможности определения демографических данных или интересов отдельных пользователей при просмотре отчета.
квота токенов недвижимости
Стоимость токенов рассчитывается для каждого запроса в зависимости от его сложности. За большинство запросов взимается 10 или менее токенов. Когда запрос потребляет большое количество квотных токенов, это часто происходит по следующим причинам:
- Большое количество строк
- Большое количество столбцов
- Сложные критерии фильтрации
- Длительный временной диапазон
При каждом API-запросе вы можете указать в теле запроса "returnPropertyQuota": true чтобы получить текущий статус использования токенов квоты для объекта недвижимости. Этот статус содержит как количество токенов, использованных в данном запросе, так и оставшееся количество для каждой группы квот. Например, рассмотрите возможность указания этого параметра в RunReportRequest .