Publié le 16 février 2023, modifié le 2 mai 2024 par Lucie Blanchard
Google a publié la version 13.0 de l’API Google Ads et vous trouverez ci-dessous une liste de ce qui a changé. Les grands changements incluent Performance max pour les objectifs de voyage et le remarketing avec des listes d’utilisateurs basées sur des règles, mais il y a des tonnes de changements dans la version 13. La version 12.0 est sortie en octobre 2022, la version 11.0 de l’API Google Ads est sortie en juin et la version 11.1 était en août. La version 10.1 est également sortie le 27 avril 2022 et la version 10.0 est sortie le 9 février 2022. Et Google a mis fin à l’API AdWords le 27 avril, qui cessera complètement de fonctionner fin juillet. Google a publié une vidéo des principaux changements. en 13.0 :Voici la liste complète des changements :
Gestion de compte
Ajout de ProductLinkService pour prendre en charge l’ajout et la suppression d’un lien entre un compte Google Ads et un autre produit. Ceci est similaire à la vue Comptes associés dans l’interface utilisateur de Google Ads. Dans cette version, seule la liaison de partenaires de données Customer Match est prise en charge
Actifs
Ajout des champs suivants au client pour suivre l’état de la migration des ressources d’emplacement et d’image : location_asset_auto_migration_done, image_asset_auto_migration_done, location_asset_auto_migration_done_time, image_asset_auto_migration_done_time
Ajout des champs suivants à CustomerAsset, CampaignAsset, AdGroupAsset : primary_status, primary_status_details, primary_status_reasons
Ajout de Asset.field_type_policy_summaries pour renvoyer des informations sur les résumés de stratégie pour chaque type de champ
Types de champs d’actifs ; Ajout de AssetFieldType.BUSINESS_LOGO., Ajout de la prise en charge de la définition de CampaignAsset.field_type sur les valeurs suivantes : AssetFieldType.BUSINESS_NAME, AssetFieldType.BUSINESS_LOGO
INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE ajouté à, AdGroupError, CampaignError
Ajout des champs suivants à AssetSetError : OAUTH_INFO_INVALID, OAUTH_INFO_MISSING, CANNOT_DELETE_AS_ENABLED_LINKAGES_EXIST
Publics
Suppression de CombinedRuleUserListInfo et ExpressionRuleUserListInfo et leurs références de RuleBasedUserListInfo. Utilisez plutôt FlexibleUserListInfo
Ajout de QualifyingQuestion et de qualification_question pour prendre en charge le retour des détails sur les questions de qualification des actifs de formulaire de prospect. Lorsque les annonceurs suggèrent une question de qualification, celle-ci est examinée et approuvée avant d’être utilisée dans les formulaires pour prospects
Tâches par lots
Ajout de BatchJobMetadata.execution_limit_seconds pour renvoyer la limite d’exécution en secondes. Les travaux par lots seront annulés si leur temps d’exécution est supérieur à celui spécifié dans ce champ
Facturation
InvalidActivitySummary a été ajouté pour permettre de renvoyer plus de détails sur l’activité invalide pour la facture
Ajout de AccountBudgetProposalError.CANCELED_BILLING_SETUP
Campagnes
Ajout de SmartCampaignSettingService.GetSmartCampaignStatus pour récupérer une vue plus agrégée des actifs appartenant à la campagne intelligente. Cela doit être préféré aux autres champs de statut, par exemple, Campaign.primary_status ou Campaign.primary_status_reasons pour les campagnes intelligentes
Remplacé AdGroup.explorer_auto_optimizer_setting par AdGroup.optimized_targeting_enabled pour prendre en charge le ciblage optimisé. Il s’agit du AdvertisingChannelType suivant : DISPLAY, VIDEO, DISCOVERY. Ce champ est réservé aux clients autorisés
Added several new enum values to CampaignError: AVERAGE_DAILY_SPEND_TOO_HIGH, CANNOT_ATTACH_TO_REMOVED_CAMPAIGN_GROUP, CANNOT_ATTACH_TO_BIDDING_STRATEGY, CANNOT_CHANGE_BUDGET_PERIOD CANNOT_CREATE_DRAFT_CAMPAIGN, CANNOT_CREATE_MORE_THAN_ONE_DRAFT_CAMPAIGN, NOT_ENOUGH_CONVERSIONS CANNOT_SET_MORE_THAN_ONE_CONVERSION_ACTION, NOT_COMPATIBLE_WITH_BUDGET_TYPE, NOT_COMPATIBLE_WITH_UPLOAD_CLICKS_CONVERSION, TRIAL_MUST_USE_SAME_BUDGET_AS_BASE, INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE
Conversions
ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS sera renvoyé si vous téléchargez une ClickConversion avec des user_identifiers définis à l’aide de ConversionUploadService.UploadClickConversion, mais que vous n’avez pas accepté les conditions relatives aux données client
ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS sera renvoyé si vous essayez de télécharger la même combinaison de gbraid, conversion_action et conversion_date_time à des jours différents
ConversionUploadError.CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS sera renvoyé si vous n’avez pas suivi les instructions de configuration avant d’utiliser les conversions améliorées pour les prospects
Ajout de ConversionActionType.WEBPAGE_CODELESS pour représenter les conversions créées à partir d’événements de site Web
Critère
Ajout de CampaignCriterion.local_service_id et LocalServiceIdInfo pour permettre l’ajout et la suppression de services qu’un annonceur propose à une campagne de services locaux
CampaignCriterionError.AT_LEAST_ONE_LOCAL_SERVICE_ID_CRITERION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN sera renvoyé si vous tentez de supprimer le dernier critère de campagne contenant local_service_id d’une campagne Services de proximité
CampaignCriterionError.LOCAL_SERVICE_ID_NOT_FOUND_FOR_CATEGORY sera renvoyé si vous tentez d’ajouter un critère de campagne contenant local_service_id non valide pour la catégorie de votre campagne de service local. Vous pouvez obtenir des informations sur la catégorie en récupérant campaign.local_services_campaign_settings.category_bids
les erreurs
Depuis la v13, les codes d’erreur renvoyés pour certaines opérations non valides ont changé pour les champs suivants
Hôtel & Voyage
Ajout de la prise en charge de Performance Max pour les objectifs de voyage avec les nouveaux champs, ressources et énumérations suivants : Champs Campaign.hotel_property_asset_set, AssetSet.hotel_property_data et HotelPropertyData, Asset.hotel_property_asset et HotelPropertyAsset. Énumérations : HOTEL_PROPERTY ajouté à : AssetSetType, AssetType, AssetFieldType, AssetGroupAssetError.HOTEL_PROPERTY_ASSET_NOT_LINKED_TO_CAMPAIGN, CampaignError.ASSET_SET_NOT_A_HOTEL_PROPERTY_ASSET_SET, CampaignError.HOTEL_PROPERTY_ASSET_SET_ONLY_FOR_PERFORMANCE_MAX_FOR_TRAVEL_GOALS
Clients fermés sur liste d’autorisation uniquement : ajout de TravelAssetSuggestionService pour suggérer les images et les ressources textuelles requises (telles que les titres, les descriptions, les descriptions longues) à utiliser pour créer des groupes de ressources dans Performance Max pour les campagnes d’objectifs de voyage
Clients sur liste d’autorisation uniquement : prise en charge des campagnes d’annonces Things to do en ajoutant les nouveaux champs, ressources et énumérations suivants : Champs, Énumérations, Pour la création de campagnes, Pour la création de groupes d’annonces, Erreurs, Rapports, travel_performance_view, travel_activity_group_view
Recommandations
Les recommandations basées sur le flux suivantes sont remplacées par des recommandations basées sur les éléments : Recommendation.call_extension_recommendation remplacé par Recommendation.call_asset_recommendation Recommendation.callout_extension_recommendation remplacé par Recommendation.callout_asset_recommendation Recommendation.sitelink_extension_recommendation remplacé par Recommendation.sitelink_asset_recommendation
Ajout de Recommendation.campaigns pour afficher les campagnes ciblées par la recommandation. Suppression de ResponsiveSearchAdAssetRecommendation.current_ad
Achats
Suppression de ProductBiddingCategoryInfo.country_code
Ajout de la prise en charge de segments.product_feed_label dans shopping_performance_view
Vidéo
Suppression de PreferredContentInfo et de sa référence dans AdGroupBidModifier
Ajout de champs d’incitation à l’action pour les annonces bumper vidéo : VideoBumperInStreamAdInfo.action_button_label, VideoBumperInStreamAdInfo.action_headline
Ajout de TargetCpm.target_frequency_goal et TargetCpmTargetFrequencyGoal pour prendre en charge la fourniture de détails supplémentaires sur l’objectif de la stratégie d’enchères au CPM cible
Ajout de AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY
Type d’emplacement ajouté.GOOGLE_PRODUCTS
Forum de discussion sur Twitter.
FAQ
Qu'est-ce que la Google Ads API v13 ?
La Google Ads API v13 est la 13ème version de l’interface de programmation (API) développée par Google pour faciliter la gestion et l’optimisation des campagnes publicitaires sur son réseau Ads. Cette dernière version offre de nouvelles fonctionnalités telles que la possibilité de gérer les enchères, les audiences cibles ou encore les stratégies d’optimisation automatique en temps réel. Grâce à cette API, les annonceurs peuvent automatiser leurs campagnes et améliorer leur efficacité dans la gestion de leurs publicités sur Google.
Comment accéder à l'API client de Google Ads ?
Pour accéder à l’API client de Google Ads, vous devez tout d’abord créer un compte sur le site des développeurs de Google. Ensuite, vous devrez suivre les étapes pour obtenir une clé API et une authentification OAuth2. Une fois ces éléments en main, vous pourrez commencer à utiliser toutes les fonctionnalités offertes par l’API client de Google Ads pour gérer vos campagnes publicitaires en ligne.
Où trouver la documentation de l'API Google Ads ?
La documentation de l’API Google Ads peut être trouvée sur le site officiel Google Developers. Vous y trouverez toutes les informations nécessaires pour intégrer et utiliser l’API dans vos projets. De plus, des exemples de code et des tutoriels sont disponibles pour vous guider dans son utilisation. N’hésitez pas à consulter cette documentation complète pour optimiser votre expérience avec l’API Google Ads.
Quels services sont proposés par le centre d'API Google Ads ?
Le centre d’API Google Ads offre une variété de services pour aider les utilisateurs à gérer et optimiser leurs publicités en ligne. Ces services incluent la création et la gestion de campagnes publicitaires, l’analyse des performances des annonces, ainsi que la possibilité de personnaliser et automatiser les stratégies publicitaires. En outre, le centre permet également aux utilisateurs d’accéder à des données en temps réel sur leurs campagnes pour prendre des décisions éclairées quant à leur budget et leur ciblage.
Que peut-on trouver dans la documentation de l'API Google Ads ?
Dans la documentation de l’API Google Ads, on peut trouver toutes les informations nécessaires pour utiliser et intégrer l’API dans ses applications. On y retrouve notamment la liste des fonctionnalités disponibles, leur utilisation et les instructions pour configurer et gérer un compte publicitaire. De plus, la documentation fournit des exemples de code et des guides pratiques pour faciliter l’intégration avec d’autres plateformes et systèmes. Cette documentation est une ressource essentielle pour comprendre le fonctionnement de l’API Google Ads et profiter pleinement de ses possibilités.
