Puoi utilizzare SearchAds360FieldService
richiedere in modo dinamico le risorse, i campi delle risorse
le chiavi e le metriche di segmentazione disponibili in SearchAds360Service
Search
e SearchStream
. Il catalogo fornisce metadati che possono essere
utilizzata dai clienti dell'API Search Ads 360 Reporting per la convalida e la creazione di Search Ads 360
Istruzioni Query Language.
Esempio di richiesta e risposta HTTP
La richiesta è composta da un HTTP GET
al server dell'API Search Ads 360 Reporting API
seguente URL:
https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}
Di seguito è riportato un esempio di richiesta seguita dalla risposta restituita da
SearchAds360FieldService
per la risorsa ad_group:
Richiesta
https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group
Risposta
{
"resourceName": "searchAds360Fields/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 nell'account
FROM
. metrics
- Metriche disponibili per essere selezionate con la risorsa nell'elemento
FROM
una clausola. 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 dovecategory
èRESOURCE
. selectableWith
- Campi che possono essere selezionati insieme a un determinato campo, quando non in
FROM
una clausola. Questo attributo è pertinente solo per l'identificazione di risorse o segmenti che possono essere selezionati in una query in cui non sono inclusi risorsa nella clausolaFROM
. Ad esempio, se selezioniad_group.id
esegments.date
daad_group
e vuoi includere attributi dacampaign
, devi verificare chesegments.date
sia in AttributoselectableWith
per la campagna, poiché viene selezionato insieme a camposegments.date
esistente.
Dettagli metadati
Puoi richiedere il catalogo utilizzando il SearchAds360FieldService
in questi
livelli:
- Risorsa
- Ad esempio,
searchAds360Fields/campaign
. - Campo della risorsa
- Ad esempio,
searchAds360Fields/campaign.name
. - Campo di segmentazione
- Ad esempio,
searchAds360Fields/segments.ad_network_type
. - Metrica
- Ad esempio,
searchAds360Fields/metrics.clicks
.
Utilizzare una query per ottenere i dettagli dei campi
È possibile ottenere i dettagli dei campi inviando una query a
https://searchads360.googleapis.com/v0/searchAds360Fields:search
Esempio 1: utilizzo di un'espressione regolare.
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE name LIKE 'ad_group.%'"
Esempio 2: interrogare specifici campi, metriche o segmenti.
SELECT
name,
category,
selectable,
filterable,
sortable,
selectable_with,
data_type,
is_repeated
WHERE
name IN (
"ad_group.id",
"ad_group.name",
"segments.date",
"customer.id",
"customer.manager",
"metrics.clicks"
)