Ressourcenmetadaten

Sie können GoogleAdsFieldService verwenden Um den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierung Schlüssel und Messwerte in der GoogleAdsService Search und SearchStream. Der Katalog enthält Metadaten, die werden von Google Ads API-Clients zur Validierung und Erstellung von Google Ads Query Language-Anweisungen verwendet.

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 vom GoogleAdsFieldService für Ressource ad_group:

Anfrage

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. Nur ausgefüllt für Felder, 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. Nur für Felder ausgefüllt Dabei ist category RESOURCE.

selectableWith

Felder, die zusammen mit einem bestimmten Feld ausgewählt werden können, wenn sie nicht im FROM Klausel. Dieses Attribut ist nur für die Identifizierung von Ressourcen oder Segmenten relevant. die in einer Abfrage ausgewählt werden können, wo sie nicht vom Ressource in der FROM-Klausel. Wenn wir beispielsweise ad_group.id auswählen, und segments.date aus ad_group und wir möchten Attribute aus campaign, müssen wir prüfen, ob sich segments.date im selectableWith befindet Attribut für die Kampagne, da es zusammen mit den vorhandenen segments.date.

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.