Иерархия имен
Имена ресурсов, используемые в 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 упоминаются по именам ресурсов. Однако важно отметить, что сами имена ресурсов могут иметь уникальные числовые идентификаторы ресурсов , которые идентифицируют каждый объект в иерархии. В этих случаях может быть полезно проанализировать имя ресурса, чтобы извлечь эти идентификаторы ресурсов и собрать новый.
Например, изучите имя ресурса AdGroupAd из предыдущей таблицы:
customers/1234567890/adGroupAds/54321098765~2109876543210
Его можно разбить на отдельные идентификаторы ресурсов (разделенные идентификаторами коллекций ) следующим образом:
| Компоненты имени ресурса | |||||||
|---|---|---|---|---|---|---|---|
| Идентификаторы ресурсов |
| ||||||
| Идентификаторы коллекций |
| ||||||
Анализ отдельных идентификаторов позволяет получить новые имена ресурсов, которые будут ссылаться на клиента объявления группы объявлений ( customers/1234567890 ) или ее группу объявлений ( customers/1234567890/adGroupAds/54321098765 ).