Ressourcenmetadaten

Mit GoogleAdsFieldService können Sie den Katalog nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten, die in den GoogleAdsService-Methoden Search und SearchStream verfügbar sind, dynamisch anfordern. Der Katalog enthält Metadaten, die von Google Ads API-Clients zur Validierung und Erstellung von Google Ads Query Language-Anweisungen verwendet werden können.

Beispiel für eine HTTP-Anfrage und -Antwort

Die Anfrage besteht aus einer HTTP GET an den Google Ads API-Server mit der folgenden URL:

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

Das folgende Beispiel zeigt eine Anfrage, gefolgt von der Antwort, die von GoogleAdsFieldService für die Ressource ad_group zurückgegeben wurde:

Anfragen

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

Antwort

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

In diesem Beispiel sind die folgenden Arrays wichtig:

attributeResources

Ressourcen, die implizit mit der Ressource in der FROM-Klausel verknüpft werden können.

metrics

Messwerte, die mit der Ressource in der FROM-Klausel ausgewählt werden können. Wird nur für Felder ausgefüllt, in denen category den Wert RESOURCE hat.

segments

Segmentschlüssel, die mit der Ressource in der FROM-Klausel ausgewählt werden können. Damit werden die in der Abfrage angegebenen Messwerte segmentiert. Wird nur für Felder ausgefüllt, bei denen category den Wert RESOURCE hat.

selectableWith

Felder, die zusammen mit einem bestimmten Feld ausgewählt werden können, wenn sie nicht in der FROM-Klausel enthalten sind. Dieses Attribut ist nur relevant, wenn Sie Ressourcen oder Segmente ermitteln, die in einer Abfrage ausgewählt werden können, wenn sie nicht von der Ressource in der FROM-Klausel enthalten sind. Wenn Sie beispielsweise ad_group.id und segments.date aus ad_group auswählen und Attribute aus campaign einbeziehen möchten, müssen wir prüfen, ob segments.date im Attribut selectableWith für die Kampagne enthalten ist, da es neben dem vorhandenen Feld segments.date ausgewählt wird.

Metadatendetails

Sie können den Katalog mit dem GoogleAdsFieldService auf folgenden Ebenen anfordern:

Ressource

Beispiel: googleAdsFields/campaign.

Feld der Ressource

Beispiel: googleAdsFields/campaign.name.

Segmentierungsfeld

Beispiel: googleAdsFields/segments.ad_network_type.

Messwert

Beispiel: googleAdsFields/metrics.clicks.