Ressourcenmetadaten

Sie können GoogleAdsFieldService verwenden, um den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten zu durchsuchen, die in den GoogleAdsService Search und SearchStream Methoden 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 eine HTTP-Anfrage und -Antwort

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

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

Das folgende Beispiel zeigt eine Anfrage und die Antwort, die von GoogleAdsFieldService für die Ressource ad_group zurückgegeben wird:

Anfrage

https://googleads.googleapis.com/v25/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 ausgefüllt, bei denen category gleich RESOURCE ist.

segments

Segmentierungsschlüssel, 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 category gleich RESOURCE ist.

selectableWith

Das Attribut selectableWith in einem Ressourcen- oder Segmentierungsfeld gibt andere Ressourcen, Segmente oder Messwerte an, die in derselben GAQL-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.

Beim Erstellen einer GAQL-Abfrage gilt Folgendes:

1. Die Ressource in der FROM-Klausel ist die primäre Entität. Sie können immer Felder aus dieser Ressource auswählen.
2. Sie können auch kompatible Messwerte und Segmente auswählen, die mit der primären Entität verfügbar sind.
3. Wenn Sie Felder aus einer Ressource oder einem Segment außerhalb der FROM-Klausel einbeziehen, muss diese Ressource oder dieses Segment, die bzw. das nicht in der FROM-Klausel angegeben ist, mit allen anderen Feldern, Segmenten und Messwerten kompatibel sein, die in der Abfrage ausgewählt wurden.

Die Liste selectableWith 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 :

Sehen Sie sich diese Beispielabfrage an: SELECT ad_group.id, segments.date, campaign.name FROM ad_group

• Die FROM-Klausel gibt ad_group an.

• Mit dieser Abfrage werden ad_group.id (aus der FROM-Ressource), segments.date und campaign.name ausgewählt.

• Da campaign.name ausgewählt ist, campaign aber nicht in der FROM Klausel enthalten ist, müssen Sie die Kompatibilität mit anderen ausgewählten Elementen überprü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 Liste selectableWith 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 Liste selectableWith dieser Ressource alle anderen Segmente und Ressourcen enthalten, die in der SELECT-Klausel vorhanden sind.

Metadatendetails

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