Metadane zasobu

Możesz użyć GoogleAdsFieldService, aby dynamicznie wysyłać żądania dotyczące katalogu zasobów, pól zasobów, kluczy podziału na segmenty i danych dostępnych w metodach GoogleAdsService Search i SearchStream. Katalog zawiera metadane, których klienci interfejsu Google Ads API mogą używać do weryfikowania i tworzenia instrukcji języka zapytań Google Ads.

Przykładowe żądanie i odpowiedź HTTP

Uwaga: przykład zawiera żądanie HTTP/JSON jako wskazówkę, ale zdecydowanie zalecamy użycie jednej z bibliotek klienta opartych na protokole gRPC do przesyłania żądań.

Żądanie składa się z HTTP GET do serwera Google Ads API na tym URL:

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

Oto przykład żądania i odpowiedzi zwracanej przez interfejs GoogleAdsFieldService dla zasobu ad_group:

Żądanie

https://googleads.googleapis.com/v19/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 można dołączyć do zasobu w klauzuli FROM.

metrics

Dane, które można wybrać z zasobami w nawiasach klamrowych FROM. Wartość jest podawana tylko w przypadku pól, w których category ma wartość RESOURCE.

segments

Klucze segmentów, które można wybrać za pomocą zasobu w nawiasach klamrowych FROM. Dzielą one dane określone w zapytaniu na segmenty. Wartość jest podawana tylko w przypadku pól, w których category to RESOURCE.

selectableWith

Pola, które można wybrać obok danego pola, gdy nie znajdują się w klauzuli FROM. Ten atrybut ma znaczenie tylko wtedy, gdy identyfikujesz zasoby lub segmenty, które mogą być wybrane w zapytaniu, w którym nie są uwzględnione przez zapytanie z klauzulą FROM. Jeśli np. wybieramy atrybuty ad_group.id i segments.date z ad_group i chcemy uwzględnić atrybuty z campaign, musimy sprawdzić, czy atrybut segments.date znajduje się w atrybucie selectableWith kampanii, ponieważ jest on wybierany razem z istniejącym polem segments.date.

Szczegóły metadanych

Katalog możesz poprosić o pomoc 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.

Dane

Na przykład: googleAdsFields/metrics.clicks.