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 chargeActifs
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_timeAjout des champs suivants à CustomerAsset, CampaignAsset, AdGroupAsset : primary_status, primary_status_details, primary_status_reasonsAjout de Asset.field_type_policy_summaries pour renvoyer des informations sur les résumés de stratégie pour chaque type de champTypes 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_LOGOINVALID_EXCLUDED_PARENT_ASSET_SET_TYPE ajouté à, AdGroupError, CampaignErrorAjout des champs suivants à AssetSetError : OAUTH_INFO_INVALID, OAUTH_INFO_MISSING, CANNOT_DELETE_AS_ENABLED_LINKAGES_EXISTPublics
Suppression de CombinedRuleUserListInfo et ExpressionRuleUserListInfo et leurs références de RuleBasedUserListInfo. Utilisez plutôt FlexibleUserListInfoAjout 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 prospectsTâ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 champFacturation
InvalidActivitySummary a été ajouté pour permettre de renvoyer plus de détails sur l’activité invalide pour la factureAjout de AccountBudgetProposalError.CANCELED_BILLING_SETUPCampagnes
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 intelligentesRemplacé 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ésAdded 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_TYPEConversions
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 clientConversionUploadError.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érentsConversionUploadError.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 prospectsAjout de ConversionActionType.WEBPAGE_CODELESS pour représenter les conversions créées à partir d’événements de site WebCritè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 locauxCampaignCriterionError.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_bidsles erreurs
Depuis la v13, les codes d’erreur renvoyés pour certaines opérations non valides ont changé pour les champs suivantsHô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_GOALSClients 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 voyageClients 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_viewRecommandations
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_recommendationAjout de Recommendation.campaigns pour afficher les campagnes ciblées par la recommandation. Suppression de ResponsiveSearchAdAssetRecommendation.current_adAchats
Suppression de ProductBiddingCategoryInfo.country_codeAjout de la prise en charge de segments.product_feed_label dans shopping_performance_viewVidéo
Suppression de PreferredContentInfo et de sa référence dans AdGroupBidModifierAjout de champs d’incitation à l’action pour les annonces bumper vidéo : VideoBumperInStreamAdInfo.action_button_label, VideoBumperInStreamAdInfo.action_headlineAjout 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 cibleAjout de AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCYType d’emplacement ajouté.GOOGLE_PRODUCTSForum de discussion sur Twitter.