Иерархия имен
Имена ресурсов, используемые в API Google Ads, имеют иерархическую структуру, отражающую организацию сущностей в Google Ads. Практически все ресурсы являются подресурсами ресурса Customer , что отражает тот факт, что практически каждый вызов API должен быть направлен на конкретный аккаунт Google Ads. Например, кампании, группы объявлений, объявления и ключевые слова являются подресурсами корневого ресурса «Клиент».
| Ресурс | Имя ресурса |
|---|---|
| Клиент | customers/1234567890 |
| Кампания | 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 Ads. Однако некоторые типы объектов могут использоваться несколькими аккаунтами. На практике это, например, списки минус-слов или действия по конверсии между аккаунтами , которые обычно создаются менеджерами, а затем используются многими клиентскими аккаунтами.
Имена ресурсов таких объектов будут различаться в зависимости от того, в какую учетную запись вы отправляете вызов API.
Пример: действия по конверсии между аккаунтами
Предположим, у нас есть менеджерский счет 987-654-3210 , который разделяет действие конверсии между счетами с одним из своих клиентских счетов 123-456-7890 :
Выполнение вызова API к учетной записи менеджера, например, для обновления окна ретроспективного просмотра действия конверсии приведет к ссылке на общий объект с использованием имени ресурса: customers/9876543210/conversionActions/257733534 .
Выполнение вызова API к учетной записи клиента для согласия на использование общего действия конверсии приведет к ссылке на нее с использованием имени ресурса: customers/1234567890/conversionActions/257733534 .
Это то же самое базовое действие конверсии, но имя его ресурса связано с учетной записью, используемой для доступа к нему.