Новый 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 и ее аффилированных лиц.
Последнее обновление: 2025-08-29 UTC.
[null,null,["Последнее обновление: 2025-08-29 UTC."],[[["\u003cp\u003eSearch Ads 360 API request formats vary depending on whether you're searching or requesting specific entities.\u003c/p\u003e\n"],["\u003cp\u003eSearches utilize the Search Ads 360 Query Language and the \u003ccode\u003eSearchAds360Service\u003c/code\u003e for customized results.\u003c/p\u003e\n"],["\u003cp\u003eResponses from \u003ccode\u003eSearchAds360Service\u003c/code\u003e include a \u003ccode\u003eSearchAds360Row\u003c/code\u003e for each matching entity, containing only the requested fields.\u003c/p\u003e\n"],["\u003cp\u003eRequests for specific entities return all fields for that entity, and customer IDs must be provided as 10-digit numbers without dashes.\u003c/p\u003e\n"]]],["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"],null,["# Formats in the Search Ads 360 Reporting API\n\nRequest format\n--------------\n\nThe request format depends on the type of request you make.\n\n### Search\n\nYou can customize your search output by defining a search query\nto suit your needs. The Search Ads 360 Query Language allows you to search all\nresources for a list of entities that match a specific set of criteria. All\nrequests, regardless of the entity type, are made against the\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service). See [Create search reports](/search-ads/reporting/concepts/search-reports) and\n[Search Ads 360 Query Language](/search-ads/reporting/query/query-language)\nto learn more.\n\nResponse format\n---------------\n\nThe fields populated in the response depend on the service you use:\n\n[`SearchAds360Service`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360service)\n: The response includes one [`SearchAds360Row`](/search-ads/reporting/api/reference/rpc/google.ads.searchads360.v0.services#searchads360row) object for each entity that\n matches your search parameters. Each row contains one object, for example, a\n campaign, and includes *only* the fields you request in your query.\n\nSpecific services\n: You can only request one entity at a time by resource name. The response\n includes *all* fields for that entity.\n\nCustomer ID format\n------------------\n\nIn the new API, you must specify your Customer ID as a 10-digit number\n(`XXXXXXXXXX`) without dashes."]]
