Названия ресурсов

Иерархия имен

Названия ресурсов, используемые в 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

Его можно разбить на отдельные идентификаторы ресурсов (разделенные идентификаторами коллекций) следующим образом:

Компоненты названия ресурса
Идентификаторы ресурсов
идентификатор клиента:
"1234567890"
Идентификатор группы объявлений
"54321098765"
Идентификатор объявления в группе объявлений:
"2109876543210"
Идентификаторы коллекций
"customers"
"adGroupAds"

Анализ отдельных идентификаторов позволяет получить новые названия ресурсов, чтобы ссылаться на клиента (customers/1234567890) или группу объявлений (customers/1234567890/adGroupAds/54321098765) объявления из группы.