Google Ads Query Language (Română)

Google Ads Limbaj de Interogare poate interoga Anunțuri Google API pentru

Resurse și atributele asociate acestora, segmente, și valori, folosind GoogleAdsService Căutare sau SearchStream rezultatul de la un GoogleAdsService interogare este o listă deGoogleAdsRow cazuri, cu fiecare GoogleAdsRowreprezintă o resursă. Dacă sunt solicitate atribute sau valori, atunci therow include și acele câmpuri., Dacă sunt solicitate segmente, atuncirăspunsul arată, de asemenea, un rând suplimentar pentru fiecare segment-tuplu de resurse. Metadate despre domenii disponibile și resurse în GoogleAdsFieldService

Acest serviciu oferă un catalog de queryable domenii cu specificul abouttheir de compatibilitate și de tip.

rezultat dintr-un GoogleAdsFieldService interogare este o listă deGoogleAdsField cazuri, cu fiecareGoogleAdsField conțin detalii despre solicitat domeniu.,

pentru Interogarea atributelor de o resursă

mai Jos este o bază de interogare pentru atribute ale campaniei de resurse, care ilustrează cum să se întoarcă campanie ID, nume, și status:

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

Această interogare ordine de ID-ul de campanie. Fiecare rezultat GoogleAdsRow ar re campaign obiect populate cu câmpurile selectate (inclusiv givencampaign e resource_name).

pentru a afla ce alte câmpuri sunt disponibile pentru interogările campaniei, consultați documentația de referințăCampaign.,

Interogarea pentru valori

Alături de atribute selectate pentru o anumită resursă, puteți interoga, de asemenea, forrelated valori:

Această interogare filtre doar pentru campaniile care au un statut de PAUSED am avut mai mult de 1000 de afișări, în timp ce comanda cu ID-ul de campanie. Eachresulting GoogleAdsRow ar fi un metrics teren populat cu theselected valori.

pentru o listă de valori interogabile, consultați documentația Metrics.,

pentru Interogarea segmente

Alături de atribute selectate pentru o anumită resursă, puteți interoga, de asemenea, forrelated segmente:

Similare pentru interogarea pentru valori, această interogare filtre pentru doar campaniile thathave o stare de PAUSED și au avut mai mult de 1000 de afișări; cu toate acestea,această interogare segmente datele de întâlnire. Acest lucru duce la fiecare rezultatGoogleAdsRow reprezintă un tuplu de o campanie și data Segment. Este important să rețineți că segmentarea împarte valorile selectate, grupând după fiecare segment în clauza SELECT.,

pentru o listă de segmente interogabile, consultați documentația Segments.

într-o interogare pentru o anumită resursă, ați putea fi capabil să se alăture împotriva altor relatedresources dacă sunt disponibile. Aceste resurse conexe sunt cunoscute sub numele de”attributedresurse”. Vă puteți alătura împotriva resurselor atribuite implicit prin selectarea anattribute în interogare.

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

Această interogare nu numai selectează campanie de atribute, dar, de asemenea, trage în relatedattributes din fiecare campanie selectate., Fiecare rezultat GoogleAdsRow reprezintăun campaign obiect populate cu campania selectată de atribute precum și de standardul selectat strategia de licitare atribut bidding_strategy.name.pentru a afla ce resurse atribuite sunt disponibile pentru interogările de campanie, consultați documentația de referință Campaign.când interogarea pentru o anumită resursă, puteți lua imediat cele returnedresults ca obiecte, să le modifice, și să le trimită înapoi la metoda mutate în serviciul thatresource lui., Mai jos este un exemplu de flux de lucru:

1. Executa o interogare pentru toate campaniile care sunt în prezent PAUSED și haveimpressions mai mare decât 1000.
2. Ia Campaign obiect din campaign câmp de fiecare GoogleAdsRow în răspuns.
3. modificați starea fiecărei campanii de la PAUSED la ENABLED.
4. apel CampaignService.MutateCampaignscu campaniile modificate pentru a le actualiza.,

metadatele câmpului

interogările trimise laGoogleAdsFieldService sunt destinate recuperării metadatelor câmpului.Aceste informații pot fi utilizate pentru a înțelege modul în care câmpurile pot fi utilizate împreunăîntr-o interogare. Deoarece datele sunt disponibile de la API și oferă necesarymetadata necesare pentru a valida sau de a construi o interogare, acest lucru permite dezvoltatorilor să doso programatic. Pentru o listă de câmpuri interogabile, consultați documentația GoogleAdsField.,

Exemple de cod

bibliotecile client au Exemple de utilizare a limbajului de interogare Google Ads înGoogleAdsService. Operațiunile de bază de dosar hasexamples cum ar fi GetCampaigns, GetKeywords și GetArtifactMetadata.Dosarul de raportare are un exemplu GetKeywordStats.