Метаданные ресурса

Вы можете использовать GoogleAdsFieldService для динамического запроса каталога для ресурсов, полей ресурсов, ключей сегментации и метрик, доступных в методах GoogleAdsService Search и SearchStream . Каталог предоставляет метаданные, которые могут использоваться клиентами Google Ads API для проверки и построения операторов Google Ads Query Language.

Пример HTTP-запроса и ответа

Запрос состоит из HTTP GET к серверу API Google Ads по следующему URL-адресу:

https://googleads.googleapis.com/v20/googleAdsFields/{resource_or_field}

В следующем примере показан запрос, за которым следует ответ, возвращаемый GoogleAdsFieldService для ресурса ad_group :

Запрос 

https://googleads.googleapis.com/v20/googleAdsFields/ad_group

Ответ 

{
  "resourceName": "googleAdsFields/ad_group",
  "name": "ad_group",
  "category": "RESOURCE",
  "selectable": false,
  "filterable": false,
  "sortable": false,
  "selectableWith": [
    "campaign",
    "customer",
    "metrics.average_cpc",
    "segments.device",
    ...
  ],
  "attributeResources": [
    "customer",
    "campaign"
  ],

  "metrics": [
    "metrics.conversions",
    "metrics.search_budget_lost_impression_share",
    "metrics.average_cost",
    "metrics.clicks",
    ...
  ],
  "segments": [
    "segments.date",
    "segments.ad_network_type",
    "segments.device",
    ...
  ]
}

Для этого примера важными массивами являются:

attributeResources
Ресурсы, которые могут быть неявно присоединены к ресурсу в предложении FROM .
metrics
Метрики, которые можно выбрать с ресурсом в предложении FROM . Заполняется только для полей, где category — RESOURCE .
segments
Ключи сегмента, которые можно выбрать с ресурсом в предложении FROM . Они сегментируют метрики, указанные в запросе. Заполняется только для полей, где category — RESOURCE .
selectableWith
Поля, которые можно выбрать вместе с заданным полем, если они не находятся в предложении FROM . Этот атрибут имеет значение только при определении ресурсов или сегментов, которые можно выбрать в запросе, где они не включены ресурсом в предложении FROM . Например, если мы выбираем ad_group.id и segments.date из ad_group и хотим включить атрибуты из campaign , нам нужно будет проверить, что segments.date находится в атрибуте selectableWith для campaign, поскольку он выбирается вместе с существующим полем segments.date .

Детали метаданных

Вы можете запросить каталог с помощью GoogleAdsFieldService на следующих уровнях:

Ресурс
Например, googleAdsFields/campaign .
Поле ресурса
Например, googleAdsFields/campaign.name .
Сегментация поля
Например, googleAdsFields/segments.ad_network_type .
Метрический
Например, googleAdsFields/metrics.clicks .
Назад
Получение объектов
Далее
Структура вызова