Google Ads Query Language

le Google Ads Query Language peut interroger L’API Google Ads pour les

ressources et leurs attributs, segments et métriques associés en utilisantGoogleAdsServiceSearch or SearchStream le résultat D’une requête GoogleAdsService est une liste d’instancesGoogleAdsRow, avec ID= »0a0422083f »>représentant une ressource. Si des attributs ou des mesures sont demandés, therow inclut également ces champs., Si des segments sont demandés, theresponse affiche également une ligne supplémentaire pour chaque tuple segment-ressource. Métadonnées sur les champs et ressources disponibles dansGoogleAdsFieldService

Ce service fournit un catalogue de champs interrogeables avec des détails sur leur compatibilité et leur type.

Le résultat à partir d’un GoogleAdsFieldService query est une liste deGoogleAdsField cas, avec chaqueGoogleAdsField contenant des détails sur la demande de terrain.,

interrogation des attributs d’une ressource

Voici une requête de base pour les attributs de la ressource de campagne, illustrant comment retourner l’ID, le nom et l’état de la campagne:

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

cette requête est ordonnée par ID de campagne. Chaque GoogleAdsRow résulterait représenterait campaign objet rempli avec les champs sélectionnés (y compris celui de givencampaign resource_name).

pour savoir quels autres champs sont disponibles pour les requêtes campaign, consultez la documentation de référenceCampaign.,

interrogation des métriques

en plus des attributs sélectionnés pour une ressource donnée, vous pouvez également interroger les métriques liées:

cette requête filtre uniquement les campagnes dont le statut estPAUSED et qui ont eu plus de 1000 impressions, lors de la commande par ID de campagne. Eachresulting GoogleAdsRow aurait metrics champs theselected métriques.

pour une liste de métriques interrogeables, consultez la documentationMetrics.,

interrogation de segments

parallèlement aux attributs sélectionnés pour une ressource donnée, vous pouvez également interroger des segments liés:

similaire à l’interrogation de métriques, cette requête filtre uniquement les campagnes qui ont un statutPAUSED et ont eu plus de 1000 impressions; cependant,cette requête segmente les données par date. Cela conduit à chaque résultat GoogleAdsRowreprésentant un tuple d’une campagne et la date Segment. Il est important de noter que la segmentation divise les métriques sélectionnées, en les regroupant par chaque segment dans la clause SELECT.,

pour une liste de segments interrogeables, consultez la documentationSegments.

dans une requête pour une ressource donnée, vous pourrez peut-être vous joindre à d’autres ressources relatedresources si elles sont disponibles. Ces ressources connexes sont connues sous le nom de »ressources attribuées ». Vous pouvez joindre implicitement des ressources attribuées en sélectionnant anattribute dans votre requête.

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

cette requête sélectionne non seulement les attributs de la campagne, mais extrait également les attributs relatedattributes de chaque campagne sélectionnée., Chaque GoogleAdsRow représente uncampaign objet rempli avec les attributs de campagne sélectionnés ainsi que l’attribut de stratégie d’enchères sélectionnébidding_strategy.name.

pour savoir quelles ressources attribuées sont disponibles pour les requêtes de campagne,consultez la documentation de référence Campaign.

Mutant en fonction des résultats de la requête

lors de l’interrogation d’une ressource donnée, vous pouvez immédiatement prendre ces returnedresults en tant qu’objets, les modifier et les renvoyer à la méthode mutate dans le service de thatresource., Voici un exemple de workflow:

1. exécutez une requête pour toutes les campagnes qui sont actuellement PAUSED et ont des impressions supérieures à 1000.
2. Obtenir le Campaign objet à partir de la balise campaign champ de chaque GoogleAdsRow dans la réponse.
3. Changer le statut de chaque campagne de PAUSED de ENABLED.
4. appelez CampaignService.MutateCampaignsavec les campagnes modifiées pour les mettre à jour.,

métadonnées de champ

les requêtes envoyées àGoogleAdsFieldService sont destinées à récupérer les métadonnées de champ.Ces informations peuvent être utilisées pour comprendre comment les champs peuvent être utilisés ensemble dans une requête. Étant donné que les données sont disponibles à partir de l’API et qu’elles fournissent les données nécessaires pour valider ou créer une requête, cela permet aux développeurs de doser par programme. Voici une requête atypique pour les métadonnées:

pour une liste de champs interrogeables, consultez la documentationGoogleAdsField.,

exemples de Code

les bibliothèques clientes ont des exemples d’utilisation du langage de requête Google Ads dansGoogleAdsService. Les opérations de base du dossier hasexamples GetCampaigns, GetKeywords et GetArtifactMetadata.Le dossier de rapport a un exemple GetKeywordStats.