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 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

Die Anfrage besteht aus einem 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 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. 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. 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.