Notes de version de l'API Merchant Accounts

Semaine du 28 septembre 2026

Lancement de la version alpha du service LoyaltyPrograms, que vous pouvez utiliser pour gérer les programmes de fidélité. Cette fonctionnalité n'est disponible que pour certains marchands. Pour en savoir plus, consultez la présentation des programmes de fidélité.

Semaine du 3 août 2026

  • Ajout de "ucp_checkout_management" en tant que type de service à la ressource de service de compte. Remarque : Le paiement UCP est une fonctionnalité à accès limité.
  • Ajout de la compatibilité avec le programme "ucp-integration" (accès limité).
  • Ajout de la compatibilité avec le type de conditions d'utilisation "ucp_integration".

Semaine du 29 juin 2026

Semaine du 20 avril 2026

  • Ajout de youtube-affiliate à la liste des noms de programme disponibles dans la description de la ressource accounts.programs.
  • Activez l'API du programme pour l'affiliation YouTube Shopping. Disponible pour les testeurs de confiance.

Semaine du 6 avril 2026

  • Ajout de l'état WAITING à l'état d'approbation. Pour les services de comparateur de prix (CSS), WAITING est un état transitoire entre PENDING et ESTABLISHED. Utilisé lorsque le CSS d'origine a besoin de temps pour effectuer le nettoyage nécessaire avant que le compte ne soit entièrement transféré vers le nouveau CSS.

Semaine du 16 mars 2026

  • Lancement de la méthode CreateTestAccount dans l'API Accounts. Cela permet aux développeurs de créer par programmation des comptes de test dédiés qui fonctionnent dans un environnement isolé de type bac à sable, ce qui leur offre un espace sécurisé pour développer et tester les intégrations.

Semaine du 17 novembre 2025

  • CreateAndConfigureAccountRequest propose désormais de nouveaux services qui peuvent être configurés lors de la configuration du compte. Vous devez spécifier exactement l'un des éléments suivants : AccountAggregation, AccountManagement et ComparisonShopping. De plus, il est possible de spécifier un nombre arbitraire de services ProductsManagement et CampaignsManagement. Toutefois, deux services ne doivent pas avoir le même fournisseur ni les mêmes ID de compte externe.

  • La méthode AccountsService.CreateAndConfigure fournit désormais un paramètre permettant de contrôler si un e-mail de validation doit être envoyé.

  • CreateAndConfigureAccountRequest.AddAccountService comporte désormais un champ external_account_id (ce champ existe déjà sur la ressource AccountService). Il peut être spécifié avec les services CampaignsManagement et ProductsManagement.

  • Ajout d'un service ComparisonShopping à la ressource AccountService. Pour en savoir plus, consultez https://support.google.com/merchants/answer/12653197.

  • Il est désormais possible de définir un alias pour une relation lors de la création d'un compte à l'aide du champ setAlias dans CreateAndConfigureAccountRequest.

  • Ajout d'une méthode VerifySelf à UserService qui permet de mettre à jour l'état de PENDING à VERIFIED pour la ressource User représentant l'utilisateur qui effectue l'appel.

  • Lancement du nouveau champ radius_area dans la charge utile Region de l'API Regions, qui permettra aux marchands de créer des régions à l'aide d'une zone de rayon.

Semaine du 10 novembre 2025

  • Publiez la version v1alpha de l'API Services.
  • Lancement du nouveau champ product_filters dans la charge utile CampaignManagement de l'API Services, qui permettra aux marchands de ne partager qu'un sous-ensemble de leur flux avec les comptes Google Ads, en fonction d'un filtrage conditionnel sur les attributs des produits du marchand. Cette fonctionnalité est uniquement accessible aux marchands figurant sur la liste d'autorisation.

Semaine du 25 août 2025

  • De nouvelles méthodes par lot ont été ajoutées à l'API Regions :
    • BatchCreateRegions : permet de créer plusieurs régions dans une même requête.
    • BatchUpdateRegions : permet de mettre à jour plusieurs régions dans une même requête.
    • BatchDeleteRegions : permet de supprimer plusieurs régions par nom dans une seule requête.

Semaine du 1er juillet 2025

  • Lancement de la ressource CheckoutSettings qui permet aux utilisateurs de l'API de créer, de mettre à jour, de supprimer et d'obtenir des checkoutSettings.

Semaine du 26 mai 2025

  • Il est désormais possible de filtrer les comptes par capabilities. Pour le moment, la seule valeur possible est CAN_UPLOAD_PRODUCTS. Ce filtre vous permet de récupérer les comptes pouvant importer des produits. Cela signifie que les clauses suivantes peuvent désormais être utilisées au niveau du compte :

    • capabilities:CAN_UPLOAD_PRODUCTS
    • -capabilities:CAN_UPLOAD_PRODUCTS
    • NOT capabilities:CAN_UPLOAD_PRODUCTS Pour en savoir plus, consultez le guide de filtrage.

  • Lancement du droit d'accès en lecture seule. Les utilisateurs disposant du droit d'accès en lecture seule peuvent consulter les données du marchand, mais pas les modifier.

Semaine du 19 mai 2025

  • Mise à jour de la documentation de l'API Program pour supprimer l'instruction incorrecte selon laquelle les méthodes Enable/Disable sont réservées aux administrateurs.

Semaine du 12 mai 2025

  • Lancement de la ressource "Conditions de retour en ligne", qui permet aux utilisateurs de l'API de créer, de modifier et de supprimer des conditions de retour.
  • Lancement de OmnichannelSettingsService et de la ressource OmnichannelSetting, qui permettent aux utilisateurs de l'API de gérer leur expérience omnicanale.
  • Lancement de LfpProvidersService et de la ressource LfpProvider qui permet aux utilisateurs de l'API de gérer leur relation avec le programme Local Feeds Partnership.
  • Lancement de GbpAccountsService et de la ressource GbpAccount, qui permettent aux utilisateurs de l'API de gérer leur fiche d'établissement Google.
  • Lancez le type de service LocalListingManagement dans AccountService, qui associe le groupe d'établissements utilisé pour les annonces produits en magasin ou les fiches locales gratuites.

Semaine du 28 avril 2025

  • Lancement des ressources AccountService et AccountRelationship qui permettent aux utilisateurs de l'API de gérer les relations et d'établir des services avec les fournisseurs de services.

Semaine du 14 avril 2025

  • TermsOfServiceService.AcceptTermsOfService renvoie désormais le TermsOfServiceAgremeentState qui a été accepté, enveloppé dans un type de réponse.

  • Le verbe de l'action TermsOfServiceService.AcceptTermsOfService est désormais POST (au lieu de GET).

  • Clarification indiquant que AccountsService.ListSubAccounts doit être appelé au format accounts/... (plutôt que providers/...). Cela permet d'éviter que cette méthode ne sorte du champ d'application de accounts (c'est-à-dire GET accounts/123:listSubAccounts plutôt que GET providers/123:listSubAccounts).

Semaine du 31 mars 2025

  • Pour filtrer les comptes, le filtre externalAccountId a été annoncé comme obsolète la semaine du 2 décembre 2024 et n'est plus disponible. Cela signifie que le filtrage par externalAccountId n'est désormais possible qu'au niveau service. Un filtre tel que relationship(externalAccountId = "foo") ne fonctionnera plus et devra être exprimé sous la forme relationship(service(externalAccountId = "foo")).

  • Clarification dans la documentation AccountsService indiquant qu'il est impossible de créer des comptes autonomes.

Semaine du 3 mars 2025

- accounts.onlineReturnPolicies#SeasonalOverride a été refactorisé pour améliorer la clarté et la cohérence. Voici quelques exemples de mises à jour :

  • Renommage des champs :
    • begin est désormais start_date.
    • end est désormais end_date.
  • Suppression de champs :
    • Le champ obsolète policy a été supprimé.

- Les développeurs doivent mettre à jour leur code pour refléter ces modifications.

Lancement du service AutomaticImprovements que vous pouvez utiliser pour gérer les éléments suivants :

Pour en savoir plus, consultez Activer les améliorations automatiques.

Semaine du 17 février 2025

Suppression du prédicat callerHasAccessToProviderFilter() du filtre de compte.

Semaine du 10 février 2025

  • Amélioration de la documentation pour la méthode AccountsService.List. Elle renvoie tous les comptes auxquels l'utilisateur a accès, et pas seulement les comptes individuels.

  • Ajout d'un délai par défaut de 10 minutes pour toutes les méthodes RPC.

  • Ajout de la liste des noms de programmes disponibles à la description de la ressource accounts.programs.

  • User.accessRights est désormais REQUIRED, ce qui affecte les méthodes UserService.Create et AccountsService.CreateAndConfigure.

Semaine du 27 janvier 2025

AccountsService.ListAccounts (et transitivement AccountsService.ListSubAccounts) renvoient désormais les comptes de manière cohérente à terme plutôt que de manière fortement cohérente.

Semaine du 20 janvier 2025

Le champ users de CreateAndConfigureAccountRequest est obsolète au profit d'un nouveau user. Le CreateUserRequest référencé contient le champ parent, qui n'est pas obligatoire dans le contexte de CreateAndConfigureAccountRequest.

Semaine du 6 janvier 2025

Le champ user du message CreateUserRequest est désormais correctement marqué comme OPTIONAL.

Le champ domain des erreurs renvoyées est désormais renseigné avec merchantapi.googleapis.com au lieu de global.

Semaine du 2 décembre 2024

Pour filtrer les comptes, le prédicat externalAccountId est déplacé du niveau relationship vers le niveau service. Ainsi, un filtre relationship(externalAccountId = "foo") devra désormais être écrit relationship(service(externalAccountId = "foo")). L'ancien format est toujours accepté pour assurer la rétrocompatibilité, mais il est obsolète et générera une erreur dans un avenir proche. Toute la documentation ne mentionnera que le nouveau format.

Semaine du 18 novembre 2024

Le fournisseur dans le champ CreateAndConfigureAccountRequest.service.provider peut désormais être providers/GOOGLE_ADS ou providers/GOOGLE_BUSINESS_PROFILE. Les autres comptes doivent être désignés par providers/123 (et non accounts/123). Cela signifie que le champ n'est plus annoté comme référence de compte. Toutefois, il est toujours possible d'utiliser des noms de compte tels que accounts/123 pour assurer la rétrocompatibilité.

Le fournisseur dans ListSubAccountsRequest doit désormais être de la forme providers/123, mais pour assurer la rétrocompatibilité, il sera toujours possible d'utiliser accounts/123.

Semaine du 4 novembre 2024

Marquez promotions_consent REQUIRED (à partir de OPTIONAL) dans la ressource BusinessIdentity. Cela n'affecte que la méthode de mise à jour. Cela permet de préciser qu'il n'est pas possible de mettre à jour promotions_consent vers UNSPECIFIED. Cette opération n'était déjà pas possible, mais l'erreur est désormais plus descriptive et le champ est correctement annoté.

Semaine du 28 octobre 2024

Amélioration de la documentation de diverses ressources de la sous-API Accounts, telles que User, Homepage, BusinessInfo, etc.

Semaine du 21 octobre 2024

Amélioration de la documentation des champs update_mask dans les requêtes de mise à jour pour indiquer précisément les champs pouvant être mis à jour.

Ajout du lien vers le centre d'aide Google Business pour les opérateurs compatibles au document externe de la ressource ShippingSettings

Semaine du 14 octobre 2024

Marquez provider comme REQUIRED dans AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Rendez update_mask facultatif dans toute la sous-API Accounts (par exemple, identité de l'entreprise, informations sur l'établissement, page d'accueil, etc.) et de manière rétroactive pour la ressource ConversionSources.

Ajout du paramètre overwrite à ClaimHomepageRequest.

Semaine du 30 septembre 2024

Lancement du paramètre "force" pour la méthode "Accounts.delete".

Semaine du 23 septembre 2024

Marquez region_code et kind comme REQUIRED dans RetrieveLatestTermsOfServiceRequest.

Semaine du 16 septembre 2024

Modification du type de paramètre time_zone en chaîne dans ListAccountIssuesRequest

Semaine du 12 août 2024

Ajout du champ korean_business_registration_number à la ressource BusinessInfo.

Semaine du 27 mai 2024

Lancement de la sous-API Accounts en version bêta