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, 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 la nouvelle fonctionnalité, consultez le guide Afficher les problèmes liés au 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 de produits agrégés.

Différences majeures

Voici les principales améliorations et différences de la ressource AccountIssue de l'API Merchant :

  • Ressource dédiée : les problèmes liés au compte constituent 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 Merchant API, 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é sous forme d'é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 une ressource complète unique name au format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Cette approche standardisée remplace la chaîne id de Content API for Shopping.
  • Compatibilité avec 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 des comptes avancés : lorsque vous appelez accounts.issues.list sur un compte avancé, seuls les problèmes qui s'appliquent directement à ce compte avancé sont renvoyés. Elle ne renvoie pas les problèmes liés à ses sous-comptes. Dans Content API for Shopping, la méthode accountstatuses.list renvoie l'état 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
Répertorier 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 effectuer une itération sur 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 id dans le corps de la réponse (par exemple, "products-that-enable-dishonest-behavior-hacking-policy"). Le 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 de compte ont été consolidé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 d'un seul compte, utilisez accounts.issues.list et spécifiez l'ID de compte. La Merchant API 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 de compte n'est pas disponible dans Merchant API. Vous devez effectuer des appels list individuels pour chaque compte.

Modifications détaillées des champs

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

Comparaison de 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 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 champ a été renommé pour plus de clarté afin d'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 requête) De nouveaux paramètres dans la requête list permettent de localiser les champs lisibles par l'humain, tels que title et detail.
Précédent
Migrate account management
Suivant
Migrate accountstatuses to Aggregate Product Statuses