Notes de version de l'API Merchant Accounts

Semaine du 26 octobre 2026

  • Clarification de la documentation pour la méthode accounts.homepage.unclaim et le champ claimed de la ressource Homepage. Si un compte hérite de la revendication de page d'accueil de son compte avancé, unclaim renvoie une réponse positive, mais la page d'accueil reste revendiquée. Si le compte lui-même est exempté de revendication, unclaim renvoie une erreur FAILED_PRECONDITION.

Semaine du 28 septembre 2026

  • Ajout de youtube_affiliate_management en tant que type de service à la ressource AccountService dans v1alpha. Remarque : La gestion des affiliés YouTube est une fonctionnalité en accès limité.

  • 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é.

  • Ajout du champ en lecture seule home_page_uri à la ressource accounts pour renvoyer l'URI de la page d'accueil du magasin.

Semaine du 3 août 2026

  • Ajout de "ucp_checkout_management" en tant que type de service à la ressource de service du compte. Remarque : Le paiement UCP est une fonctionnalité en 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 programmes 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 de transition entre PENDING et ESTABLISHED. Utilisé lorsque le CSS d'origine a besoin de temps pour effectuer les nettoyages nécessaires 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 de manière programmatique des comptes de test dédiés qui fonctionnent dans un environnement isolé de type bac à sable, offrant ainsi un espace sécurisé pour développer et tester des intégrations.

Semaine du 17 nov. 2025

  • CreateAndConfigureAccountRequest propose désormais de nouveaux services qui peuvent être configurés lors de la configuration du compte. Vous devez spécifier un seul des éléments suivants : AccountAggregation, AccountManagement ou ComparisonShopping. Il est également possible de 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à 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.

  • Vous pouvez désormais 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 une région à l'aide d'une zone de rayon.

Semaine du 10 nov. 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 réservée aux marchands figurant sur la liste d'autorisation.

Semaine du 25 août 2025

  • Nouvelles méthodes par lot ajoutées à 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 juil. 2025

  • Lancement de la ressource CheckoutSettings, qui permet aux utilisateurs de l'API de créer, modifier, supprimer et obtenir des paramètres de paiement.

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 capables d'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 sur le filtrage.

  • Lancement du droit d'accès en lecture seule. Les utilisateurs disposant d'un 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, suppression de l'instruction incorrecte indiquant que les méthodes Enable/Disable sont réservées aux administrateurs.

Semaine du 12 mai 2025

  • Lancement de la ressource OnlineReturnPolicy, qui permet aux utilisateurs de l'API de créer, de modifier et de supprimer des conditions de retour.
  • Lancement d'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 permettent aux utilisateurs de l'API de gérer leur relation de partenariat pour les flux locaux.
  • 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 la TermsOfServiceAgremeentState qui a été acceptée, encapsulée dans un type de réponse.

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

  • Clarification : 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 sur le fait qu'il n'est pas possible de créer des comptes autonomes.

Semaine du 3 mars 2025

- La accounts.onlineReturnPolicies#SeasonalOverride a été refactorisée pour améliorer la clarté et la cohérence. Ces mises à jour incluent :

  • Renommer 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 sur 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 de manière transitive AccountsService.ListSubAccounts) renvoie désormais les comptes de manière cohérente à terme plutôt que d'effectuer une lecture forte.

Semaine du 20 janvier 2025

Le champ users de CreateAndConfigureAccountRequest est obsolète et a été remplacé par un nouveau champ user. Le CreateUserRequest référencé contient le champ parent, qui n'est pas requis 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 au niveau service. Ainsi, un filtre relationship(externalAccountId = "foo") doit désormais être écrit sous la forme relationship(service(externalAccountId = "foo")). L'ancien format est toujours accepté pour des raisons de 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 nov. 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 désignés par providers/123 (plutôt que par accounts/123). Cela signifie que le champ n'est plus annoté en tant que 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 au format providers/123, mais pour des raisons de rétrocompatibilité, il sera toujours possible d'utiliser accounts/123.

Semaine du 4 nov. 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 clarifier qu'il n'est pas possible de passer de promotions_consent à UNSPECIFIED. Cela 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 afin d'indiquer spécifiquement les champs compatibles avec la mise à jour.

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

Semaine du 14 octobre 2024

Marquer provider comme REQUIRED dans AccountsService.CreateAndConfigureAccountRequest.AddAccountService.

Rendre update_mask facultatif dans la sous-API Accounts (par exemple, identité de l'entreprise, informations sur l'entreprise, 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

Marquez region_code et kind comme REQUIRED dans RetrieveLatestTermsOfServiceRequest.

Semaine du 16 septembre 2024

Le type du paramètre time_zone a été remplacé par "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 bêta de la sous-API Accounts