Metadane zasobu

Możesz używać GoogleAdsFieldService (za pomocą GetGoogleAdsField lub SearchGoogleAdsFields), aby dynamicznie wysyłać żądania dotyczące katalogu zasobów, pól zasobów, kluczy segmentacji 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 w języku zapytań Google Ads.

Przykładowe żądanie i odpowiedź HTTP

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

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

Poniższy przykład pokazuje żądanie, a następnie odpowiedź zwróconą z GoogleAdsFieldService dla zasobu ad_group:

Żądanie

https://googleads.googleapis.com/v25/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 niejawnie połączyć z zasobem w klauzuli FROM bez segmentowania danych. Informacja podawana tylko w przypadku pól, w których wartość category to RESOURCE.

metrics

Dane, które można wybrać w klauzuli FROMwraz z zasobem. Wartość jest podawana tylko w przypadku pól, w których category ma wartość RESOURCE.

segments

Klucze segmentów (pola segments.* i zasoby segmentujące), które można wybrać za pomocą zasobu w klauzuli FROM. Segmentują one dane określone w zapytaniu. Wartość jest podawana tylko w przypadku pól, w których category jest RESOURCE.

selectableWith

Zasoby, segmenty lub dane, które można wybrać w tym samym zapytaniu w języku zapytań Google Ads, gdy ten zasób lub segment nie jest zasobem podstawowym w klauzuli FROM.

Sprawdzanie zgodności za pomocą funkcji selectableWith

Atrybut selectableWith w polu zasobu lub segmentu określa inne zasoby, segmenty lub dane, które można wybrać w tym samym zapytaniu w języku zapytań Google Ads. Ten atrybut jest kluczowy, gdy chcesz uwzględnić pola z zasobu lub segmentu, który nie jest określony w klauzuli FROM.

Podczas tworzenia zapytania w języku zapytań Google Ads:

1. Zasób w klauzuli FROM jest podmiotem głównym. Z tego zasobu zawsze możesz wybierać pola.
2. Możesz też wybrać zgodne dane i segmenty dostępne w przypadku podmiotu głównego.
3. Jeśli uwzględnisz pola z dowolnego zasobu lub segmentu poza klauzulą FROM, musisz się upewnić, że ten zasób lub segment niebędący klauzulą FROM jest zgodny ze wszystkimi innymi polami, segmentami i rodzajami danych wybranymi w zapytaniu.

Lista selectableWith dla konkretnego zasobu (Zasób A) zawiera wszystkie inne zasoby, segmenty i dane, które można wybrać razem z polami z zasobu A, gdy zasób A nie jest głównym elementem.

Przykład

Rozważmy to przykładowe zapytanie:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group

• Klauzula FROM określa ad_group.
• To zapytanie wybiera ad_group.id (z zasobu FROM), segments.date i campaign.name.
• Ponieważ wybrano campaign.name, ale campaign nie występuje w klauzuli FROM, musisz sprawdzić jego zgodność z innymi wybranymi elementami.
• Aby to zapytanie było prawidłowe, zasób campaign musi być zgodny z zasobem segments.date (wybranym w innym polu). Dlatego musisz sprawdzić atrybut selectableWith w przypadku zasobu campaign. Jeśli segments.date znajduje się na liście selectableWith w campaign, zapytanie jest prawidłowe.

Jeśli wybierzesz pola z zasobu, którego nie ma w klauzuli FROM, lista selectableWith tego zasobu musi zawierać wszystkie inne segmenty i zasoby występujące w klauzuli SELECT.

Szczegóły metadanych

Możesz poprosić o katalog, używając GoogleAdsFieldService (według nazwy zasobu z GetGoogleAdsField lub przez zapytanie z SearchGoogleAdsFields) na tych poziomach: GoogleAdsFieldCategory

Zasób (RESOURCE)

Na przykład: googleAdsFields/campaign.

Atrybut zasobu (ATTRIBUTE)

Na przykład: googleAdsFields/campaign.name.

Pole segmentacji (SEGMENT)

Na przykład: googleAdsFields/segments.ad_network_type.

Dane (METRIC)

Na przykład: googleAdsFields/metrics.clicks.