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 de 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.

Principales différences

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

• 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 l'API Merchant, 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 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 l'API Content for Shopping.
• Identifiants standardisés : chaque problème de compte possède un name unique et complet 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é, seuls les problèmes qui s'appliquent directement à ce compte avancé sont renvoyés. Elle ne renvoie aucun problème pour ses sous-comptes. Dans Content API for Shopping, la méthode accountstatuses.list renverrait 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.

Demandes

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/v1beta/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/v1beta/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 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 permettant de récupérer les problèmes de 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 d'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. Dans l'API Merchant, la méthode accounts.issues.list 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 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.