Kontostatus zu zusammengefassten Produktstatus migrieren
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die Art und Weise, wie Sie aggregierte Produktstatistiken und ‑probleme abrufen, hat sich geändert. Die Funktionen, die zuvor in der Ressource accountstatuses in der Content API for Shopping verfügbar waren, sind jetzt in der Merchant API in separate Ressourcen aufgeteilt. In diesem Leitfaden wird beschrieben, wie Sie Ihre Integration auf die neue aggregateProductStatuses-Ressource umstellen.
Hinweis: In der Merchant API werden Probleme auf Kontoebene und aggregierte Produktstatus aufgeteilt. Lesen Sie auch unseren Leitfaden zur Migration von accountstatuses bei Kontoproblemen.
Wichtige Unterschiede
Im Folgenden finden Sie die wichtigsten Unterschiede zwischen den Produktstatusfunktionen in der Content API for Shopping und der Merchant API:
Eigene Ressourcen: Die accountstatuses-Ressource aus der Content API for Shopping ist jetzt aufgeteilt. In der Merchant API sind Probleme auf Kontoebene über die Ressource accountissues verfügbar, während aggregierte Produktstatistiken und Probleme auf Artikelebene über die neue Ressource aggregateProductStatuses verfügbar sind.
Neue Ressourcenstruktur: AggregateProductStatus ist eine neue Ressource, die die Statistiken und Probleme für eine bestimmte Kombination aus einem Berichtskontext und einem Land darstellt.
Filtermechanismus: Anstatt Abfrageparameter wie destinations zum Auswählen von Daten zu verwenden, wird in der Merchant API die Methode list mit einem filter-String verwendet, um bestimmte Berichtskontexte und Länder abzufragen.
Entfernung des Kanalfelds: Das Feld channel wird nicht mehr verwendet. Diese Informationen sind jetzt implizit Teil von reportingContext.
Anfragen
In der Merchant API wird eine GET-Anfrage mit einem filter-Parameter verwendet, um aggregierte Produktstatus abzurufen.
GET
https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
URL-Format für Anfragen
Beschreibung der Anfrage
Content API for Shopping
Merchant API
Produktstatistiken und ‑probleme abrufen
GET /content/v2.1/{merchantId}/accountstatuses/{accountId}
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses
IDs
Die Art und Weise, wie Ressourcen identifiziert werden, hat sich geändert, um die neue Struktur zu unterstützen.
ID-Format
Beschreibung der Kennung
Content API for Shopping
Merchant API
Ressourcenkennzeichner
Die Ressource wurde durch accountId identifiziert. Mit Abfrageparametern wurden bestimmte Datensegmente ausgewählt.
Der Ressourcenname identifiziert die Daten für einen bestimmten Berichtskontext und ein bestimmtes Land eindeutig: accounts/{account}/aggregateProductStatuses/{reportingContext}~{country}.
Methoden
Die Methode zum Abrufen von Produktstatus wurde in eine list-Methode aktualisiert, die das Filtern unterstützt.
Content API for Shopping-Methode
Merchant API-Methode
Verfügbarkeit und Hinweise
accountstatuses.get
aggregateProductStatuses.list
Die Methode accountstatuses.get hat eine einzelne Ressource mit allen Produktstatistiken zurückgegeben. Die neue Methode aggregateProductStatuses.list gibt eine Liste von Ressourcen zurück, eine für jede Kombination aus Berichtskontext und Land. Mit dem Parameter filter können Sie bestimmte Daten abrufen. Verwenden Sie accountissues.list für Probleme auf Kontoebene.
Detaillierte Feldänderungen
Die Felder für Produktstatistiken und ‑probleme wurden in der neuen Ressource AggregateProductStatus aktualisiert und neu strukturiert.
Content API for Shopping
Merchant API
Beschreibung
products
aggregate_product_statuses
Das Array products wird in der Listenantwort durch das wiederholte Feld aggregate_product_statuses ersetzt.
destination
reporting_context
Das Feld destination wird durch reporting_context ersetzt, das den Programmkontext für die Statistiken angibt.
channel
(kein entsprechendes Feld)
Das Feld channel wurde entfernt. Diese Informationen sind jetzt Teil von reporting_context.
statistics
stats
Das statistics-Objekt wird in stats umbenannt. Feldnamen werden in snake_case konvertiert, z. B. activeCount in active_count.
itemLevelIssues.servability
item_level_issues.severity
Die Enum servability wird durch die Enum severity ersetzt, um die Auswirkungen eines Problems zu beschreiben.
itemLevelIssues.attributeName
item_level_issues.attribute
Das Feld attributeName wird in attribute umbenannt.
itemLevelIssues.documentation
item_level_issues.documentation_uri
Das Feld documentation wird in documentation_uri umbenannt.
itemLevelIssues.numItems
item_level_issues.product_count
Das Feld numItems wird in product_count umbenannt.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 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`. |"]]
