Mit GoogleAdsFieldService
können Sie den Katalog nach Ressourcen, Ressourcenfeldern, Segmentierungsschlüsseln und Messwerten, die in den GoogleAdsService
-Methoden Search und SearchStream verfügbar sind, dynamisch anfordern. 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
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 die Ressource ad_group zurückgegeben wurde:
Anfragen
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 ausgefüllt, in denencategory
den WertRESOURCE
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. Wird nur für Felder ausgefüllt, bei denencategory
den WertRESOURCE
hat. selectableWith
-
- Felder, die zusammen mit einem bestimmten Feld ausgewählt werden können, wenn sie nicht in der
FROM
-Klausel enthalten sind. Dieses Attribut ist nur relevant, wenn Sie Ressourcen oder Segmente ermitteln, die in einer Abfrage ausgewählt werden können, wenn sie nicht von der Ressource in derFROM
-Klausel enthalten sind. Wenn Sie beispielsweisead_group.id
undsegments.date
ausad_group
auswählen und Attribute auscampaign
einbeziehen möchten, müssen wir prüfen, obsegments.date
im AttributselectableWith
für die Kampagne enthalten ist, da es neben dem vorhandenen Feldsegments.date
ausgewählt wird.
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
.