Récupération des objets

Objectif :Comprendre comment récupérer des objets et des statistiques de performances à l'aide de GoogleAdsService Concernant les concepts liés à la création de rapports, consultez les guides sur les rapports.

GoogleAdsService est l'objet unifié. de récupération et de création de rapports de l'API Google Ads. Le service utilise des méthodes qui:

• Récupérez des attributs spécifiques d'objets.
• Récupérez les métriques de performances d'objets en fonction d'une plage de dates.
• Ordonnez les objets en fonction de leurs attributs.
• Utilisez des conditions pour indiquer les objets à renvoyer dans la réponse.
• Limitez le nombre d'objets renvoyés.

Le GoogleAdsService peut renvoyer des résultats dans de deux manières:

• GoogleAdsService.SearchStream renvoie toutes les lignes dans une seule réponse de flux, ce qui est plus efficace pour de grands ensembles de résultats (plus de 10 000 lignes). Cela pourrait être plus approprié si votre application par lot souhaite télécharger un maximum de données possible.
• GoogleAdsService.Search rompt les réponses volumineuses en pages de résultats gérables. Cela pourrait être plus approprié si votre application interactive affiche une page de résultats à une en temps réel.

En savoir plus sur la pagination et le streaming

Envoyer une requête

La méthode de recherche nécessite SearchGoogleAdsRequest, qui comprend des attributs suivants:

• customer_id
• Un langage de requête Google Ads query qui indique la ressource à interroger, les attributs les segments et les métriques à récupérer, ainsi que les conditions à utiliser pour restreindre les objets renvoyés
• (GoogleAdsService.Search uniquement) A page_size pour indiquer le nombre d'objets à renvoyer dans une seule réponse lorsque à l'aide de la pagination.
• (GoogleAdsService.Search uniquement) Une la fonction page_token facultative pour récupérer le lot suivant de résultats lorsque vous utilisez pagination.

Pour plus d'informations sur ce langage, consultez l'article Google Ads Query Language guide de démarrage.

Traiter une réponse

Le GoogleAdsService renvoie une liste de Objets GoogleAdsRow.

Chaque GoogleAdsRow représente un objet renvoyé par une requête et se compose d'un d'attributs renseignés en fonction des champs demandés dans le SELECT. Les attributs non inclus dans la clause SELECT ne sont pas renseignés dans les objets GoogleAdsRow de la réponse.

Par exemple, bien qu'un ad_group_criterion possède un attribut status, Le champ status de l'attribut ad_group_criterion de la ligne n'est pas renseigné dans une réponse à une requête dans laquelle la clause SELECT n'inclut pas ad_group_criterion.status De même, l'attribut campaign de la ligne est n'est pas renseigné si la clause SELECT n'inclut aucun champ du campaign.

Chaque GoogleAdsRow peut avoir des attributs et des métriques différents d'une autre ligne dans le même ensemble de résultats. les lignes doivent donc être vues comme des objets et non comme les lignes fixes d'un tableau.

Types d'énumération UNKNOWN

Les ressources renvoyées avec un type UNKNOWN ne sont pas entièrement compatibles avec cette version de l'API. Ces ressources ont pu être créées via d'autres via des interfaces utilisateur telles que l'interface utilisateur Google Ads. Vous pouvez sélectionner des métriques lorsqu'une ressource Type UNKNOWN, mais vous ne pouvez pas modifier la ressource via l'API. Une par exemple, l'introduction d'une nouvelle campagne ou annonce dans l'interface utilisateur, n'est pas compatible avec la version de l'API que vous interrogez.

Voici quelques points à retenir:

• Une ressource de type UNKNOWN peut être prise en charge ultérieurement ou rester UNKNOWN. indéfiniment.
• De nouveaux objets de type UNKNOWN peuvent apparaître à tout moment. Ces objets sont rétrocompatible, car la valeur d'énumération est déjà disponible. Ressources sont introduits dès qu'ils sont disponibles afin que vous ayez une une vue précise de votre compte. La ressource UNKNOWN peut s'afficher pour les raisons suivantes : de nouvelles activités dans votre compte via d'autres interfaces ou lorsqu'une ressource n'est plus pris en charge.
• Les ressources UNKNOWN peuvent être associées à des métriques détaillées interrogeables.
• Les ressources UNKNOWN sont généralement entièrement visibles dans l'UI Google Ads.
• Les ressources UNKNOWN ne peuvent généralement pas être mutées.

Segmentation

La réponse contiendrait un élément GoogleAdsRow pour chaque combinaison des suivantes:

• Instance de la ressource principale spécifiée dans la clause FROM
• Valeur de chaque champ segment sélectionné

Par exemple, la réponse à une requête qui sélectionne FROM campaign et qui contient Dans la clause SELECT, segments.ad_network_type et segments.date contiennent une ligne pour chaque combinaison des éléments suivants:

• campaign
• segments.ad_network_type
• segments.date

Les résultats sont implicitement segmentés en fonction de chaque instance de la ressource principale, et non par les valeurs de chaque champ sélectionné. Par exemple,

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

génère une ligne par campagne, et non une ligne par valeur distincte de campaign.status.