API для создания отчетов Search Ads 360 основан на современной платформе и вводит ряд новых концепций. Они описаны в следующих разделах.
Ресурсы
Объекты ресурсов заменяют типы отчетов. Вместо запроса предопределенных типов отчетов теперь можно запрашивать все ресурсы, используя новый язык запросов, похожий на SQL. Подробнее см. в разделе «Структура API отчетов Search Ads 360» .
Поиск отчетов
В новом API поиск имеет собственную службу. Служба поиска заменяет устаревшую службу отчетов. Все запросы проходят через SearchAds360Service , которая предоставляет два метода, SearchStream и Search , для поиска и получения данных и метрик отчетов. Оба метода поиска возвращают все объекты SearchAds360Row , соответствующие вашему поисковому запросу. Дополнительную информацию см. в разделе «Создание отчетов на основе поиска» .
Метаданные ресурса
SearchAds360FieldService позволяет динамически запрашивать каталог ресурсов, полей ресурсов, ключей сегментации и метрик, доступных в методах поиска SearchAds360Service . См. раздел «Получение метаданных ресурса» для получения дополнительной информации.
Названия полей
API позволяет вкладывать имена полей, разделенные точкой. Например, campaign.id и ad_group.id . Вы также можете вкладывать их дальше, например, ad_group.campaign.id . Подробнее см. в структуре API отчетов Search Ads 360 .
В предыдущей версии API Search Ads 360 отчетность основывалась на отдельных полях в разных сущностях для схожих концепций. Например, отчеты по campaign и adgroup включали отдельное поле campaignId .
язык запросов
API представляет язык запросов Search Ads 360. Это гибкий язык, похожий на SQL, который позволяет определять запросы для получения конкретных данных отчетов, наиболее подходящих для вашего бизнеса. Подробнее см. в разделе «Язык запросов Search Ads 360» .
Получать запросы
В новом API поиск имеет собственную службу ( SearchAds360Service ), но GET запросы по-прежнему выполняются для каждой отдельной службы сущности. Например, вы можете получить информацию о пользовательских столбцах из CustomColumnService . Подробнее см. раздел «Изменения формата в API отчетов Search Ads 360» .
Пользовательские колонки
В новом интерфейсе Search Ads 360 столбцы с формулами и пользовательские конверсии называются пользовательскими столбцами . Подробнее о пользовательских столбцах можно узнать здесь . Новый CustomColumnService позволяет использовать пользовательские столбцы. При наличии необходимых разрешений вы можете запрашивать ресурсы CustomColumn , принадлежащие любому аккаунту в дереве аккаунтов.
Управление учетными записями
В новой версии Search Ads 360 учетные записи организованы в иерархическую структуру: управляющие учетные записи, субуправляющие учетные записи и клиентские учетные записи. В предыдущей версии Search Ads 360 управляющая учетная запись представляла собой учетную запись агентства, а субуправляющие учетные записи — учетные записи рекламодателей. Подробнее см. раздел «Управляющие учетные записи Search Ads 360» .
Вы можете выполнить запрос к дереву учетных записей , а затем отправить запросы для каждой учетной записи, по которой вы хотите получить данные для отчетов.
В результате изменения иерархии учетных записей поля, относящиеся к концепции рекламодателя/агентства, были заменены соответствующими альтернативами для обеспечения функционального соответствия, где это возможно. Список затронутых полей и их заменителей см. в разделе «Сопоставление полей» .
Заголовок идентификатора клиента для входа в систему
login-customer-id — это новый заголовок, который необходим при использовании учетной записи менеджера для доступа к учетной записи субменеджера или клиента. Дополнительную информацию см. в разделе «Заголовок идентификатора клиента для входа» .
Версионирование
API для создания отчетов Search Ads 360 использует семантическое версионирование . Существуют основные и дополнительные версии, обозначаемые как v MAJOR _ MINOR . Подробнее см. в разделе «Версионирование» .