Hilfe bei Fehlern

Die häufigsten Meldungen, was dahintersteckt und wie du sie behebst.

Die meisten Probleme bei der Einrichtung haben eine von wenigen Ursachen. Suche die Meldung in der Tabelle.

1. Meldungen und ihre Ursachen

Zu jeder Meldung findest du unten Einzelheiten.

2. Fehler 404 beim Verbindungstest

Tritt beim Verbindung testen ein Fehler 404 auf, ist meist der Testnutzer nicht korrekt hinterlegt.

Öffne in der Google Cloud Console APIs und Dienste → OAuth-Zustimmungsbildschirm → Zielgruppe und prüfe im Abschnitt Testnutzer, ob dort genau das Google-Konto steht, mit dem du dich in Kapitel 6 angemeldet hast.

Fehlt es oder ist es falsch geschrieben, trage es nach — der Weg dazu steht in Kapitel 4, Punkt 10. Führe anschließend die Anmeldung aus Kapitel 6 erneut aus und teste danach noch einmal.

3. PERMISSION_DENIED oder HTTP 403

Die Zugangsdaten sind gültig, aber das Dienstkonto darf nicht auf das Merchant-Center-Konto zugreifen.

Prüfe zwei Dinge:

1. Den Eintrag im Merchant Center. Unter Einstellungen → Zugriff und Dienste → Personen und Zugriff muss die Adresse des Dienstkontos stehen, mit dem Zugriffstyp Administrator (Kapitel 5). Eine Abweichung von einem Zeichen genügt, damit Google den Zugriff verweigert.
2. Die Konto-ID. Vergleiche die in Shopware eingetragene Merchant-Center-Konto-ID mit der aus Kapitel 1.

4. GCP_NOT_REGISTERED

Diese Meldung sagt genau, was fehlt: die einmalige Registrierung des Cloud-Projekts beim Merchant-Konto aus Kapitel 6.

Führe die Anmeldung dort aus. Nach der Erfolgsmeldung braucht Google etwa fünf Minuten, bis die Registrierung überall greift — teste erst danach erneut.

5. „Merchant API has not been used"

Die vollständige Meldung von Google lautet meist „Merchant API has not been used in project … before or it is disabled". Im Cloud-Projekt ist die Schnittstelle also nicht freigeschaltet.

Hole Kapitel 2, Abschnitt „Merchant API freischalten" nach. Achte darauf, die Merchant API zu aktivieren und nicht die Content API for Shopping. Nach dem Aktivieren dauert es ein bis fünf Minuten, bis die Freigabe wirkt.

6. invalid_grant, Invalid JWT oder JSON-Fehler

Alle drei Meldungen bedeuten dasselbe: Shopware kann mit dem hinterlegten Schlüssel keine gültige Anmeldung bei Google bilden. In der Praxis ist beim Kopieren etwas verloren gegangen — eine fehlende geschweifte Klammer, ein abgeschnittenes Ende, ein durch die Zwischenablage veränderter Zeilenumbruch.

Öffne die JSON-Datei erneut in einem Texteditor, markiere den gesamten Inhalt und füge ihn neu ein. Hilft das nicht, erzeuge in der Cloud Console einen neuen Schlüssel (Kapitel 2) und trage diesen ein.

7. 401 UNAUTHENTICATED

Das Schlüsselfeld ist leer oder der Inhalt ist beschädigt.

Die Merchant API akzeptiert ausschließlich den JSON-Schlüssel eines Dienstkontos. Ein in der Cloud Console erzeugter API-Schlüssel funktioniert hier nicht, auch wenn er ähnlich aussieht.

8. Verbindung in Ordnung, aber keine Produkte im Merchant Center

Der Verbindungstest prüft nur, ob Shopware mit deinem Konto sprechen darf — nicht, ob schon Produkte angekommen sind. Bleibt das Merchant Center leer, gehe der Reihe nach vor:

1. Warten. Nach der ersten Übertragung dauert die Verarbeitung bei Google einige Minuten.
2. Protokoll in Shopware ansehen. Die Karte Protokoll unten im Verkaufskanal zeigt, was übertragen wurde und woran es gescheitert ist. Steht dort nichts, wurde noch nichts gesendet — prüfe dann, ob der Verkaufskanal aktiv ist (Kapitel 10) und ob der In-App-Kauf gebucht ist.
3. Merchant Center prüfen. Unter Produkte listet Google Hinweise und Ablehnungen zu einzelnen Artikeln.
4. Feedlabel und Inhaltssprache prüfen. Passen die Werte aus Kapitel 9 nicht zu deinem Konto, kommen die Produkte an, erscheinen aber nicht im erwarteten Zielmarkt.

9. Der Shop ist von außen nicht erreichbar

Dieser Fall betrifft nur Test- und Entwicklungsumgebungen: Ist dein Shop nicht öffentlich erreichbar, kann Google die Weiterleitungs-URI aus Kapitel 4 nicht aufrufen, und die Anmeldung aus Kapitel 6 kommt nie zurück.