Puoi utilizzare GoogleAdsFieldService
per richiedere in modo dinamico al catalogo risorse, campi delle risorse, chiavi di segmentazione
e metriche disponibili nei metodi GoogleAdsService
Ricerca e SearchStream. Il catalogo fornisce metadati che possono essere utilizzati dai client dell'API Google Ads per la convalida e la creazione di istruzioni per il linguaggio di query di Google Ads.
Esempio di richiesta e risposta HTTP
La richiesta è composta da un HTTP GET
al server dell'API Google Ads al seguente URL:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
Di seguito è riportato un esempio di richiesta seguita dalla risposta restituita da GoogleAdsFieldService
per la risorsa ad_group:
Richiesta
https://googleads.googleapis.com/v17/googleAdsFields/ad_group
Risposta
{
"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",
...
]
}
Per questo esempio, gli array importanti sono:
attributeResources
- Risorse che possono essere unite implicitamente alla risorsa nella clausola
FROM
. metrics
- Metriche disponibili per essere selezionate con la risorsa nella clausola
FROM
. Compilato solo per i campi in cuicategory
èRESOURCE
. segments
- Segmenta le chiavi che possono essere selezionate con la risorsa nella clausola
FROM
. Consentono di segmentare le metriche specificate nella query. Compilato solo per i campi in cuicategory
èRESOURCE
. selectableWith
-
- Campi che possono essere selezionati insieme a un determinato campo, quando non nella clausola
FROM
. Questo attributo è pertinente solo per identificare le risorse o i segmenti che possono essere selezionati in una query in cui non sono inclusi dalla risorsa nella clausolaFROM
. Ad esempio, se selezioniamoad_group.id
esegments.date
daad_group
e vogliamo includere gli attributi dicampaign
, dobbiamo verificare chesegments.date
sia nell'attributoselectableWith
della campagna, poiché è selezionato insieme al camposegments.date
esistente.
Dettagli metadati
Puoi richiedere il catalogo utilizzando GoogleAdsFieldService
a questi livelli:
- Risorsa
- Ad esempio,
googleAdsFields/campaign
. - Campo della risorsa
- Ad esempio,
googleAdsFields/campaign.name
. - Campo di segmentazione
- Ad esempio,
googleAdsFields/segments.ad_network_type
. - Metrica
- Ad esempio,
googleAdsFields/metrics.clicks
.