API для создания отчетов Search Ads 360 устанавливает ограничения на операции API, чтобы обеспечить оптимальную производительность системы для всех пользователей.
Цены
Использование API для создания отчетов Search Ads 360 включено в общую стоимость Search Ads 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
Все клиентские библиотеки API для отчетов Search Ads 360 используют 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 . Это же сообщение об ошибке может быть вызвано и другими причинами.
При создании запроса в Search Ads 360 Query Language максимальное количество элементов в предложении IN составляет 20 000. Если это значение превышено, возвращается ошибка FILTER_HAS_TOO_MANY_VALUES .