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 accountstatuses-Ressource in der Content API for Shopping wird in der Merchant API eine spezielle AccountIssue-Ressource 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 aufgeteilt. Lesen Sie auch unseren Leitfaden zur Migration von accountstatuses zu aggregierten Produktstatus.

Wichtige Unterschiede

Hier finden Sie 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 AccountStatus-Ressource. 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 sehen Sie eine detaillierte Aufschlüsselung der Auswirkungen eines Problems, einschließlich des Zielvorhabens (z. B. Shopping-Anzeigen), der jeweiligen 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). Dadurch lässt es sich im Vergleich zu den stringbasierten Werten in der Content API for Shopping einfacher programmieren.
• Standardisierte Kennzeichnungen:Jedes Kontoproblem hat eine eindeutige, vollständige Ressource name im Format accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}. Dieser standardisierte Ansatz ersetzt den id-String aus der Content API for Shopping.
• Unterstützung bei der Lokalisierung: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. 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. Es werden keine Probleme für die zugehörigen Unterkonten 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.

Anfragen

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

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

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

Vergleich von Kennungen

Beschreibung der Kennung	Content API for Shopping	Merchant API
Konto-ID	{MERCHANT_ID} und {ACCOUNT_ID} als Pfadparameter.	{ACCOUNT_ID} als Pfadparameter im Format accounts/{ACCOUNT_ID}.
Fehler-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 konsolidiert 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 und nicht für die zugehörigen Unterkonten zurück. 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 einzelne list-Aufrufe ausführen.

Detaillierte Feldänderungen

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

Feldvergleich

Content API for Shopping	Merchant API	Beschreibung
accountLevelIssues (Array in AccountStatus)	accountIssues (Array in ListAccountIssuesResponse)	Probleme sind jetzt eine dedizierte 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 besseren Verständlichkeit umbenannt, um anzugeben, dass es sich um eine URL handelt.
severity (string)	severity (Aufzählung)	Der Schweregrad ist jetzt ein strukturierter Enum-Wert (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 werden. Das Feld country wird in der Impact-Nachricht durch regionCode ersetzt.
(nicht verfügbar)	language_code, time_zone (Anfrageparameter)	Neue Parameter in der list-Anfrage ermöglichen die Lokalisierung von für Menschen lesbaren Feldern wie title und detail.