Migrer accountstatuses vers Aggregate Product Statuses
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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
| 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.
| 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. |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/08 (UTC).
[null,null,["Dernière mise à jour le 2025/08/08 (UTC)."],[],[],null,["# Migrate accountstatuses to Aggregate Product Statuses\n\nThe way you retrieve aggregated product statistics and issues has changed. The\nfunctionality previously available in the `accountstatuses` resource in the\nContent API for Shopping is now split into dedicated resources in the Merchant\nAPI. This guide explains how to migrate your integration to use the new\n[`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses)\nresource.\n\n**Note** : In Merchant API, account-level issues and aggregate product statuses\nare split. Also review our guide to migrate from `accountstatuses` to\n[account issues](/merchant/api/guides/compatibility/migrate-view-issues).\n\nKey differences\n---------------\n\nHere are the key differences between the product status features in Content\nAPI for Shopping and Merchant API:\n\n- **Dedicated resources** : The `accountstatuses` resource from Content API for Shopping is now split. In Merchant API, account-level issues are available through the [`accountissues`](/merchant/api/reference/rest/accounts_v1/accounts.issues) resource, while aggregated product statistics and item-level issues are available through the new [`aggregateProductStatuses`](/merchant/api/reference/rest/issueresolution_v1/accounts.aggregateProductStatuses) resource.\n- **New resource structure** : `AggregateProductStatus` is a new resource that represents the statistics and issues for a specific combination of a reporting context and a country.\n- **Filtering mechanism** : Instead of using query parameters like `destinations` to select data, Merchant API uses a `list` method with a `filter` string to query for specific reporting contexts and countries.\n- **Channel field removal** : The `channel` field is no longer used. This information is now implicitly part of the `reportingContext`.\n\nRequests\n--------\n\nMerchant API uses a `GET` request with a `filter` parameter to retrieve\naggregated product statuses.\n\n`GET\nhttps://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses`\n\n### Request URL format\n\n| Request description | Content API for Shopping | Merchant API |\n|-----------------------------------|--------------------------------------------------------------|-------------------------------------------------------------------------|\n| Get product statistics and issues | `GET /content/v2.1/{merchantId}/accountstatuses/{accountId}` | `GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses` |\n\nIdentifiers\n-----------\n\nThe way resources are identified has changed to support the new structure.\n\n### Identifier format\n\n| Identifier description | Content API for Shopping | Merchant API |\n|------------------------|-------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Resource Identifier | The resource was identified by `accountId`. Specific data slices were selected with query parameters. | The resource name uniquely identifies the data for a specific reporting context and country: `accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}`. |\n\nMethods\n-------\n\nThe method for retrieving product statuses has been updated to a `list` method\nthat supports filtering.\n\n| Content API for Shopping method | Merchant API method | Availability \\& notes |\n|---------------------------------|---------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `accountstatuses.get` | `aggregateProductStatuses.list` | The `accountstatuses.get` method returned a single resource containing all product statistics. The new `aggregateProductStatuses.list` method returns a list of resources, one for each reporting context and country combination. Use the `filter` parameter to retrieve specific data. For account-level issues, use `accountissues.list`. |\n\nDetailed field changes\n----------------------\n\nThe fields for product statistics and issues have been updated and restructured\nin the new `AggregateProductStatus` resource.\n\n| Content API for Shopping | Merchant API | Description |\n|---------------------------------|---------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------|\n| `products` | `aggregate_product_statuses` | The `products` array is replaced by the `aggregate_product_statuses` repeated field in the list response. |\n| `destination` | `reporting_context` | The `destination` field is replaced by `reporting_context`, which specifies the program context for the stats. |\n| `channel` | (no equivalent field) | The `channel` field is removed. This information is now part of the `reporting_context`. |\n| `statistics` | `stats` | The `statistics` object is renamed to `stats`. Field names within are converted to snake_case, for example, `activeCount` is now `active_count`. |\n| `itemLevelIssues.servability` | `item_level_issues.severity` | The `servability` enum is replaced by the `severity` enum to describe the impact of an issue. |\n| `itemLevelIssues.attributeName` | `item_level_issues.attribute` | The field `attributeName` is renamed to `attribute`. |\n| `itemLevelIssues.documentation` | `item_level_issues.documentation_uri` | The field `documentation` is renamed to `documentation_uri`. |\n| `itemLevelIssues.numItems` | `item_level_issues.product_count` | The field `numItems` is renamed to `product_count`. |"]]
