Новый API отчетов Search Ads 360 теперь доступен. Присоединяйтесь к группе Google
searchads-api-announcements , чтобы быть в курсе предстоящих улучшений и выпусков.
Форматы в API отчетов Search Ads 360
Формат запроса зависит от типа запроса, который вы делаете.
Поиск
Вы можете настроить результаты поиска, определив поисковый запрос в соответствии со своими потребностями. Язык запросов Search Ads 360 позволяет вам искать во всех ресурсах список объектов, соответствующих определенному набору критериев. Все запросы, независимо от типа объекта, выполняются к SearchAds360Service . Дополнительные сведения см. в разделах «Создание поисковых отчетов» и «Язык запросов Search Ads 360» .
Поля, заполняемые в ответе, зависят от используемого вами сервиса:
-
SearchAds360Service - Ответ включает один объект
SearchAds360Row для каждого объекта, соответствующего вашим параметрам поиска. Каждая строка содержит один объект, например кампанию, и включает только те поля, которые вы запрашиваете в запросе. - Конкретные услуги
- Вы можете запросить только одну сущность одновременно по имени ресурса. Ответ включает все поля для этого объекта.
В новом API необходимо указать свой идентификатор клиента в виде 10-значного числа ( XXXXXXXXXX ) без дефисов.
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-12-05 UTC.
[null,null,["Последнее обновление: 2024-12-05 UTC."],[[["Search Ads 360 API request formats vary depending on whether you're searching or requesting specific entities."],["Searches utilize the Search Ads 360 Query Language and the `SearchAds360Service` for customized results."],["Responses from `SearchAds360Service` include a `SearchAds360Row` for each matching entity, containing only the requested fields."],["Requests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes."]]],["Search requests utilize the Search Ads 360 Query Language against the `SearchAds360Service` to retrieve entities matching specific criteria. Responses from `SearchAds360Service` return `SearchAds360Row` objects, including only requested fields. Specific service requests retrieve one entity by resource name, returning all its fields. The Customer ID in the API must be a 10-digit number without dashes. The user can use the \"Create search reports\" or \"Search Ads 360 Query Language\" to learn more.\n"]]
