Sie können GoogleAdsFieldService
verwenden
Um den Katalog dynamisch nach Ressourcen, Ressourcenfeldern, Segmentierung
Schlüssel und Messwerte in der GoogleAdsService
Search und SearchStream. Der Katalog enthält Metadaten, die
werden von Google Ads API-Clients zur Validierung und Erstellung von Google Ads Query Language-Anweisungen verwendet.
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 vom
GoogleAdsFieldService
für Ressource ad_group:
Anfrage
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. Nur ausgefüllt für Felder, 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. Nur für Felder ausgefüllt Dabei istcategory
RESOURCE
. selectableWith
-
- Felder, die zusammen mit einem bestimmten Feld ausgewählt werden können, wenn sie nicht im
FROM
Klausel. Dieses Attribut ist nur für die Identifizierung von Ressourcen oder Segmenten relevant. die in einer Abfrage ausgewählt werden können, wo sie nicht vom Ressource in derFROM
-Klausel. Wenn wir beispielsweisead_group.id
auswählen, undsegments.date
ausad_group
und wir möchten Attribute auscampaign
, müssen wir prüfen, ob sichsegments.date
imselectableWith
befindet Attribut für die Kampagne, da es zusammen mit den vorhandenensegments.date
.
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
.