Каждый запрос API проверяет, не исчерпаны ли квоты, и использует их. Если какая-либо квота исчерпана, запрос завершается с соответствующим сообщением об ошибке. Каждый запрос API данных проверяет несколько сегментов квот.
Категории квот
Для целей квоты API данных имеет три категории запросов: «Ядро», «В реальном времени» и «Воронка». Запросы API к методам Core взимают квоты Core. Запросы API к методам реального времени взимают квоты реального времени. Один запрос не будет использовать одновременно квоты ядра и реального времени. Это методы и категории API:
| Категория квоты | Методы API |
|---|---|
| Основной | runReport , runPivotReport , atchRunReports , atchRunPivotReports , runAccessReport , getMetadata , checkCompatibility , createAudienceExports |
| В реальном времени | запуститьRealtimeReport |
| Воронка | RunFunnelReport |
Квоты на недвижимость в Аналитике
Все запросы используют квоты свойств.
| Название квоты | Стандартный лимит свойств | Ограничение ресурса Аналитики 360 |
|---|---|---|
| Базовых токенов на недвижимость в день | 200 000 | 2 000 000 |
| Токенов ядра на ресурс в час | 40 000 | 400 000 |
| Core токены на проект на недвижимость в час | 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 .