Cette page a été traduite par l'API Cloud Translation.

Langage de requête Google Ads

Le langage de requête Google Ads permet d'interroger l'API Google Ads

Les ressources et leurs attributs, segments et métriques associés à l'aide de

GoogleAdsService Search ou SearchStream

Le résultat d'une requête GoogleAdsService est une liste Instances GoogleAdsRow, avec chaque GoogleAdsRow représentant une ressource. Si des attributs ou des métriques sont demandés, alors inclut également ces champs. Si des segments sont demandés, alors le affiche également une ligne supplémentaire pour chaque tuple segment-ressource.

Les métadonnées sur les champs et ressources disponibles dans

GoogleAdsFieldService

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

Le résultat d'une requête GoogleAdsFieldService est une liste de GoogleAdsField instances, chacune GoogleAdsField contenant des informations sur le champ demandé.

Interroger les attributs d'une ressource

Vous trouverez ci-dessous une requête de base pour les attributs de la ressource de campagne, pour obtenir l'ID, le nom et l'état de la campagne:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

Cette requête trie par ID de campagne. Chaque GoogleAdsRow obtenu représenterait Un objet campaign contenant les champs sélectionnés (y compris ceux indiqués resource_name de la campagne).

Pour connaître les autres champs disponibles pour les requêtes de campagne, consultez le Documentation de référence sur Campaign

Interroger des métriques

En plus des attributs sélectionnés pour une ressource donnée, vous pouvez également rechercher métriques associées:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

Cette requête filtre uniquement les campagnes dont l'état est PAUSED et ont enregistré plus de 1 000 impressions, en les triant par ID de campagne. Chaque La GoogleAdsRow résultante aurait un champ metrics renseigné avec le les métriques sélectionnées.

Pour obtenir la liste des métriques pouvant faire l'objet de requêtes, consultez le Metrics documentation.

Interroger des segments

En plus des attributs sélectionnés pour une ressource donnée, vous pouvez également rechercher segments associés:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

À l'instar des requêtes de métriques, cette requête filtre uniquement les campagnes qui sont associés à l'état PAUSED et ont généré plus de 1 000 impressions ; Toutefois, cette requête segmente les données par date. Cela conduit à chaque résultat obtenu GoogleAdsRow représentant le tuple d'une campagne et la date Segment. Il est il est important de noter que la segmentation divise les métriques sélectionnées, en les regroupant selon chacune segment dans la clause SELECT.

Pour obtenir la liste des segments pouvant faire l'objet de requêtes, consultez le Segments documentation.

Interroger les attributs d'une ressource associée

Dans une requête pour une ressource donnée, vous pouvez effectuer une jointure avec d'autres ressources, le cas échéant. Ces ressources associées sont appelées ressources. Vous pouvez associer implicitement des ressources attribuées en sélectionnant une dans votre requête.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

Cette requête permet de sélectionner les attributs de la campagne de chaque campagne sélectionnée. Chaque GoogleAdsRow obtenu représente Un objet campaign contenant les attributs de campagne sélectionnés ainsi que l'attribut de stratégie d'enchères bidding_strategy.name sélectionné.

Afin d'identifier les ressources attribuées disponibles pour les requêtes liées aux campagnes, consultez la documentation de référence de Campaign.

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

Lorsque vous interrogez une ressource donnée, vous pouvez immédiatement récupérer en tant qu'objets, les modifier et les renvoyer à la méthode mutate dans cette le service de la ressource. Voici un exemple de workflow:

Exécutez une requête pour toutes les campagnes actuellement en PAUSED et pour lesquelles d'impressions supérieures à 1 000.
Récupérez l'objet Campaign à partir du champ campaign de chaque GoogleAdsRow dans la réponse.
Faites passer l'état de chaque campagne de PAUSED à ENABLED.
Appeler CampaignService.MutateCampaigns avec les campagnes modifiées pour les mettre à jour.

Métadonnées des champs

Les requêtes envoyées à GoogleAdsFieldService sont destinées à récupérer des métadonnées de champ. Ces informations permettent de comprendre comment les champs peuvent être utilisés ensemble dans une requête. Les données étant disponibles à partir de l'API, nécessaires à la validation ou à la création d'une requête, ce qui permet aux développeurs de façon programmatique. Voici un requête classique pour les métadonnées:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

Vous pouvez remplacer <INSERT_RESOURCE_OR_FIELD> dans cette requête par un ressource (customer ou campaign, par exemple) ou champ (campaign.id, par exemple) metrics.impressions ou ad_group.id).

Pour obtenir la liste des champs pouvant être interrogés, consultez le GoogleAdsField documentation.

Exemples de code

Les bibliothèques clientes proposent des exemples d'utilisation des Langage de requête Google Ads en GoogleAdsService. Le dossier opérations de base contient exemples tels que GetCampaigns, GetKeywords et SearchForGoogleAdsFields. Le dossier reporting contient un exemple GetKeywordStats.

Grammaire des requêtes