Migrer de accountstatuses vers Account Issues

La façon dont vous récupérez les problèmes au niveau du compte qui peuvent avoir un impact sur vos produits et sur l'état de votre compte a changé. Par rapport à la ressource accountstatuses dans Content API for Shopping, l'API Merchant 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 au compte.

Remarque : Dans l'API Merchant, 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 dans la ressource AccountIssue de l'API Merchant :

  • Ressource dédiée : les problèmes liés au compte sont désormais une ressource à part entière. Dans Content API for Shopping, les problèmes au niveau du compte étaient un champ imbriqué dans la ressource générale AccountStatus. Avec l'API Merchant, vous pouvez les lister directement à l'aide de la méthode accounts.issues.list.
  • Données d'impact structurées : la ressource AccountIssue fournit un champ impactedDestinations détaillé. Ce champ vous donne une répartition claire 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é en tant qu'énumération : le champ severity est désormais une énumération (avec des valeurs telles que CRITICAL, ERROR, SUGGESTION), ce qui facilite le traitement par programmation par rapport aux valeurs basées sur des chaînes dans Content API for Shopping.
  • Identifiants standardisés : chaque problème lié au 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 Content API for Shopping.
  • Comportement avancé du compte : lorsque vous appelez accounts.issues.list sur un compte avancé, seuls les problèmes qui s'appliquent directement à ce compte avancé sont renvoyés. Les problèmes liés à l'un de ses sous-comptes ne sont pas renvoyés. Dans Content API for Shopping, la méthode accountstatuses.list renvoyait 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 liés à 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. {ACCOUNT_ID} en tant que paramètre de chemin 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é regroupées et simplifiées dans l'API Merchant.

Comparaison des méthodes

Content API for Shopping API Merchant Disponibilité et remarques
accountstatuses.get accounts.issues.list Disponible. Pour obtenir les problèmes liés à un seul compte, utilisez accounts.issues.list et spécifiez l'ID du compte. L'API Merchant ne dispose 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 liés au compte spécifié, et non à 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 liés au compte n'est pas pris en charge dans l'API Merchant. Vous devez effectuer des appels list individuels pour chaque compte.

Modifications détaillées des champs

Les champs de la ressource de problème lié au compte ont été mis à jour pour offrir 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 dédiée de premier niveau, et non un champ imbriqué.
id (chaîne) name (chaîne) L'identifiant du problème est désormais un nom complet de ressource, 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 champ a été renommé 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é dans une 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 requête) De nouveaux paramètres dans la requête list permettent la localisation des champs lisibles par l'humain tels que title et detail.
Précédent
Overview
Suivant
Migrate accountstatuses to Aggregate Product Statuses