Annunci Google Query Language

Annunci Google Linguaggio di Query può query di Annunci Google API per

Risorse e i relativi attributi, segmenti e metriche utilizzando GoogleAdsService Ricerca o SearchStream Il risultato di un GoogleAdsService query è una lista diGoogleAdsRow istanze, con ogni GoogleAdsRowrappresenta una risorsa. Se vengono richiesti attributi o metriche, therow include anche quei campi., Se vengono richiesti segmenti, theresponse mostra anche una riga aggiuntiva per ogni tupla di risorse di segmento. Metadati relativi ai campi e alle risorse disponibili in GoogleAdsFieldService

Questo servizio fornisce un catalogo di campi interrogabili con specifiche sulla loro compatibilità e tipo.

Il risultato di una query GoogleAdsFieldService è un elenco di istanzeGoogleAdsField, con ogniGoogleAdsField contenente dettagli sul campo richiesto.,

Interrogazione degli attributi di una risorsa

Di seguito è riportata una query di base per gli attributi della risorsa campaign, che illustra come restituire ID, nome e stato della campagna:

SELECT campaign.id, campaign.name, campaign.statusFROM campaignORDER BY campaign.id

Questa query ordina per ID della campagna. Ogni GoogleAdsRow risultante rappresenterebbecampaign oggetto popolato con i campi selezionati (incluso quello di givencampaign resource_name).

Per scoprire quali altri campi sono disponibili per le query della campagna, consultare la documentazione di riferimentoCampaign.,

Interrogando le metriche

Accanto agli attributi selezionati per una determinata risorsa, puoi anche interrogare le metriche correlate:

Questa query filtra solo per le campagne che hanno uno stato diPAUSED e hanno avuto più di 1000 impression, mentre ordinano per ID campagna. Eachresulting GoogleAdsRowavrebbe un campometrics popolato con le metriche selezionate.

Per un elenco di metriche interrogabili, consultare la documentazione Metrics.,

Interrogare i segmenti

Accanto agli attributi selezionati per una determinata risorsa, è anche possibile interrogare i segmenti correlati:

Simile all’interrogazione per le metriche, questa query filtra solo le campagne che hanno uno stato diPAUSED e hanno avuto più di 1000 impressioni; tuttavia,questa query segmenta i dati per data. Ciò porta a ogniGoogleAdsRow risultante che rappresenta una tupla di una campagna e la data Segment. È importante notare che la segmentazione divide le metriche selezionate, raggruppandole per ciascun segmento nella clausola SELECT.,

Per un elenco di segmenti interrogabili, consultare la documentazione Segments.

In una query per una determinata risorsa, potresti essere in grado di unirti ad altre risorse relatedresources se disponibili. Queste risorse correlate sono note come”attributedresources”. È possibile unire implicitamente le risorse attribuite selezionando anattribute nella query.

SELECT campaign.id, campaign.name, campaign.status, bidding_strategy.nameFROM campaignORDER BY campaign.id

Questa query non solo seleziona gli attributi della campagna, ma estrae anche gli attributi correlati da ogni campagna selezionata., Ogni oggetto risultanteGoogleAdsRow rappresenta uncampaign popolato con gli attributi della campagna selezionati e l’attributo della strategia di offerta selezionatabidding_strategy.name.

Per scoprire quali risorse attribuite sono disponibili per le query della campagna,consultare la documentazione di riferimento Campaign.

Mutando in base ai risultati della query

Quando si esegue un’interrogazione per una determinata risorsa, è possibile prendere immediatamente i returnedresults come oggetti, modificarli e rispedirli al metodo mutate nel servizio di thatresource., Di seguito è riportato un flusso di lavoro di esempio:

1. Esegui una query per tutte le campagne che sono attualmentePAUSED e hanno impressioni superiori a 1000.
2. Ottieni l’oggettoCampaign dal campocampaign di ogniGoogleAdsRow nella risposta.
3. Cambia lo stato di ogni campagna da PAUSEDaENABLED.
4. Chiama CampaignService.MutateCampaigns con le campagne modificate per aggiornarle.,

Metadati di campo

Le query inviate aGoogleAdsFieldService sono destinate al recupero dei metadati di campo.Queste informazioni possono essere utilizzate per capire come i campi possono essere utilizzati insiemein una query. Poiché i dati sono disponibili dall’API e fornisce il necessarymetadata necessario per convalidare o creare una query, ciò consente agli sviluppatori di dosare a livello di codice. Ecco una query atipica per i metadati:

Per un elenco di campi interrogabili, consultare la documentazione GoogleAdsField.,

Esempi di codice

Le librerie client hanno esempi di utilizzo del linguaggio di query di Google Ads inGoogleAdsService. La cartella delle operazioni di base ha esempi comeGetCampaigns,GetKeywords eGetArtifactMetadata.La cartella di report ha un esempioGetKeywordStats.