> For the complete documentation index, see [llms.txt](https://coolbax.gitbook.io/coolbax-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://coolbax.gitbook.io/coolbax-docs/handbuecher/administration/google-shopping-und-weiter-feeds/anbindung-an-die-google-api.md). # Anbindung an die Google API Damit Sie die Analyse Ihres Google Feeds direkt in Shopware sehen können müssen Sie das Google Merchant Center in Shopware einbinden. Die Schritt-für-Schritt Anleitung finden Sie hier. {% embed url="" %} Offizielle Google Cloud-Dokumentation {% endembed %} ## Registrierung bei Google Cloud Um das Google Merchant Center in Shopware einzubinden benötigen Sie einen Account bei Google Cloud. Sollten Sie diesen bereits besitzen, melden Sie sich an und gehen zu: ... coming soon ... Mit dem nachfolgenden Link gelangen Sie auf die Seite zur Kontoerstellung für Google Cloud {% embed url="" %} Geben Sie auf der Seite eine Ihre E-Mail-Adresse ein und klicken auf den Button: *Weiter*

Google Cloud - Seite um ein Konto zu erstellen

Sie erhalten anschließend einen Bestätigungscode an die Hinterlegte E-Mail-Adresse. Tragen Sie diese auf der nachfolgenden Seite ein.

Google Cloud - E-Mail-Adresse mit Code bestätigen

Auf der nachfolgenden Seite beginnen Sie mit der Einrichtung des Accounts. Seitzen Sie hier den Haken bei: *Ich bestätige, dass ich mindestens 18 Jahre alt bin*

Im nächsten Schritt müssen Sie Zahlungsinformationen hinterlegen. Unter anderem müssen hier Ihre Adressdaten hinterlegt und eine Zahlungsmetode ausgesucht werden.

Klicken Sie anschließend auf den Button: *Jetzt kostenlos testen.* ## Ein Projekt anlegen Um ein neues Projekt anzulegen gehen Sie links auf das Menü und wählen: *Cloud-Übersicht > Dashboard.* {% embed url="" %}

Anschließend werden Sie zur Übersicht Ihrer Projekte weitergeleitet. * Wenn Sie noch kein Projekt angelegt haben: Klicken Sie auf: *Projekt erstellen*. * Wenn bereits Projekte vorhanden sind: Klicken Sie auf: *Projekt auswählen*, um dort ein neues Projekt anzulegen.

Beispiel für die Cloud-Übersicht ohne Projekte

Beispiel für Fenster von: Projekt auswählen

Auf der darauffolgenden Seite geben Sie dem Projekt einen Namen. In unserem Beispiel nutzen wir: *Coolbax Google Professionell.* Klicken Sie anschließend auf: *Erstellen*

## Projekt Einstellung Um zu den Projekt Einstellungen zu kommen gehen Sie auf die Übersichtseite Ihres Projekts. Sie gelangen über das Menü: *Cloud-Übersicht > Dashboard* oder über die *Projektauswahl* dort hin.

### Merchant APi aktivieren Gehen Sie dort auf: *Dashboard > Erste Schritte > APIs erkunden und aktivieren*.

Auf der nächsten Seite nutzen Sie den Button: *+ APIs und Dienste aktivieren*

In der darauffolgenden Seite nutzen Sie die Suche und suchen nach: *merchant api.* Wählen Sie anschließend in den Suchergebnissen: *Merchant API* aus und aktivieren Sie die Merchant API.

*** ### Dienstkonto erstellen Gehen Sie über die linke Navigation auf: *Anmeldedaten* und klicken auf: *+ Anmeldedaten erstellen.* Wählen Sie anschließend den Menüpunkt: *Dienstkonto* aus.

Wählen Sie ein Name für das Dienstkonto. In unserem Beispiel wählten wir: *Coolbax Google Shopping.* Klicken Sie Anschließend auf: *Erstellen und fortfahren.* {% hint style="info" %} Der Name für das Dienstkonto wird gleichzeitig für die Erstellung einer E-Mail-Adresse genutzt. Diese müssen Sie später im [Google Merchant Center](#google-merchant-center) hinterlegen. {% endhint %} Unter *Berechtigungen (optional)* suchen Sie nach: *Betrachter für DataCatalog,* wählen anschließend: *Betrachter für DataCatalog-Einträge* aus und klicken auf: *Fertig.* {% hint style="info" %} In den Einstellungen: *Hauptkonten mit Zugriff* müssen Sie nichts einstellen {% endhint %}

Sie kommen anschließend wieder zu der Seite mit den Anmeldedaten. Dort finden Sie nun das gerade erstelltes Dienstkonto.

*** ### Datenzugriff einstellen Um die Datenzugriffe zu erstellen nutzen Sie das Menü im oberen linken Rand und wählen: *Google Auth Platform.* Anschließend wählen Sie in der linken Navigation: *Datenzugriff* und auf der erscheinenden Seite den *Button: Erste Schritte*

Auf der nächsten Seite müssen Sie einen Anwendungsnamen und eine Nutzersupport E-Mail auswählen. Anschließend klicken Sie auf: *Weiter*. Bei den Zielgruppen aktivieren Sie: *Extern* und klicken Sie auf: *Weiter*. Bei Kontaktdaten können Sie eine frei wählbare E-Mail-Adresse eintragen. Anschließen klicken Sie auf: *Weiter*. Bestätigen Sie die *Richtlinie zu Nutzerdaten für Google API-Dienste* und klicken auf *Erstellen.*

Klicken Sie anschließend in der linken Navigation auf: *Datenzugriff* und nutzen den Button: *Bereiche hinzufügen oder entfernen*.

Über der erscheinenden Tabelle können Sie nach Namen oder Werte eines Attributs filtern. Tragen Sie hier: *content* ein und bestätigen Sie es mit Enter. Wählen Sie anschließend: *Merchant API* aus und klicken auf *Aktualisieren.*

Sicher Sie die Einstellungen anschließend am Ende der Seite mit dem Button: *Save.*

*** ### O-Auth-Client erstellen Um die O-Auth-Client zu erstellen gehen Sie über das Menü (linker oberer Bildschirmrand) auf: *APIs und Dienste > Anmeldedaten*. Gehen Sie anschließend auf: *+ Anmeldedaten erstellen > OAuth-Client-ID.*

Wählen Sie in der darauffolgenden Seite den Anwendungstyp: Webanwendung, geben diesen einen Namen und klicken anschließend auf: *Erstellen.*

In dem darauffolgenden modalen Fester können Sie sich die JSON-Datei auf Ihren Rechner herunterladen. {% hint style="danger" %} Diese Möglichkeit haben Sie nur ein einziges mal! Bitte vergessen Sie daher nicht die JSON-Datei zu sichern. {% endhint %}

*** ### Schlüssel erstellen Gehen Sie wieder in die *Anmeldedaten* auf: *Dienstkonto* und wählen dort Ihr bereits Erstelltes Konto aus und klicken es an. Wechseln Sie anschließend zu den Menüpunkt: *Schlüssel* und wählen unter: *Schlüssel hinzufügen > Neuen Schlüssel* erstellen aus. In dem darauffolgenden modalen Fenster wählen Sie die Option: *JavaScript Object Notation* aus und klicken auf *Erstellen.* Eine JSON-Datei wird automatisch auf Ihrem Rechner gespeichert. Diese Datei benötigen Sie anschließend für die Verbindung zwischen Google und Shopware.

## Google Merchant Center Loggen Sie sich in Ihr Google Merchant Center ein und gehen anschließend auf: *Einstellungen > Zugriff und Dienste > Personen und Zugriff.* Nutzen Sie hier den Button: *Person hinzufügen.* {% embed url="" %}

Als E-Mail-Adresse müssen Sie diejenige hinterlegen, die bei der [Erstellung des Dienstkontos](#dienstkonto-erstellen) angelegt wurde. Sie finden die E-Mail-Adresse in Google Cloud unter: *APIs und Dienste > Anmeldedaten*. Unter *Dienstkonten* können Sie sich die E-Mail Adresse kopieren. Nachdem Sie die E-Mail-Adresse hinterlegt und auf: *Weiter* geklickt haben müssen Sie diesen Nutzer Administratorrechte geben.

## Einstellungen im Plugin {% hint style="warning" %} **Aktuell funktioniert das Aktualisieren nicht**. Wechseln Sie nach jeder Eingabe zu einem anderen Reiter (z. B.: Statistik) und gehen anschließend wieder auf: Merchant Center verbinden. {% endhint %} Gehen Sie anschließend in ihr Shopware Backend und wählen dort den Google Shopping Verkaufskanal aus und gehen anschließend auf: *Merchant Center verbinden.* Tragen Sie im Feld: *Merchant Center ID* ihre Merchant Center ID ein. Sie finden diese im Google Merchant Center z.B. in der rechten oberen Ecke.

Wählen Sie anschließend die Datei welche Sie im Abschnitt: [Schlüssel erstellen](#schlussel-erstellen) erhalten haben. Nach dem Hochladen verändert sich der Verbindungsstatus und zwei neue Buttons erscheinen. Nutzen Sie hier den Button: *Fehlgeschlagene Verbindung nachmals versuchen.* Danach ist eine Verbindung zum Google Merchant Center hergestellt. {% hint style="info" %} Der Verbindungsaufbau schlägt oft beim ersten Mal fehl. Bitte versuchen Sie es über den Button: *Fehlgeschlagene Verbindung nachmals versuchen* einfach noch einmal. {% endhint %}