В Search Ads 360 Reporting API действуют ограничения на операции, которые обеспечивают оптимальную производительность системы для всех пользователей.
Цены
Использование Search Ads 360 Reporting API включено в общую стоимость Поисковой рекламы 360. За использование API дополнительные комиссии не взимаются.
Ограничения на количество запросов
Для операций запроса, выполняемых с помощью методов Search или SearchStream, действуют следующие ограничения:
- 3000 запросов в минуту на проект на пользователя;
- 3000 запросов в минуту на проект;
- 150 000 запросов в день на проект;
Дневные ограничения на операции API
Дневные лимиты на использование API основаны на количестве операций API, выполненных в рамках проекта Google Cloud.
Один запрос или отчет считается одной операцией, независимо от того, передаются ли результаты через SearchAds360Service.SearchStream или разбиваются на страницы с помощью вызова SearchAds360Service.Search. Подробнее…
В таблице ниже приведены примеры.
| Запрос API | Засчитанные операции |
|---|---|
Операция: Search
Количество: 53 группы объявлений Сервис: SearchAds360Service
|
1 |
Операция: SearchStream
Количество: 45 кампаний Сервис: SearchAds360Service
|
1 |
Запросы, нарушающие эти ограничения, отклоняются с ошибкой RESOURCE_EXHAUSTED.
Поисковые запросы
Запрос Search или SearchStream считается одной операцией в рамках суточной квоты пользователя. Один запрос SearchStream считается одной операцией API независимо от количества пакетов.
Ограничения gRPC
Все клиентские библиотеки Search Ads 360 Reporting API используют gRPC для создания запросов и ответов. По умолчанию размер сообщения gRPC составляет 4 МБ.
Ответы не должны превышать этот лимит. Например, поисковый запрос, включающий много полей, может сгенерировать ответ, размер которого превышает 4 МБ. Чтобы избежать этого ограничения, вы можете уменьшить количество выбранных полей, уменьшить размер страницы или использовать потоковую передачу.
Запросы, нарушающие это ограничение, не будут генерировать SearchAds360Error, но будут генерировать ошибку gRPC 429 Resource Exhausted. Ознакомьтесь со списком кодов ошибок и сообщений gRPC.
Запросы с разбивкой на страницы
Запросы с разбивкой на страницы (например, содержащие действительный параметр next_page_token) не учитываются в суточной квоте пользователя на операции.
Однако запросы на разбиение по страницам, содержащие недействительный токен страницы или токен с истекшим сроком действия, вызовут исключение и будут учитываться в дневной квоте на операции.
Запросы с разбивкой на страницы, например поисковые, также подпадают под ограничение Page size cannot exceed 10,000 rows и отклоняются, если оно нарушено, с ошибкой INVALID_PAGE_SIZE.
Подробнее о разбивке результатов на страницы…
Запросы, возвращающие исключения API
Запросы, отклоненные с ошибкой SearchAds360Failure, по-прежнему учитываются в дневной квоте пользователя.
Запросы, которые не удалось выполнить, но которые не возвращают ошибку SearchAds360Failure (например, из-за ошибки на уровне сети), не учитываются в суточной квоте пользователя, поскольку они не доходят до сервиса. Примером этого является сбой сетевого подключения.
Другие типы ограничений
Если в повторяющемся поле, например в списке операций, слишком много элементов, может возникнуть ошибка REQUEST_SIZE_LIMIT_EXCEEDED.
Это сообщение об ошибке может появляться и по другим причинам.
При создании запроса на языке запросов Поисковой рекламы 360 максимальное количество элементов в условии IN составляет 20 000. Если вы превысите этот лимит, будет возвращена ошибка FILTER_HAS_TOO_MANY_VALUES.