Иерархия названий
Названия ресурсов, используемые в Search Ads 360 Reporting API, имеют иерархическую структуру, отражающую организацию объектов в Поисковой рекламе 360. Почти все ресурсы являются дочерними по отношению к ресурсу Customer, поскольку почти каждый вызов API должен быть направлен в определенный аккаунт Поисковой рекламы 360. Например, кампании, группы объявлений, объявления и ключевые слова – это дочерние ресурсы корневого ресурса клиента.
| Ресурс | Название ресурса |
|---|---|
| Клиент | customers/1234567890
|
| Campaign | customers/1234567890/campaigns/8765432109
|
| Группа объявлений | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Идентификаторы ресурсов
Объекты Search Ads 360 Reporting API (клиенты, кампании и т. д.) упоминаются в API по названиям ресурсов. Однако важно отметить, что у самих названий ресурсов могут быть уникальные числовые идентификаторы, которые позволяют идентифицировать каждый объект в иерархии. В таких случаях может быть полезно проанализировать название ресурса, чтобы извлечь эти идентификаторы и собрать новый.
Например, рассмотрим название ресурса AdGroupAd из предыдущей таблицы:
customers/1234567890/adGroupAds/54321098765~2109876543210
Его можно разбить на отдельные идентификаторы ресурсов (разделенные идентификаторами коллекций) следующим образом:
| Компоненты названия ресурса | |||||||
|---|---|---|---|---|---|---|---|
| Идентификаторы ресурсов |
|
||||||
| Идентификаторы коллекций |
|
||||||
Выполнив синтаксический анализ отдельных идентификаторов, вы можете получить новые названия ресурсов, чтобы ссылаться на клиента (customers/1234567890) или группу объявлений (customers/1234567890/adGroupAds/54321098765).