Mercredi 5 juin 2024
Nous annonçons aujourd'hui la sortie de la version 17 de l'API Google Ads. Pour utiliser certaines fonctionnalités de la v17, vous devrez mettre à niveau vos bibliothèques clientes et votre code client. Les bibliothèques clientes et les exemples de code mis à jour seront publiés la semaine prochaine.Voici les principaux avantages :
- Pour préparer le changement de règle d'utilisation des ressources qui aura lieu le 17 juin 2024, nous avons ajouté deux nouvelles valeurs à
QuotaError, générées en cas de consommation excessive de ressources sur une période donnée par un schéma de requête pour les requêtesGoogleAdsService.Search()etGoogleAdsService.SearchStream(). - Le champ
page_sizeest toujours défini sur 10 000, et vous ne pouvez plus transmettre depage_sizeàGoogleAdsService.Search. Cela entraînera une erreurRequestError.PAGE_SIZE_NOT_SUPPORTED. - Ajout de
campaign_aggregate_asset_viewetchannel_aggregate_asset_viewpour générer des rapports sur davantage de métriques des campagnes Performance Max et sur le Réseau de Recherche. - Modifications apportées au traitement par lot :
- Ajout de la prise en charge de la définition de
MutateOperation.asset_group_operationlors de l'utilisation deBatchJobService. Vous pouvez ainsi utiliser le traitement par lot pour créer et gérer des campagnes Performance Max entières. - Ajout de l'erreur
BatchJobError.REQUEST_TOO_LARGEpour l'envoi d'unAddBatchJobOperationsRequestde plus de 10 484 504 octets. Vous devez diviser les opérations en groupes plus petits et les envoyer sous forme de requête distincte.
- Ajout de la prise en charge de la définition de
- Ajout de
Campaign.keyword_match_typepour permettre de définir un type de correspondance des mots clés pour tous les mots clés d'une campagne. - Suppression de
AdService.getAdpour aligner le service sur les autres de l'API Google Ads. Pour obtenir des recommandations sur la récupération des ressources, consultez Récupérer des objets. - Ajout de
primary_statusetprimary_status_reasonsàAdGroupCriterionpour indiquer si le critère du groupe d'annonces est diffusé ou les raisons pour lesquelles il ne l'est pas. - Ajout d'un nouveau rapport
shopping_product, qui correspond à la page Produits de l'UI Google Ads. - Ajout de validations pour
ImageAdInfo.image_assetconcernant les dimensions et le format, ce qui le rend plus cohérent avec les autres validations d'images dans l'API Google Ads. - Ajout de
segments.sk_ad_network_redistributed_fine_conversion_value, qui redistribue les valeursNULLvers d'autres valeurs en fonction d'un modèle de machine learning sur les données de postback SkAdNetwork récentes. - Discovery a été renommé Demand Gen dans tous les champs, énumérations et erreurs de toutes les ressources de l'API Google Ads.
- Vous ne pouvez désormais sélectionner que les champs liés à un produit associé lorsque vous interrogez
product_link. Sinon, une erreurQueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSEsera générée. - Ajout de
UserListCustomerTypeService.MutateUserListCustomerTypes()pour configurer les types de clients d'audience. Cette méthode remplace l'utilisation deCustomerLifecycleGoal.lifecycle_goal_customer_definition_settings. - Ajout de deux champs expiration_date_time
local_services_verification_artifactpour permettre aux annonceurs de mieux surveiller l'expiration de leurs artefacts.
Où puis-je trouver de plus amples informations ?
Les ressources suivantes peuvent vous aider à démarrer :
Si vous avez des questions ou si vous avez besoin d'aide, contactez-nous via le forum.
Libellés : google-ads-api, release