Migrer de accountstatuses vers Account Issues

La façon dont vous récupérez les problèmes au niveau du compte pouvant avoir un impact sur vos produits et sur l'état de votre compte a changé. Par rapport à la ressource accountstatuses de Content API for Shopping, Merchant API introduit une ressource AccountIssue dédiée qui fournit des informations plus structurées et détaillées.

Pour en savoir plus sur l'utilisation de cette nouvelle fonctionnalité, consultez le guide Afficher les problèmes liés à votre compte.

Remarque : Dans Merchant API, les problèmes au niveau du compte et les états agrégés des produits sont séparés. Consultez également notre guide pour migrer de accountstatuses vers les états agrégés des produits.

Différences majeures

Voici les principales améliorations et différences apportées à la ressource Merchant API AccountIssue :

  • Ressource dédiée : les problèmes de compte disposent de leur propre ressource. Dans l'API Content for Shopping, les problèmes au niveau du compte étaient un champ imbriqué dans la ressource générale AccountStatus. Avec Merchant API, vous pouvez les lister directement à l'aide de la méthode accounts.issues.list.
  • Données structurées sur l'impact : la ressource AccountIssue fournit un champ impactedDestinations détaillé. Ce champ vous permet de comprendre clairement la répartition de l'impact d'un problème, y compris la destination (par exemple, les annonces Shopping), la région spécifique et la gravité du problème dans cette région.
  • Gravité sous forme d'énumération : le champ severity est désormais une énumération (avec des valeurs telles que CRITICAL, ERROR, SUGGESTION), ce qui le rend plus facile à traiter par programmation que les valeurs basées sur des chaînes dans l'API Content for Shopping.
  • Identifiants standardisés : chaque problème de compte possède un name de ressource complet unique au format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Cette approche standardisée remplace la chaîne id de Content API for Shopping.
  • Prise en charge de la localisation : la méthode accounts.issues.list vous permet de spécifier un language_code pour recevoir les détails du problème, tels que le titre et la description, dans la langue de votre choix. Cela n'était pas possible dans l'API Content for Shopping.
  • Comportement avancé du compte : lorsque vous appelez accounts.issues.list sur un compte avancé, il ne renvoie que les problèmes qui s'appliquent directement à ce compte. Elle ne renvoie pas les problèmes pour l'un de ses sous-comptes. Dans Content API for Shopping, la méthode accountstatuses.list renvoie les états de tous les sous-comptes. Pour obtenir les problèmes de tous les sous-comptes dans l'API Merchant, vous devez appeler accounts.listSubaccounts, puis accounts.issues.list pour chaque sous-compte individuellement.

Requêtes

Dans l'API Merchant, vous pouvez lister les problèmes de compte pour un compte Merchant Center spécifique.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

Comparaison des URL de requête

Description de la requête Content API for Shopping API Merchant
Lister les problèmes au niveau du compte pour un seul compte GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Lister les problèmes au niveau du compte pour tous les sous-comptes d'un compte avancé GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses Non disponible. Vous devez parcourir les sous-comptes.

Identifiants

Les identifiants des comptes et des problèmes ont changé dans l'API Merchant.

Comparaison des identifiants

Description de l'identifiant Content API for Shopping API Merchant
Identifiant de compte {MERCHANT_ID} et {ACCOUNT_ID} en tant que paramètres de chemin d'accès. {ACCOUNT_ID} en tant que paramètre de chemin d'accès au format accounts/{ACCOUNT_ID}.
Identifiant du problème Champ id dans le corps de la réponse (par exemple, "products-that-enable-dishonest-behavior-hacking-policy"). Champ name dans le corps de la réponse, qui correspond au nom complet de la ressource (par exemple, accounts/12345/issues/example-issue-id).

Méthodes

Les méthodes de récupération des problèmes liés au compte ont été consolidées et simplifiées dans l'API Merchant.

Comparaison des méthodes

Content API for Shopping API Merchant Disponibilité et notes
accountstatuses.get accounts.issues.list Disponible : Pour obtenir les problèmes d'un seul compte, utilisez accounts.issues.list et spécifiez l'ID du compte. L'API Merchant ne comporte pas de méthode get pour un seul problème.
accountstatuses.list Aucun équivalent direct. Non disponible. La méthode accounts.issues.list de l'API Merchant ne renvoie que les problèmes du compte spécifié, et non ceux de ses sous-comptes. Pour obtenir les problèmes de tous les sous-comptes, vous devez d'abord appeler accounts.listSubaccounts, puis accounts.issues.list pour chaque sous-compte.
accountstatuses.custombatch Aucun équivalent direct. Non disponible. Le traitement par lot des problèmes de compte n'est pas compatible avec l'API Merchant. Vous devez effectuer des appels list individuels pour chaque compte.

Modifications détaillées des champs

Les champs de la ressource "Problème de compte" ont été mis à jour pour plus de structure et de clarté.

Comparaison des champs

Content API for Shopping API Merchant Description
accountLevelIssues (tableau dans AccountStatus) accountIssues (tableau dans ListAccountIssuesResponse) Les problèmes sont désormais une ressource de premier niveau dédiée, et non un champ imbriqué.
id (chaîne) name (chaîne) L'identifiant du problème est désormais un nom de ressource complet, par exemple accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (chaîne) title (chaîne) Aucun changement.
detail (chaîne) detail (chaîne) Aucun changement.
documentation (chaîne) documentationUri (chaîne) Le nom du champ a été modifié pour plus de clarté et pour indiquer qu'il s'agit d'une URL.
severity (chaîne) severity (enum) La gravité est désormais une énumération structurée (CRITICAL, ERROR, SUGGESTION) au lieu d'une chaîne.
country (chaîne), destination (chaîne) impactedDestinations (message répété) L'impact est désormais structuré sous forme de liste, regroupant la destination, la région et la gravité pour chaque zone concernée. Le champ country est remplacé par regionCode dans le message Impact.
(Non disponible) language_code, time_zone (paramètres de la requête) De nouveaux paramètres dans la requête list permettent de localiser les champs lisibles par l'utilisateur, tels que title et detail.
Précédent
Migrate account management
Suivant
Migrate accountstatuses to Aggregate Product Statuses