Kontostatus zu zusammengefassten Produktstatus migrieren

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.