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 . Дополнительную информацию см . в разделе «Изменения формата в Search Ads 360 Reporting API» .
Пользовательские столбцы
В новой версии Search Ads 360 столбцы формул и специальные конверсии называются специальными столбцами . Узнайте больше о специальных столбцах . Новый CustomColumnService позволяет настраивать столбцы. Если у вас есть необходимые разрешения, вы можете запросить ресурсы CustomColumn принадлежащие любой учетной записи в дереве учетных записей.
Управление аккаунтом
В новой Search Ads 360 учетные записи организованы в иерархию: управляющие, подчиненные управляющие и клиентские учетные записи. Управляющий аккаунт представляет собой аккаунт агентства, а субменеджерские аккаунты представляют собой аккаунты рекламодателей в предыдущей версии Search Ads 360. Дополнительную информацию см. в разделе «Управляющие аккаунты Search Ads 360» .
Вы можете запросить дерево учетных записей , а затем отправить запросы для каждой учетной записи, из которой вы хотите получить данные отчета.
В результате изменения иерархии аккаунтов поля, связанные с концепцией рекламодателя/агентства, были заменены соответствующими альтернативами, чтобы обеспечить функциональное равенство, где это возможно. См. Сопоставления полей для получения списка затронутых полей и их заменителей.
Заголовок идентификатора клиента для входа в систему
login-customer-id — это новый заголовок, который необходим при использовании управляющего аккаунта для доступа к подчиненному управляющему или клиентскому аккаунту. Дополнительную информацию см. в заголовке «Идентификатор клиента для входа» .
Управление версиями
API отчетов Search Ads 360 использует семантическое управление версиями . Существуют основные и второстепенные версии, отформатированные как v MAJOR _ MINOR . См. раздел Управление версиями , чтобы узнать больше.