Metadane zasobu

GoogleAdsFieldService umożliwia dynamiczne wysyłanie żądań o katalogi zasobów, pól zasobów, kluczy podziału na segmenty i danych dostępnych w metodach GoogleAdsService Search oraz SearchStream. Katalog udostępnia metadane, które mogą być wykorzystywane przez klientów interfejsu Google Ads API do weryfikowania i tworzenia instrukcji języka zapytań Google Ads.

Przykładowe żądanie HTTP i odpowiedź

Żądanie składa się z parametru HTTP GET wysyłanego do serwera interfejsu Google Ads API pod tym adresem URL:

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

Oto przykład żądania, po którym zwracana jest odpowiedź GoogleAdsFieldService z grupy ad_group:

Wyślij

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

Odpowiedź

{
  "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",
    ...
  ]
}

W tym przykładzie ważne tablice to:

attributeResources
Zasoby, które mogą być bezpośrednio połączone z zasobem w klauzuli FROM.
metrics
Dane, które można wybrać razem z zasobem w klauzuli FROM. Wypełnianie tylko pól, w których category to RESOURCE.
segments
Klucze segmentu, które można wybrać za pomocą zasobu w klauzuli FROM. Segmentują dane określone w zapytaniu. Wypełnianie tylko pól, w których category to RESOURCE.
selectableWith
Pola, które można wybrać obok danego pola, kiedy nie ma ich w klauzuli FROM. Ten atrybut przydaje się tylko do identyfikowania zasobów lub segmentów, które można wybrać w zapytaniu, gdy nie zostaną one uwzględnione w zasobie w klauzuli FROM. Jeśli np. wybieramy ad_group.id i segments.date z ad_group i chcemy uwzględnić atrybuty z atrybutu campaign, musimy sprawdzić, czy atrybut segments.date znajduje się w atrybucie selectableWith kampanii, ponieważ jest on wybierany obok istniejącego pola segments.date.

Szczegóły metadanych

Możesz poprosić o katalog przy użyciu GoogleAdsFieldService na tych poziomach:

Zasób
Na przykład: googleAdsFields/campaign.
Pole zasobu
Na przykład: googleAdsFields/campaign.name.
Pole podziału na segmenty
Na przykład: googleAdsFields/segments.ad_network_type.
Wskaźnik
Na przykład: googleAdsFields/metrics.clicks.