Ressourcenmetadaten

Mit GoogleAdsFieldService können Sie den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten durchsuchen, die in den Methoden GoogleAdsService Search und SearchStream verfügbar sind. 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 HTTP-Anfrage und -Antwort

Hinweis: Das Beispiel zeigt die zugrunde liegende HTTP/JSON-Anfrage als Orientierungshilfe. Wir empfehlen Ihnen jedoch dringend, eine der Clientbibliotheken auf Grundlage von gRPC zu verwenden, um Ihre Anfragen zu senden.

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

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

Im folgenden Beispiel sehen Sie eine Anfrage und die Antwort, die von GoogleAdsFieldService für die Ressource ad_group zurückgegeben wird:

Anfrage

https://googleads.googleapis.com/v20/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 wichtigen Arrays:

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 RESOURCE ist.

segments

Segment-Schlü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, in denen category RESOURCE ist.

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 Ressourcen oder Segmente identifiziert werden, die in einer Abfrage ausgewählt werden können, in der sie nicht von der Ressource in der FROM-Klausel enthalten sind. Wenn wir 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 zusammen mit dem vorhandenen Feld segments.date ausgewählt wird.

Metadatendetails

Sie können den Katalog mit GoogleAdsFieldService auf diesen 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.