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 группы объявлений. Сервис: | 1 |
Операция: SearchStreamКоличество: 45 кампаний Сервис: | 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 . Это же сообщение об ошибке может быть связано и с другими проблемами.
При создании запроса на языке запросов Search Ads 360 максимальное количество элементов в предложении IN — 20 000. Если вы превысите этот предел, будет возвращена ошибка FILTER_HAS_TOO_MANY_VALUES .