Ressourcenmetadaten

Mit GoogleAdsFieldService können Sie den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten anfordern, die in den GoogleAdsService-Methoden 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. Es wird jedoch dringend empfohlen, eine der Clientbibliotheken zu verwenden, die auf gRPC basieren, um Ihre Anfragen zu senden.

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

https://googleads.googleapis.com/v16/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/v16/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 dies die folgenden wichtigen Arrays:

attributeResources

Ressourcen, die in der FROM-Klausel implizit mit der Ressource 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 zusammen 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 den Wert RESOURCE hat.

selectableWith

Felder, die neben einem bestimmten Feld ausgewählt werden können, wenn nicht in der FROM-Klausel enthalten ist. Dieses Attribut ist nur relevant, wenn Ressourcen oder Segmente identifiziert werden, die in einer Abfrage ausgewählt werden können und bei denen 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 Sie prüfen, ob segments.date im Attribut selectableWith der Kampagne enthalten ist, da es neben dem vorhandenen Feld segments.date ausgewählt wird.

Metadatendetails

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