Имена ресурсов

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

Имена ресурсов, используемые в API отчетов Search Ads 360, имеют иерархическую структуру, отражающую организацию объектов в Search Ads 360. Почти все ресурсы являются подресурсами ресурса Customer , что отражает тот факт, что почти каждый вызов API должен быть нацелен на конкретный поиск. Аккаунт Рекламы 360. Например, кампании, группы объявлений, объявления и ключевые слова – это подресурсы корневого клиентского ресурса.

Ресурс	Имя ресурса
Клиент	customers/1234567890
Кампания	customers/1234567890/campaigns/8765432109
Группа объявлений	customers/1234567890/adGroups/54321098765
Группа объявленийОбъявление	customers/1234567890/adGroupAds/54321098765~2109876543210

Ключевой момент: API отчетов Search Ads 360 использует относительные имена ресурсов (а не полные имена ресурсов, как некоторые другие API Google).

Идентификаторы ресурсов

Объекты API отчетов Search Ads 360 (клиенты, кампании и т. д.) во всем API упоминаются по именам ресурсов. Однако важно отметить, что сами имена ресурсов могут иметь уникальные числовые идентификаторы ресурсов , которые идентифицируют каждый объект в иерархии. В этих случаях может быть полезно проанализировать имя ресурса, чтобы извлечь эти идентификаторы ресурсов и собрать новый.

Например, изучите имя ресурса AdGroupAd из предыдущей таблицы:

customers/1234567890/adGroupAds/54321098765~2109876543210

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

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

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

Ключевой момент: имена ресурсов в телах запросов и ответов JSON ссылаются на поле resourceName , а не на поле name как в некоторых других API Google Cloud. Многие объекты Поисковой рекламы 360 сами имеют атрибуты имени ( campaign.Name , adGroup.Name и т. д.), поэтому resourceName используется во избежание конфликта с существующими именами объектов.