Ressourcenmetadaten

Mit GoogleAdsFieldService können Sie den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten abfragen, 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 zum Erstellen von Google Ads Query Language-Anweisungen verwendet werden können.

Beispiel für eine HTTP-Anfrage und ‑Antwort

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

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

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

Im Folgenden sehen Sie ein Beispiel für eine Anfrage, gefolgt von der Antwort, die von GoogleAdsFieldService für die Ressource ad_group zurückgegeben wurde:

Anfrage

https://googleads.googleapis.com/v19/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",
    ...
  ]
}

Für dieses Beispiel sind die wichtigen Arrays:

attributeResources

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

metrics

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

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 = 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 durch die 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 selectableWith-Attribut für die Kampagne enthalten ist, da es zusammen mit dem vorhandenen segments.date-Feld ausgewählt wird.

Metadatendetails

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