Kontostatus zu zusammengefassten Produktstatus migrieren

Die Art und Weise, wie Sie aggregierte Produktstatistiken und ‑probleme abrufen, hat sich geändert. Die Funktion, die zuvor in der Ressource accountstatuses in der Content API for Shopping verfügbar war, ist jetzt in der Merchant API in separate Ressourcen aufgeteilt. In diesem Leitfaden wird erläutert, wie Sie Ihre Integration so umstellen, dass die neue aggregateProductStatuses Ressource verwendet wird.

Hinweis: In der Merchant API sind Probleme auf Kontoebene und aggregierte Produktstatus getrennt. Lesen Sie auch unseren Leitfaden zur Migration von accountstatuses zu Kontoproblemen.

Wichtige Unterschiede

Hier sind die wichtigsten Unterschiede zwischen den Produktstatusfunktionen in der Content API for Shopping und der Merchant API:

  • Separate Ressourcen: Die accountstatuses Ressource aus der Content API for Shopping ist jetzt aufgeteilt. In der Merchant API sind Probleme auf Kontoebene über die Ressource accountissuesverfügbar, während aggregierte Produktstatistiken und Probleme auf Artikelebene über die neue Ressource aggregateProductStatusesverfü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, verwendet die Merchant API eine list-Methode mit einem filter-String, um nach bestimmten Berichtskontexten und Ländern zu suchen.
  • Entfernung des Felds „channel“: Das channel Feld wird nicht mehr verwendet. Diese Informationen sind jetzt implizit Teil von reportingContext.

Anfragen

Die Merchant API verwendet eine GET-Anfrage mit einem filter-Parameter, um aggregierte Produktstatus abzurufen.

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

Anfrage-URL-Format

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, wurde geändert, um die neue Struktur zu unterstützen.

ID-Format

Beschreibung der ID Content API for Shopping Merchant API
Ressourcen-ID Die Ressource wurde durch accountId identifiziert. Bestimmte Datenslices wurden mit Abfrageparametern ausgewählt. Der Ressourcenname identifiziert die Daten eindeutig für einen bestimmten Berichtskontext und ein bestimmtes Land: 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. Verwenden Sie den Parameter filter, um bestimmte Daten abzurufen. Verwenden Sie für Probleme auf Kontoebene accountissues.list.

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 Objekt statistics wurde in stats umbenannt. Feldnamen werden in Snake Case umgewandelt. So wird beispielsweise aus activeCount jetzt 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 wurde in attribute umbenannt.
itemLevelIssues.documentation item_level_issues.documentation_uri Das Feld documentation wurde in documentation_uri umbenannt.
itemLevelIssues.numItems item_level_issues.product_count Das Feld numItems wurde in product_count umbenannt.
Zurück
Migrate accountstatuses to Account Issues
Weiter
Migrate user and access management