Recupero oggetti in corso...

GoogleAdsService è l'oggetto unificato di recupero e reporting dell'API Google Ads. Il servizio prevede metodi che:

• Recuperare attributi specifici degli oggetti.
• Recupera le metriche delle prestazioni per gli oggetti in base a un intervallo di date.
• Ordinare gli oggetti in base ai relativi 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 in due modi:

• GoogleAdsService.SearchStream restituisce tutte le righe in una singola risposta in modalità flusso che è più efficiente set di risultati di grandi dimensioni (più di 10.000 righe). Questa opzione potrebbe essere più appropriata se la tua applicazione batch desidera scaricare tutti i dati alla possibile.
• GoogleAdsService.Search si separa risposte di grandi dimensioni in pagine di risultati gestibili. Questo potrebbe essere più appropriata se la tua applicazione interattiva visualizza una pagina di risultati in nel tempo.

Scopri di più su paging e streaming.

Fai una richiesta

Il metodo di ricerca richiede SearchGoogleAdsRequest, che consiste dei seguenti attributi:

• customer_id
• Un linguaggio di query di Google Ads query che indica la risorsa su cui eseguire la query, gli attributi segmenti e metriche da recuperare e le condizioni da utilizzare per limitare quali oggetti vengono restituiti
• (Solo GoogleAdsService.Search) Un page_size per indicare quanti oggetti restituire in una singola risposta quando utilizzando il paging.
• (Solo GoogleAdsService.Search) Un page_token facoltativo per recuperare il batch successivo di risultati quando utilizzi paging.

Per ulteriori informazioni sul linguaggio di query di Google Ads, consulta Il linguaggio di query di Google Ads. .

Elaborare una risposta

L'elemento GoogleAdsService restituisce un elenco di GoogleAdsRow oggetti.

Ciascun GoogleAdsRow rappresenta un oggetto restituito da una query ed è composto da un di attributi che vengono compilati in base ai campi richiesti nel Clausola SELECT. Gli attributi non inclusi nella clausola SELECT non vengono completati negli oggetti GoogleAdsRow nella risposta.

Ad esempio, anche se un ad_group_criterion ha un attributo status, il valore Il campo status dell'attributo ad_group_criterion della riga non è compilato in un per una query in cui la clausola SELECT non include ad_group_criterion.status. Analogamente, l'attributo campaign della riga è non compilata se la clausola SELECT non include alcun campo della campaign risorsa.

Ogni GoogleAdsRow può avere attributi e metriche diversi da un'altra riga nello stesso set di risultati; pertanto le righe dovrebbero essere visualizzate come oggetti righe fisse di una tabella.

Tipi di enum SCONOSCIUTI

Le risorse restituite con un tipo UNKNOWN non sono completamente supportate in quella versione dell'API. Queste risorse potrebbero essere state create tramite come la UI di Google Ads. Puoi selezionare le metriche quando una risorsa ha un di tipo UNKNOWN, ma non puoi modificare la risorsa tramite l'API. Un potrebbe essere una nuova campagna o un nuovo annuncio introdotto nell'interfaccia utente, mentre non supportata nella versione API su cui si esegue la query.

Ecco alcune considerazioni da tenere presente:

• Una risorsa di tipo UNKNOWN può essere supportata in un secondo momento oppure rimanere UNKNOWN a tempo indeterminato.
• I nuovi oggetti di tipo UNKNOWN possono essere visualizzati in qualsiasi momento. Questi oggetti compatibile con le versioni precedenti perché il valore enum è già disponibile. Risorse vengono introdotti con questa modifica quando sono disponibili, in modo che una panoramica precisa dell'account. La risorsa UNKNOWN può essere visualizzata a causa di nuove attività nel tuo account tramite altre interfacce o quando non è più supportato.
• A UNKNOWN risorsa è possibile collegare metriche dettagliate che sono interrogabile.
• UNKNOWN risorse sono in genere completamente visibili nell'interfaccia utente di Google Ads.
• Le risorse UNKNOWN generalmente non possono essere mutate.

Segmentazione

La risposta conterrà un GoogleAdsRow per ogni combinazione di seguenti:

• Istanza della risorsa principale specificata nella clausola FROM
• Valore di ogni campo segment selezionato

Ad esempio, la risposta per una query che seleziona FROM campaign e ha segments.ad_network_type e segments.date nella clausola SELECT devono deve contenere una riga per ciascuna combinazione dei seguenti elementi:

• campaign
• segments.ad_network_type
• segments.date

I risultati vengono implicitamente segmentati per ogni istanza della risorsa principale, non per i valori dei singoli campi selezionati. Ad esempio,

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

crea una riga per campagna, non una riga per ogni valore distinto del campaign.status.