Ressourcenmetadaten

Sie können GoogleAdsFieldService (über GetGoogleAdsField oder SearchGoogleAdsFields) verwenden, um den Katalog der Ressourcen, Ressourcenfelder, Segmentierungsschlüssel und Messwerte, die in den Methoden GoogleAdsService Search und SearchStream verfügbar sind, dynamisch anzufordern. 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 jedoch dringend, eine der Clientbibliotheken auf Basis 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/v26/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 wird:

Anfrage

https://googleads.googleapis.com/v26/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, ohne dass Messwerte segmentiert werden. Wird nur für Felder ausgefüllt, bei denen der category RESOURCE ist.

metrics

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

segments

Segmentierungsschlüssel (segments.*-Felder und Segmentierungsressourcen), die mit der Ressource in der FROM-Klausel ausgewählt werden können. Diese segmentieren die in der Abfrage angegebenen Messwerte. Wird nur für Felder ausgefüllt, bei denen der category RESOURCE ist.

selectableWith

Ressourcen, Segmente oder Messwerte, die in derselben Google Ads Query Language-Abfrage ausgewählt werden können, wenn diese Ressource oder dieses Segment nicht die primäre Ressource in der FROM-Klausel ist.

Kompatibilität mit „selectableWith“ abfragen

Das Attribut selectableWith für ein Ressourcen- oder Segmentfeld gibt andere Ressourcen, Segmente oder Messwerte an, die in derselben Google Ads Query Language-Abfrage ausgewählt werden können. Dieses Attribut ist wichtig, wenn Sie Felder aus einer Ressource oder einem Segment einbeziehen möchten, die nicht in der FROM-Klausel angegeben sind.

Beachten Sie beim Erstellen einer Google Ads Query Language-Abfrage Folgendes:

1. Die Ressource in der FROM-Klausel ist die primäre Entität. Sie können jederzeit Felder aus dieser Ressource auswählen.
2. Sie können auch kompatible Messwerte und Segmente auswählen, die für die primäre Entität verfügbar sind.
3. Wenn Sie Felder aus einer Ressource oder einem Segment außerhalb der FROM-Klausel einbeziehen, müssen Sie darauf achten, dass diese Ressource oder dieses Segment, die nicht in der FROM-Klausel enthalten sind, mit allen anderen Feldern, Segmenten und Messwerten kompatibel sind, die in der Abfrage ausgewählt werden.

Die selectableWith-Liste für eine bestimmte Ressource (Ressource A) enthält alle anderen Ressourcen, Segmente und Messwerte, die zusammen mit Feldern aus Ressource A ausgewählt werden können, wenn Ressource A nicht die primäre Entität ist.

Beispiel

Betrachten Sie diese Beispielabfrage:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group

• In der FROM-Klausel wird ad_group angegeben.
• Mit dieser Abfrage werden ad_group.id (aus der Ressource FROM), segments.date und campaign.name ausgewählt.
• Da campaign.name ausgewählt ist, aber campaign nicht in der FROM-Klausel enthalten ist, müssen Sie die Kompatibilität mit anderen ausgewählten Elementen prüfen.
• Damit diese Abfrage gültig ist, muss die Ressource campaign mit segments.date (einem anderen ausgewählten Feld) kompatibel sein. Daher müssen Sie das Attribut selectableWith für die Ressource campaign prüfen. Wenn segments.date in der selectableWith-Liste von campaign vorhanden ist, ist die Abfrage gültig.

Wenn Sie Felder aus einer Ressource auswählen, die nicht in der FROM-Klausel enthalten ist, muss die selectableWith-Liste dieser Ressource alle anderen Segmente und Ressourcen enthalten, die in der SELECT-Klausel vorhanden sind.

Metadatendetails

Sie können den Katalog mit GoogleAdsFieldService (entweder nach Ressourcenname mit GetGoogleAdsField oder durch Abfrage mit SearchGoogleAdsFields) auf den folgenden GoogleAdsFieldCategory-Ebenen anfordern:

Ressource (RESOURCE)

Beispiel: googleAdsFields/campaign.

Ressourcenattribut (ATTRIBUTE)

Beispiel: googleAdsFields/campaign.name.

Segmentierungsfeld (SEGMENT)

Beispiel: googleAdsFields/segments.ad_network_type.

Messwert (METRIC)

Beispiel: googleAdsFields/metrics.clicks.