Migrer accountstatuses vers Aggregate Product Statuses

La façon dont vous récupérez les statistiques et les problèmes agrégés liés aux produits a changé. La fonctionnalité auparavant disponible dans la ressource accountstatuses de Content API for Shopping est désormais divisée en ressources dédiées dans l'API Merchant. Ce guide explique comment migrer votre intégration pour utiliser la nouvelle aggregateProductStatuses ressource.

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

Différences majeures

Voici les principales différences entre les fonctionnalités d'état des produits dans Content API for Shopping et l'API Merchant :

• Ressources dédiées : la ressource accountstatuses de Content API for Shopping est désormais divisée. Dans l'API Merchant, les problèmes au niveau du compte sont disponibles via la ressource accountissues, tandis que les statistiques agrégées sur les produits et les problèmes au niveau des articles sont disponibles via la nouvelle ressource aggregateProductStatuses.
• Nouvelle structure de ressource : AggregateProductStatus est une nouvelle ressource qui représente les statistiques et les problèmes pour une combinaison spécifique d'un contexte de rapport et d'un pays.
• Mécanisme de filtrage : au lieu d'utiliser des paramètres de requête tels que destinations pour sélectionner des données, l'API Merchant utilise une méthode list avec une chaîne filter pour interroger des contextes de rapport et des pays spécifiques.
• Suppression du champ "channel" : le champ channel n'est plus utilisé. Ces informations font désormais implicitement partie de reportingContext.

Requêtes

L'API Merchant utilise une requête GET avec un paramètre filter pour récupérer les états agrégés des produits.

GET https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses

Format de l'URL de la requête

Description de la requête	Content API for Shopping	API Merchant
Obtenir des statistiques et des problèmes liés aux produits	GET /content/v2.1/{merchantId}/accountstatuses/{accountId}	GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses

Identifiants

La façon dont les ressources sont identifiées a changé pour prendre en charge la nouvelle structure.

Format d'identifiant

Description de l'identifiant	Content API for Shopping	API Merchant
Identifiant de ressource	La ressource a été identifiée par accountId. Des tranches de données spécifiques ont été sélectionnées avec des paramètres de requête.	Le nom de la ressource identifie de manière unique les données pour un contexte de rapport et un pays spécifiques : accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.

Méthodes

La méthode de récupération des états des produits a été mise à jour vers une méthode list qui prend en charge le filtrage.

Méthode Content API for Shopping	Méthode API Merchant	Disponibilité et remarques
accountstatuses.get	aggregateProductStatuses.list	La méthode accountstatuses.get renvoyait une seule ressource contenant toutes les statistiques sur les produits. La nouvelle méthode aggregateProductStatuses.list renvoie une liste de ressources, une pour chaque combinaison de contexte de rapport et de pays. Utilisez le paramètre filter pour récupérer des données spécifiques. Pour les problèmes au niveau du compte, utilisez accountissues.list.

Modifications détaillées des champs

Les champs des statistiques et des problèmes liés aux produits ont été mis à jour et restructurés dans la nouvelle ressource AggregateProductStatus.

Content API for Shopping	API Merchant	Description
products	aggregate_product_statuses	Le tableau products est remplacé par le champ répété aggregate_product_statuses dans la réponse de la liste.
destination	reporting_context	Le champ destination est remplacé par reporting_context, qui spécifie le contexte du programme pour les statistiques.
channel	(aucun champ équivalent)	Le champ channel est supprimé. Ces informations font désormais partie de reporting_context.
statistics	stats	L'objet statistics est renommé stats. Les noms de champ sont convertis au format snake_case. Par exemple, activeCount devient active_count.
itemLevelIssues.servability	item_level_issues.severity	L'enum servability est remplacé par l'enum severity pour décrire l'impact d'un problème.
itemLevelIssues.attributeName	item_level_issues.attribute	Le champ attributeName est renommé attribute.
itemLevelIssues.documentation	item_level_issues.documentation_uri	Le champ documentation est renommé documentation_uri.
itemLevelIssues.numItems	item_level_issues.product_count	Le champ numItems est renommé product_count.