Von „accountstatuses“ zu „Account Issues“ migrieren

Die Art und Weise, wie Sie Probleme auf Kontoebene abrufen, die sich auf Ihre Produkte und die Kontoleistung auswirken können, hat sich geändert. Im Vergleich zur Ressource accountstatuses in der Content API for Shopping führt die Merchant API eine eigene Ressource AccountIssue ein, die strukturiertere und detailliertere Informationen bietet.

Weitere Informationen zur Verwendung der neuen Funktion finden Sie im Leitfaden Probleme mit dem Konto ansehen.

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

Wichtige Unterschiede

Hier sind die wichtigsten Verbesserungen und Unterschiede in der Merchant API-Ressource AccountIssue:

• Eigene Ressource:Kontoprobleme sind eine eigene Ressource. In der Content API for Shopping waren Probleme auf Kontoebene ein verschachteltes Feld in der allgemeinen Ressource AccountStatus. Mit der Merchant API können Sie sie direkt mit der Methode accounts.issues.list auflisten.
• Strukturierte Daten zu Auswirkungen:Die Ressource AccountIssue enthält das detaillierte Feld impactedDestinations. In diesem Feld finden Sie eine klare Aufschlüsselung der Auswirkungen eines Problems, einschließlich des Ziels (z. B. Shopping-Anzeigen), der spezifischen Region und des Schweregrads des Problems in dieser Region.
• Schweregrad als Aufzählung:Das Feld severity ist jetzt eine Aufzählung (mit Werten wie CRITICAL, ERROR, SUGGESTION). Dadurch lässt es sich im Vergleich zu den stringbasierten Werten in der Content API for Shopping einfacher programmatisch verarbeiten.
• Standardisierte IDs: Jedes Kontoproblem hat einen eindeutigen, vollständigen Ressourcennamen name im Format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Dieser standardisierte Ansatz ersetzt den String id aus der Content API for Shopping.
• Unterstützung der Lokalisierung:Mit der Methode accounts.issues.list können Sie einen language_code angeben, um Problemdetails wie Titel und Beschreibung in Ihrer bevorzugten Sprache zu erhalten. Das war in der Content API for Shopping nicht möglich.
• Erweitertes Kontoverhalten:Wenn Sie accounts.issues.list für ein erweitertes Konto aufrufen, werden nur Probleme zurückgegeben, die sich direkt auf dieses erweiterte Konto beziehen. Probleme für Unterkonten werden nicht zurückgegeben. In der Content API for Shopping würde die Methode accountstatuses.list die Status für alle Unterkonten zurückgeben. Wenn Sie Probleme für alle Unterkonten in der Merchant API abrufen möchten, müssen Sie accounts.listSubaccounts aufrufen und dann accounts.issues.list für jedes Unterkonto einzeln aufrufen.

Anfragen

In der Merchant API können Sie Kontoprobleme für ein bestimmtes Merchant Center-Konto auflisten.

GET https://merchantapi.googleapis.com/accounts/v1/accounts/ACCOUNT_ID/issues

Vergleich der Anfrage-URLs

Beschreibung der Anfrage	Content API for Shopping	Merchant API
Probleme auf Kontoebene für ein einzelnes Konto auflisten	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID}	GET https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/issues
Probleme auf Kontoebene für alle Unterkonten eines erweiterten Kontos auflisten	GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses	Nicht verfügbar. Sie müssen die Unterkonten durchlaufen.

IDs

Die IDs für Konten und Probleme haben sich in der Merchant API geändert.

Vergleich der IDs

Beschreibung der ID	Content API for Shopping	Merchant API
Konto-ID	{MERCHANT_ID} und {ACCOUNT_ID} als Pfadparameter.	{ACCOUNT_ID} als Pfadparameter im Format accounts/{ACCOUNT_ID}.
Problem-ID	Feld id im Antworttext (z. B. "products-that-enable-dishonest-behavior-hacking-policy").	Feld name im Antworttext, das der vollständige Ressourcenname ist (z. B. accounts/12345/issues/example-issue-id).

Methoden

Die Methoden zum Abrufen von Kontoproblemen wurden in der Merchant API zusammengefasst und vereinfacht.

Vergleich der Methoden

Content API for Shopping	Merchant API	Verfügbarkeit und Hinweise
accountstatuses.get	accounts.issues.list	Verfügbar. Wenn Sie Probleme für ein einzelnes Konto abrufen möchten, verwenden Sie accounts.issues.list und geben Sie die Konto-ID an. Die Merchant API hat keine Methode get für ein einzelnes Problem.
accountstatuses.list	Keine direkte Entsprechung.	Nicht verfügbar. Die Methode accounts.issues.list in der Merchant API gibt nur Probleme für das angegebene Konto zurück, nicht für die Unterkonten. Wenn Sie Probleme für alle Unterkonten abrufen möchten, müssen Sie zuerst accounts.listSubaccounts aufrufen und dann accounts.issues.list für jedes Unterkonto aufrufen.
accountstatuses.custombatch	Keine direkte Entsprechung.	Nicht verfügbar. Die Batchverarbeitung für Kontoprobleme wird in der Merchant API nicht unterstützt. Sie müssen für jedes Konto einzelne list-Aufrufe durchführen.

Detaillierte Feldänderungen

Die Felder in der Ressource für Kontoprobleme wurden aktualisiert, um mehr Struktur und Klarheit zu bieten.

Vergleich der Felder

Content API for Shopping	Merchant API	Beschreibung
accountLevelIssues (Array in AccountStatus)	accountIssues (Array in ListAccountIssuesResponse)	Probleme sind jetzt eine eigene Ressource auf oberster Ebene und kein verschachteltes Feld.
id (String)	name (String)	Die Problem-ID ist jetzt ein vollständiger Ressourcenname, z. B. accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}.
title (String)	title (String)	Keine Änderung.
detail (String)	detail (String)	Keine Änderung.
documentation (String)	documentationUri (String)	Das Feld wurde zur besseren Übersichtlichkeit umbenannt, um anzugeben, dass es sich um eine URL handelt.
severity (String)	severity (Aufzählung)	Der Schweregrad ist jetzt eine strukturierte Aufzählung (CRITICAL, ERROR, SUGGESTION) anstelle eines Strings.
country (String), destination (String)	impactedDestinations (wiederholte Nachricht)	Die Auswirkungen sind jetzt in einer Liste strukturiert, in der Ziel, Region und Schweregrad für jeden betroffenen Bereich gruppiert sind. Das Feld country wird in der Nachricht Impact durch regionCode ersetzt.
(Nicht verfügbar)	language_code, time_zone (Anfrageparameter)	Mit den neuen Parametern in der Anfrage list können für Menschen lesbare Felder wie title und detail lokalisiert werden.