API

---

Authentifizierung

Um die Merchant API for Shopping mit einem bestimmten Merchant Center-Konto zu verwenden, muss ein API Console-Projekt einrichten. Hilfe zu Google Cloud Console-Projekten verwalten Sie den API-Zugriff und die Authentifizierung für Ihre Merchant-API-Lösung.

Je nach Anwendungsfall gibt es zwei Möglichkeiten, auf die Merchant API zuzugreifen:

• Für den Zugriff auf ein bestimmtes Merchant Center-Konto wird OAuth 2.0 empfohlen über eine Anwendung einrichten, die Sie für Ihre Nutzer entwickelt haben. Der Nutzer wird Ihnen Zugriff auf Ihr Konto gewähren müssen, damit er Daten in seinem Namen einreichen kann.
• Ein Dienstkonto ist eine spezielle Art von Konto, das in der Regel von einem und nicht auf eine Person. Ein Dienstkonto wird durch seine E-Mail-Adresse identifiziert die für das Konto eindeutig ist.

Weitere Informationen zur Authentifizierung mit OAuth 2.0 oder einem Dienst Konto.

Tipp :Wenn Sie Daten als Partner für lokale Feeds einreichen, muss die E-Mail-Adresse des Kontos zur Liste der Nutzer des Mehrfachkundenkontos hinzugefügt werden, da Anrufe über dieses Konto für alle MCA-Unterkonten authentifiziert werden.

Ländereinstellungen aktivieren

Wichtig: Bevor Sie Angebote einreichen, Daten, die Sie benötigen, um den jeweiligen lokalen

Rufen Sie liasettings.update auf, um die Länder anzugeben, in denen Sie lokale Anzeigen schalten möchten.

Weitere Informationen finden Sie auf der Seite „Ziel für Ländereinstellungen“.

Angebotsdaten senden

Es gibt zwei Arten von Daten: Produkt- und Inventardaten.

Produkt- und Inventardaten gleichzeitig senden

Produkt- und Inventardaten können mithilfe von accounts.lfpInventories.insert

Das Feld „GTIN“ dient als Produktkennzeichnung für den Google-Katalog. Dadurch wird automatisch ein Produktfeed erstellt.

Dieser automatisch erstellte Feed wird im Ziel-Merchant Center als „Lokaler Feedanbieter“ mit den entsprechenden Angeboten.

Diese Methode eignet sich gut, wenn alle Produkte des Händlers eine GTIN haben und keine weiteren Produkte Funktionen aktiviert werden, z. B. die vom Händler gehostete Verkäuferseite (einfach). Wenn Sie die vom Händler gehostete Verkäuferseite für Ihre Händler aktivieren möchten, senden Sie einen speziellen Produktfeed. ist die empfohlene Einrichtung.

Dasselbe Verfahren kann mit accounts.lfpSales.insert angewendet werden.

In diesem Fall beziehen sich die Daten auf ein Verkaufsereignis für ein bestimmtes Produkt in einem zu einer bestimmten Zeit.

Produkt- und Inventardaten separat senden

Falls GTINs nicht allgemein verfügbar sind oder Sie lieber eine vorhandenen Produktfeed im Google Target Merchant Center-Konto eine vom Händler gehostete Verkäuferseite für Ihre Händler aktivieren möchten, benötigen Sie einen bestimmten Feed mit lokal erhältlichen Produkten.

Dies kann durch Aufrufen von accounts.productInputs.insert aktiviert werden. und alle statischen Werte eines Produkts einfügen. Denken Sie daran, Channel-Attribut auf „local“.

Weitere Informationen zu grundlegenden Produktdaten finden Sie in diesem Artikel und in der API. allgemeine Anleitung zum Einfügen von Produkten

Der Datenfluss sieht so aus:

• Rufen Sie zuerst accounts.productInputs.insert auf, um den Upload zu starten. Produkte für Ihre Händler
• Rufen Sie dann accounts.lfpInventories.insert auf, um Inventar einzureichen. Daten.

Alternativ können Inventardaten accounts.lfpSales.insert. Ein ML-Modell erstellt dann und vorhersagen Preis und Menge der Angebote basierend auf diesen Daten.

Beispielübersicht für accounts.lfpInventories.insert, accounts.lfpSales.insert accounts.lfpStores.insert

Wichtig: Die in accounts.productInputs.insert gesendete Angebots-ID muss mit der "offerId" in accounts.lfpInventories.insert, sodass Angebote sind richtig zugeordnet.

Wichtig: Für accounts.lfpInventories.insert ist ein übergeordnetes Element vorhanden. -Parameter in der URL. Dies ist das LFP-Anbieterkonto, das vom Support-Team. Das Merchant Center-Konto Ihres Händlers befindet sich in der Nutzlast der Anfrage stattdessen als TargetMerchant gekennzeichnet. Dies ist die Merchant Center-ID des Händler, für den das Inventar eingereicht werden soll.

Wichtiger Hinweis: Produktdaten laufen nach 30 Tagen und Inventardaten nach 14 Tagen ab. Tage. So lassen sich unerwünschte Produkte effektiv entfernen. Produkt und Inventar Daten können mit accounts.lfpInventories.insert gleichzeitig gesendet werden. wenn GTINs für alle Angebote bekannt sind. Alternativ können Sie accounts.productInputs.insert für Produktdaten und accounts.lfpInventories.insert (oder accounts.lfpSales.insert) für Inventardaten

Unternehmensprofildaten senden

Wenn kein Zugriff auf das Google Unternehmensprofil-Konto des Händlers möglich ist zum Abrufen der Geschäftscodes. accounts.lfpStores.insert durch Ihre eigenen spezifischen Geschäftscodes.

Beachten Sie, dass beim Aufrufen von „accounts.lfpinventorys.insert“ oder „accounts.lfpSales.insert“ muss dem Geschäftscode mit dem Geschäftscode übereinstimmen. in lfp Stores-Anfragen bereitgestellt.

Wichtig :Wenn kein passendes Geschäft gefunden wird, sehen Sie das Inventar oder den Umsatz. mit dem Geschäftscode eingereicht wurden, werden nicht verwendet. Für eine höhere Übereinstimmungsrate Die angegebenen Informationen müssen genau mit den bei Google verfügbaren Informationen übereinstimmen. Karten für das jeweilige Geschäft.

Die Antwort von accounts.lfpStores.insert liefert auch ein matchingState und matchingStateHint, wenn der Abgleich fehlgeschlagen ist.

Tipp :Sie sollten diese Antworten überwachen, um Zuordnungsprobleme zu protokollieren und zu beheben. und vermeiden, dass unterschiedliche Filialen angehäuft werden, können Angebote präsentiert werden.