Notes de version de l'API Merchant Accounts

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. Il s'agit d'une fonctionnalité autorisée qui n'est accessible qu'à un nombre limité de marchands.

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 même 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 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 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'affirmation 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 permettent 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 permet 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 accepté, encapsulé dans un type de réponse.

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

  • Nous avons précisé 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 ces 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 sur la méthode AccountsService.List. Il 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 par lecture forte.

Semaine du 20 janvier 2025

Le champ users de CreateAndConfigureAccountRequest est obsolète et a été remplacé par 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 au format 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. 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éliorer 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 pouvant être mis à jour.

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

Semaine du 14 octobre 2024

Marquer 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'entreprise, 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 version bêta de la sous-API Accounts