Notes de version de l'API Merchant Accounts

Semaine du 20 avril 2026

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 de transition entre PENDING et ESTABLISHED. Il est 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. Elle permet aux développeurs de créer par programmation des comptes de test dédiés qui fonctionnent dans un environnement de type bac à sable isolé, offrant ainsi 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, vous pouvez spécifier un nombre arbitraire de services ProductsManagement et CampaignsManagement. Toutefois, il ne doit pas y avoir deux services de ce type ayant le même fournisseur et 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à dans 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 passer de l'état 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 une région à l'aide d'une zone de rayon.

Semaine du 10 novembre 2025

  • Publication de 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. Il s'agit d'une fonctionnalité sur liste d'autorisation accessible uniquement à un nombre limité de marchands.

Semaine du 25 août 2025

  • Ajout de nouvelles méthodes par lot à l'API Regions :
    • BatchCreateRegions: permet de créer plusieurs régions dans une seule requête.
    • BatchUpdateRegions: permet de mettre à jour plusieurs régions dans une seule 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, mettre à jour, supprimer et 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 qui peuvent 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 afficher les données du marchand, mais pas les modifier.

Semaine du 19 mai 2025

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

Semaine du 12 mai 2025

  • Lancement de la ressource Online Return Policy, qui permet aux utilisateurs de l'API de créer, mettre à jour et supprimer des règles de retour.
  • Lancement des ressources OmnichannelSettingsService et OmnichannelSetting, qui permettent aux utilisateurs de l'API de gérer leur expérience omnicanale.
  • Lancement des ressources LfpProvidersService et LfpProvider, qui permettent aux utilisateurs de l'API de gérer leur relation de partenariat avec les flux locaux.
  • Lancement des ressources GbpAccountsService et GbpAccount, qui permettent aux utilisateurs de l'API de gérer leur fiche d'établissement Google.
  • Lancement du 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 accepté, encapsulé dans un type de réponse.

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

  • Clarification selon laquelle 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 accounts (c'est-à-dire GET accounts/123:listSubAccounts plutôt que GET providers/123:listSubAccounts).

Semaine du 31 mars 2025

  • Pour le filtrage des 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 du service. Un filtre tel que relationship(externalAccountId = "foo") ne fonctionnera plus et devra être exprimé comme relationship(service(externalAccountId = "foo")).

  • Clarification dans la documentation AccountsService selon laquelle il est impossible de créer des comptes autonomes.

Semaine du 3 mars 2025

-The accounts.onlineReturnPolicies#SeasonalOverride a été refactorisé pour améliorer la clarté et la cohérence. Ces modifications incluent les éléments suivants :

  • Changement de nom de champ
    • begin est désormais start_date.
    • end est désormais end_date.
  • Suppression de champ
    • Le champ policy obsolète 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 de la méthode AccountsService.List. Elle renvoie tous les comptes auxquels l'utilisateur a accès, et pas seulement les comptes autonomes.

  • 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 dans 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 le filtrage des comptes, le externalAccountId prédicat est déplacé du relationship niveau vers le service niveau. Ainsi, un filtre relationship(externalAccountId = "foo") doit désormais être écrit comme 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 du champ CreateAndConfigureAccountRequest.service.provider peut désormais être providers/GOOGLE_ADS ou providers/GOOGLE_BUSINESS_PROFILE. Les autres comptes doivent être appelés providers/123 (plutôt que 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 de ListSubAccountsRequest doit désormais être au format providers/123, mais pour assurer la rétrocompatibilité, il sera toujours possible d'utiliser accounts/123.

Semaine du 4 novembre 2024

Marquage de promotions_consent comme REQUIRED (au lieu de OPTIONAL) dans la ressource BusinessIdentity. Cela n'affecte que la méthode de mise à jour. Cela permet de clarifier qu'il n'est pas possible de définir promotions_consent sur UNSPECIFIED. Ce 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 spécifiquement les champs compatibles avec la mise à jour.

Ajout d'un lien vers le centre d'aide Google pour les opérateurs compatibles dans le document externe de la ressource ShippingSettings.

Semaine du 14 octobre 2024

Marquage de provider comme REQUIRED dans AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Définition de update_mask comme facultatif dans la sous-API Accounts (par exemple, identité de l'entreprise, informations sur l'établissement, page d'accueil, etc.) et rétroactivement 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

Marquage de 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 version bêta de la sous-API Accounts.