Иерархия имен
Названия ресурсов, используемые в Google Ads API, имеют иерархическую структуру, отражающую организацию объектов в Google Рекламе. Почти все ресурсы являются дочерними по отношению к ресурсу Customer, поскольку почти каждый вызов API должен быть направлен в определенный аккаунт Google Рекламы. Например, кампании, группы объявлений, объявления и ключевые слова являются дочерними ресурсами корневого ресурса клиента.
| Ресурс | Название ресурса |
|---|---|
| Клиент | customers/1234567890
|
| Campaign | customers/1234567890/campaigns/8765432109
|
| Группа объявлений | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
Идентификаторы ресурсов
Объекты Google Рекламы (клиенты, кампании и т. д.) в API обозначаются названиями ресурсов. Однако важно отметить, что у самих названий ресурсов могут быть уникальные числовые идентификаторы, которые позволяют идентифицировать каждый объект в иерархии. В таких случаях может быть полезно проанализировать название ресурса, чтобы извлечь идентификаторы ресурсов и собрать новый.
Рассмотрим название ресурса AdGroupAd из предыдущей таблицы:
customers/1234567890/adGroupAds/54321098765~2109876543210
Его можно разбить на отдельные идентификаторы ресурсов (разделенные идентификаторами коллекций) следующим образом:
| Компоненты названия ресурса | |||||||
|---|---|---|---|---|---|---|---|
| Идентификаторы ресурсов |
|
||||||
| Идентификаторы коллекций |
|
||||||
Анализ отдельных идентификаторов позволяет получить новые названия ресурсов, чтобы ссылаться на клиента (customers/1234567890) или группу объявлений (customers/1234567890/adGroupAds/54321098765) объявления из группы.
Идентификаторы общих объектов
Большинство объектов в API связаны с одним конкретным клиентом Google Рекламы. Однако некоторые типы объектов могут быть общими для нескольких аккаунтов. На практике это такие вещи, как списки минус-слов или действия-конверсии в управляющем аккаунте, которые обычно создаются менеджерами, а затем передаются многим клиентским аккаунтам.
Названия ресурсов таких объектов будут различаться в зависимости от того, в какой аккаунт вы отправляете вызов API.
Пример: действия-конверсии в управляющем аккаунте
Предположим, что у нас есть управляющий аккаунт 987-654-3210, который предоставляет доступ к действию-конверсии в управляющем аккаунте одному из своих клиентских аккаунтов 123-456-7890:
При вызове API для управляющего аккаунта, например чтобы изменить период учета действий-конверсий, будет использоваться ссылка на общий объект с названием ресурса customers/9876543210/conversionActions/257733534.
При вызове API для клиентского аккаунта, чтобы включить использование общего действия-конверсии, на него будет ссылаться название ресурса: customers/1234567890/conversionActions/257733534.
Это одно и то же действие-конверсия, но название его ресурса зависит от аккаунта, через который вы получаете доступ к этому действию.