Um den Konnektor nutzen zu können, müssen Sie die Credentials Environment, Redirect URI, Client ID und Client Secret bereithalten.

Environment

Beschreibt die Art der Umgebung. Sie könne hier zwischen “Sandbox” und “Production” wählen. Die Sandbox-Umgebung ermöglicht es Ihnen, mit der eBay-API entwickelte Anwendungen in einer simulierten Umgebung zu testen, während sie die Production-Umgebung für die produktive Nutzung verwenden. Der Betrieb einer Anwendung in der Sandbox ist im Wesentlichen identisch mit dem Betrieb in der Produktionsumgebung.

RuName-Wert (Redirect URI)

Um einen Zugriffs-Token auszustellen, braucht die eBay-API einen einen redirect_url-Wert, den der Dienst für die Autorisierung verwendet, sowie eine URL, um den Benutzer nach Abschluss der Anforderung zur Vergabe von Berechtigungen umzuleiten. Diese Informationen fasst die API im sogenannten RuName-Parameter zusammen, den eBay generiert und Ihrer Anwendung zuweist.

Client ID

Die client_id ist der Teil ihrer OAuth-Anmeldeinformationen, den sie mit anderen teilen können, um ihnen Zugriff auf ihre Anwendungen zu geben.

Client Secret

Das client_secret ist der Teil ihrer OAuth-Anmeldeinformationen, den sie unbedingt vertraulich behandeln müssen.

Um über den Konnektor auf die eBay-API zugreifen zu können, müssen sie im eBay-Backend OAuth-Anmeldeinformationen für flowground anlegen. Die REST-APIs von eBay verwenden das OAuth 2.0-Protokoll für die Autorisierung sowohl von Anwendern als auch von Applikationen.

Die OAuth-Anmeldeinformationen Ihrer Anwendung bestehen aus einer client_id und einem client_secret. Die client_id können Sie mit anderen Personen teilen, die Zugriff auf Ihre Applikationen brauchen. Dagegen müssen Sie die client_secret sicher aufbewahren – sie ermöglicht den Zugriff auf sensible Daten und muss unbedingt vertraulich behandelt werden.

Wenn Sie mehrere Anwendungen haben, müssen Sie für jede Anwendung unterschiedliche Anmeldeinformationen verwenden. Auch für die Produktions- und die Sandbox-Umgebung müssen Sie unterschiedliche Credentials verwenden.

Um Ihre OAuth-Anmeldeinformationen zu erhalten, müssen Sie sich zuvor beim eBay Developer Program angemeldet haben.

1. Navigieren Sie dann in Ihrem Konto zu "Your Account > Application Keys".
2. Geben Sie Ihren neuen Anwendungsnamen ein und füllen Sie dann die Felder auf der Seite "Hauptkontakt für dieses Konto bestätigen" aus. Schließen Sie den Registrierungsprozess ab, indem Sie auf “Weiter” klicken, um die Schlüssel zu erstellen.
3. Rufen Sie dann die Werte App-ID (client_ID) und Cert ID (Client Secret) entweder für die Sandbox- oder Produktionsumgebung ab, je nachdem, welche Umgebung Sie ansprechen.

Der RuName-Wert Parameter enthält Informationen zu einer Redirect-URL, welche der Dienst für die Autorisierung verwendet, sowie einer URL, zu welcher der Benutzer umgeleitet wird, nachdem er eine Berechtigung zum Zugriff erhalten hat. Er wird auch eBay Redirect URL name genannt.

Jede Anwendung hat zwei eindeutige RuName-Werte, die jeweils für die Sandbox- oder die Produktionsumgebung gelten.

Den RuName-Parameter erhalten Sie im Backend des eBay Developer Programs unter "Your Account > Application Keys". Mehr Informationen zum RuName-Parameter finden Sie auf der eBay-Website. 

Dieser Konnektor hat keine Triggerfunktionen. Dies bedeutet, dass Sie ihn beim Entwurf eines Flows nicht als Start-Konnektor verwenden können.

Der Konnektor stellt die folgenden Actions bereit:

GetItem

Ruft Details zu einem spezifischen Artikel auf.

GetItemFeed

Mit diesem Aufruf können Sie eine tägliche Item-Feed-Datei mit allen Elementen herunterladen, die an einem bestimmten Tag in einer bestimmten Kategorie aufgelistet wurden.

GetItemDescriptionFeed

Mit diesem Request können Sie eine tägliche Beschreibungs-Feed-Datei herunterladen, die die Beschreibungen aller Artikel enthält, die an einem bestimmten Tag in einer bestimmten Kategorie aufgeführt wurden.

GetItemSnapshotFeed

Mit diesem Aufruf können Sie eine stündliche Feed-Datei herunterladen, die alle Elemente enthält, die sich innerhalb des angegebenen Tages und der angegebenen Stunde für eine bestimmte Kategorie geändert haben. Sie können die Rückgabe auf diesen Aufruf verwenden, um die Artikeldetails der in Ihrer Datenbank gespeicherten Elemente zu aktualisieren.

Produktdetails eines bestimmten Artikels können Sie mit der Action GetItem abrufen. Dieser Request fragt Details eines bestimmten Artikels ab, wie zum Beispiel Beschreibung, Preis, Kategorie, Zustand, Rückgaberichtlinien, Verkäuferfeedback und -bewertung, Versandoptionen, Versandkosten und geschätzte Lieferung.

Sie müssen dazu zwei Eingabefelder ausfüllen:

itemId

Die eBay RESTful-Kennung eines Artikels. Diese ID wird von den Aufrufen der Browse- und Feed-APIs zurückgegeben.

fieldgroups

Hier müssen Sie entweder den Wert COMPACT oder PRODUCT eingeben. COMPACT gibt eine beschränkte Auswahl an Informationen zurück, mit der Sie schnell überprüfen können, ob sich die Verfügbarkeit oder der Preis des Artikels geändert hat oder ob der Artikel vom Verkäufer überarbeitet wurde. PRODUCT dagegen gibt die volle Auswahl an Informationen zurück.

Der Konnektor unterstützt nicht den API-Aufruf GetCategories, mit dem Sie eine Hierarchie der Produktkategorien runterladen können. Sie können aber mit der Action GetItemFeed eine tägliche Item-Feed-Datei mit allen Elementen aufrufen, die an einem bestimmten Tag in einer bestimmten Kategorie aufgelistet wurden. Und mit der Action GetItemDescriptionFeed können Sie die Beschreibungen aller Elemente herunterladen, die an einem bestimmten Tag in einer bestimmten Kategorie aufgelistet wurden.