GoogleAdsService
è il servizio unificato di recupero e generazione di report degli oggetti dell'API Google Ads. Il servizio prevede metodi che:
- Recuperare attributi specifici degli oggetti.
- Recupera le metriche sul rendimento per gli oggetti in base a un intervallo di date.
- Ordina gli oggetti in base ai loro attributi.
- Utilizza le condizioni per indicare quali oggetti vuoi che vengano restituiti nella risposta.
- Limita il numero di oggetti restituiti.
GoogleAdsService
può restituire risultati in due modi:
GoogleAdsService.SearchStream
restituisce tutte le righe in un'unica risposta di flusso di dati,il che è più efficiente per set di risultati di grandi dimensioni (più di 10.000 righe). Questa opzione potrebbe essere la soluzione più appropriata se la tua applicazione batch vuole scaricare quanti più dati possibile.GoogleAdsService.Search
suddivide le risposte di grandi dimensioni in pagine di risultati gestibili. Questo potrebbe essere più appropriato se la tua applicazione interattiva mostra una pagina di risultati alla volta.
Scopri di più su paging e streaming.
Fai una richiesta
Il metodo di ricerca richiede un elemento SearchGoogleAdsRequest
, costituito dai seguenti attributi:
- Un
customer_id
- Un linguaggio di query
query
di Google Ads che indica la risorsa su cui eseguire la query, gli attributi, i segmenti e le metriche da recuperare e le condizioni da utilizzare per limitare gli oggetti che vengono restituiti - (Solo per
GoogleAdsService.Search
) Apage_size
per indicare il numero di oggetti da restituire in una singola risposta quando si utilizza il paging. - (Solo per
GoogleAdsService.Search
) Unpage_token
facoltativo per recuperare il batch di risultati successivo quando utilizzi il paging.
Per ulteriori informazioni sul linguaggio di query di Google Ads, consulta la guida al linguaggio di query di Google Ads.
Elaborare una risposta
GoogleAdsService
restituisce un elenco di
oggetti GoogleAdsRow
.
Ogni GoogleAdsRow
rappresenta un oggetto restituito da una query ed è costituito da un insieme di attributi che vengono compilati in base ai campi richiesti nella clausola SELECT
. Gli attributi non inclusi nella clausola SELECT
non vengono
compilati negli oggetti GoogleAdsRow
nella risposta.
Ad esempio, anche se ad_group_criterion
ha un attributo status
, il campo status
dell'attributo ad_group_criterion
della riga non viene compilato nella risposta a una query in cui la clausola SELECT
non include ad_group_criterion.status
. Allo stesso modo, l'attributo campaign
della riga non viene
compilato se la clausola SELECT
non include alcun campo della
risorsa campaign
.
Ogni elemento GoogleAdsRow
può avere attributi e metriche diversi di un'altra riga
nello stesso set di risultati; pertanto, le righe devono essere visualizzate come oggetti anziché
righe fisse di una tabella.
Tipi di enumerazione SCONOSCIUTA
Le risorse restituite con un tipo di UNKNOWN
non sono completamente supportate in quella versione dell'API. Queste risorse potrebbero essere state create tramite
altre interfacce, come la UI di Google Ads. Puoi selezionare le metriche se una risorsa ha un tipo UNKNOWN
, ma non puoi modificarne la risorsa tramite l'API. Un esempio potrebbe essere una nuova campagna o un nuovo annuncio introdotto nell'interfaccia utente, ma non supportato nella versione dell'API su cui stai eseguendo la query.
Ecco alcune considerazioni da tenere presente:
- Una risorsa con un tipo
UNKNOWN
può essere supportata in un secondo momento o rimanereUNKNOWN
a tempo indeterminato. - I nuovi oggetti di tipo
UNKNOWN
possono essere visualizzati in qualsiasi momento. Questi oggetti sono compatibili con le versioni precedenti perché il valore di enumerazione è già disponibile. Le risorse vengono introdotte con questa modifica non appena sono disponibili, per consentirti di avere una visione accurata dell'account. La risorsaUNKNOWN
può essere visualizzata a causa di nuove attività nel tuo account tramite altre interfacce o quando una risorsa non è più supportata. - Alle risorse
UNKNOWN
possono essere associate metriche dettagliate su cui è possibile eseguire query. UNKNOWN
risorse sono in genere completamente visibili nella UI di Google Ads.- In genere le risorse
UNKNOWN
non possono essere modificate.
Segmentazione
La risposta conterrà un GoogleAdsRow
per ogni combinazione di quanto segue:
- Istanza della risorsa principale specificata nella clausola
FROM
- Valore di ogni campo
segment
selezionato
Ad esempio, la risposta a una query che seleziona FROM campaign
e contiene segments.ad_network_type
e segments.date
nella clausola SELECT
conterrebbe una riga per ogni combinazione di quanto segue:
campaign
segments.ad_network_type
segments.date
I risultati vengono segmentati implicitamente in base a ogni istanza della risorsa principale, non in base ai valori dei singoli campi selezionati. Ad esempio:
SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS
genera una riga per campagna, non una riga per valore distinto del
campo campaign.status
.