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
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 denencategory
den WertRESOURCE
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 denencategory
den WertRESOURCE
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 derFROM
-Klausel enthalten sind. Wenn wir beispielsweisead_group.id
undsegments.date
ausad_group
auswählen und Attribute auscampaign
einbeziehen möchten, müssen Sie prüfen, obsegments.date
im AttributselectableWith
der Kampagne enthalten ist, da es neben dem vorhandenen Feldsegments.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
.