Von „accountstatuses“ zu „Account Issues“ migrieren

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

Weitere Informationen zur Verwendung der neuen Funktion finden Sie im Leitfaden zum Aufrufen von Kontoproblemen.

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

Wichtige Unterschiede

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

• Dedizierte Ressource: Kontoprobleme sind eine eigene Ressource. In der Content API for Shopping waren Probleme auf Kontoebene ein verschachteltes Feld innerhalb der allgemeinen AccountStatus-Ressource. Mit der Merchant API können Sie sie direkt mit der Methode accounts.issues.list auflisten.
• Strukturierte Auswirkungsdaten: Die Ressource AccountIssue enthält ein detailliertes 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 Enum: Das Feld severity ist jetzt ein Enum (mit Werten wie CRITICAL, ERROR, SUGGESTION), was die programmatische Verarbeitung im Vergleich zu den stringbasierten Werten in der Content API for Shopping erleichtert.
• Standardisierte Kennungen: Jedes Kontoproblem hat eine eindeutige, vollständige Ressource name im Format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Dieser standardisierte Ansatz ersetzt den String id aus der Content API for Shopping.
• Lokalisierungsunterstützung: Mit der Methode accounts.issues.list können Sie eine language_code angeben, um Problemdetails wie Titel und Beschreibung in Ihrer bevorzugten Sprache zu erhalten. Dies war in der Content API for Shopping nicht möglich.
• Verhalten bei erweiterten Konten: 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 mit Unterkonten werden nicht zurückgegeben. In der Content API for Shopping gibt die Methode accountstatuses.list die Status für alle Unterkonten zurück. Wenn Sie Probleme für alle Unterkonten in der Merchant API abrufen möchten, müssen Sie accounts.listSubaccounts 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

Anfrage-URL-Vergleich

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 Kennungen für Konten und Probleme haben sich in der Merchant API geändert.

ID-Vergleich

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").	Das Feld name im Antworttext, das den vollständigen Ressourcennamen enthält (z. B. accounts/12345/issues/example-issue-id).

Methoden

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

Methodenvergleich

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 get-Methode 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 zugehörigen Unterkonten. Wenn Sie Probleme für alle Unterkonten abrufen möchten, müssen Sie zuerst accounts.listSubaccounts und dann accounts.issues.list für jedes Unterkonto aufrufen.
accountstatuses.custombatch	Keine direkte Entsprechung.	Nicht verfügbar. Die Batchverarbeitung von Kontoproblemen wird in der Merchant API nicht unterstützt. Sie müssen für jedes Konto separate list-Aufrufe ausführen.

Detaillierte Feldänderungen

Die Felder in der Ressource „Kontoproblem“ wurden aktualisiert, um für mehr Struktur und Klarheit zu sorgen.

Feldvergleich

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 mehr.
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 Verdeutlichung umbenannt, um anzugeben, dass es sich um eine URL handelt.
severity (string)	severity (Aufzählung)	Der Schweregrad ist jetzt ein strukturiertes Enum (CRITICAL, ERROR, SUGGESTION) anstelle eines Strings.
country (String), destination (String)	impactedDestinations (wiederholte Nachricht)	Die Auswirkungen werden 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)	Neue Parameter in der list-Anfrage ermöglichen die Lokalisierung von menschenlesbaren Feldern wie title und detail.