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 l'API Content 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 ressource aggregateProductStatuses.

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 sur la migration de accountstatuses vers les problèmes de compte.

Principales différences

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

• Ressources dédiées : la ressource accountstatuses de Content API for Shopping est désormais divisée. Dans Merchant API, 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 et des pays de reporting spécifiques.
• Suppression du champ "Chaîne" : le champ channel n'est plus utilisé. Ces informations font désormais partie intégrante du 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 demande

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 s'adapter à 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 segments de données spécifiques ont été sélectionnés à l'aide de paramètres de requête.	Le nom de 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é remplacée par une méthode list compatible avec le filtrage.

Méthode Content API for Shopping	Méthode de l'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 pour les statistiques et les 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 du reporting_context.
statistics	stats	L'objet statistics a été 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'énumération servability est remplacée par l'énumération severity pour décrire l'impact d'un problème.
itemLevelIssues.attributeName	item_level_issues.attribute	Le champ attributeName a été renommé attribute.
itemLevelIssues.documentation	item_level_issues.documentation_uri	Le champ documentation a été renommé documentation_uri.
itemLevelIssues.numItems	item_level_issues.product_count	Le champ numItems a été renommé product_count.