Hauptseite
Programmierung & Skripten
Einführung in die Ebay -API mit Python The Trading API - Teil 3

Programmierung & Skripten

Einführung in die Ebay -API mit Python The Trading API - Teil 3

1190
27
Miriam Bauschke

Dies ist der dritte Artikel der Serie, der eBay APIs gewidmet ist und deren Verwendung über Python. Im ersten Artikel haben wir gesehen.

In dem zweiten Artikel haben wir uns dem angenommen API finden, Konzentration auf das FindItemsByKeywords Forderung. In diesem Artikel werden wir die vorstellen Handels -API.

In diesem Tutorial lernen Sie:

Was sind einige der nützlichsten "Handels -API" -Nrufe
So erstellen Sie ein Element mit dem Artikel hinzufügen API -Anruf

Einführung in die eBay -API mit Python: Die Handels -API - Teil 3

Softwareanforderungen und Konventionen verwendet

Softwareanforderungen und Linux -Befehlszeilenkonventionen

Kategorie	Anforderungen, Konventionen oder Softwareversion verwendet
System	Betriebssystem agnostisch.
Software	Git und Python3
Andere	Kenntnis der Python -Programmiersprache und der grundlegenden objektorientierten Konzepte.
Konventionen	# - erfordert, dass gegebene Linux -Befehle mit Root -Berechtigungen entweder direkt als Stammbenutzer oder mit Verwendung von ausgeführt werden können `sudo` Befehl $ - Erfordert, dass die angegebenen Linux-Befehle als regelmäßiger nicht privilegierter Benutzer ausgeführt werden können

Die Handels -API

Der Handels -API ist Gegenstand dieses dritten Artikels in dieser Serie, die Python und Ebay APIs gewidmet ist. Diese spezifische API enthält viele sehr nützliche Anrufe: Durch die Verwendung von diesem können wir unter anderem Elemente erstellen oder beenden und Informationen zu Kategorien, Geschäften oder Verkäufern abrufen.

Die Handels -API ruft an

Die Liste der verfügbaren Handels -API Anrufe sind zu lang, um hier in seiner Gesamtheit präsentiert zu werden. Hier präsentieren wir jedoch einige von ihnen und das Ziel, das wir mit ihrer Verwendung erreichen können:

AddItem - Mit diesem Anruf können wir einen Artikel sowohl mit festem Preis als auch mit einer Auktion verkaufen
AddtowatchList - Durch diesen Anruf können wir unserer Beobachtungsliste einen oder mehrere Elemente hinzufügen
EndItem - Mit diesem Anruf können wir den Verkauf eines Artikels vor dem festgelegten Ablaufdatum aufhören, einen Artikel zu verkaufen
GetCategories - Verwenden Sie diesen Anruf, um Informationen über die Kategorien von eBay für eine bestimmte Website zu erhalten
GetMyEbayselling - Informationen über unsere Verkaufstätigkeit abrufen
GetStore - Informationen zu einem bestimmten eBay -Store abrufen

Die Art und Weise, wie wir diese Anrufe verwenden. Um die vollständige Liste der verfügbaren Anrufe zu finden, lesen Sie bitte die
offizielle Dokumentation.

Ein Token erzeugen

Vergewissern Sie sich, dass Sie vor dem Fortfahren einen Sandbox -Test "Test" erstellt haben und die im ersten Artikel dieser Serie enthaltenen Schritte befolgt haben. In der Wurzel unseres Projekts haben wir die verwendet Ebay.Yaml Datei, um unsere Anmeldeinformationen für die verschiedenen Domänen zu speichern. Um die zu verwenden Handels -API, und interagieren Sie mit dem SANDBOX -Test "Test", wir müssen unsere bereitstellen App ID, Dev ID, Cert id Und ein Token werden wir jetzt erzeugen.

Ein Token zu erhalten ist ziemlich einfach. Greifen Sie auf die Website des eBay -Entwicklerprogramms zu und navigieren Sie zur Seite für Anwendungsschlüssel. Hier im Abschnitt Sandkasten (links) im Inneren der App ID Feld, klicken Sie auf die User Tokens Verknüpfung. Sie werden in diesen Abschnitt umgeleitet:

Melden Sie sich bei eBay Sandbox an

Klicken Sie auf die blaue Schaltfläche „Anmelden in Sandbox“ und Sie werden an die Anmeldeseite der Sandbox -Site gesendet. Hier müssen Sie den zuvor erstellten SANDBOX -Benutzer "Test" verwenden. Sobald Sie sich erfolgreich angemeldet haben, werden Sie aufgefordert, zu bestätigen, dass Sie Zugriff auf Ihre Kontodaten gewähren möchten:

Zugriff auf Antrag der Bewerbung gewähren

Klicken Sie auf die Schaltfläche „Vereinbarung“ und Sie werden zur Token -Generierungsseite zurückgeleitet. Hier sehen Sie das neue erzeugte Token:

Abrufen Sie eine neue api erzeugte Token ab

Der nächste Schritt besteht darin, das Token und die anderen Anmeldeinformationen im Inneren zu kopieren Ebay.Yaml Datei, im entsprechenden Abschnitt, genau wie im Bild unten:

Ebay.Yaml Konfiguration mit neu eBay generiertem Token und anderen Anmeldeinformationen

Alles ist vorhanden. Lassen Sie uns unseren Artikel erstellen!

Erstellen eines Elements mit dem AddItem API -Anruf

Erstellen wir in der Wurzel unseres Projekts ein neues Skript und nennen Sie es Artikel hinzufügen.py. Innerhalb davon schreiben wir den Code, der zum Erstellen unseres ersten Elements erforderlich ist. Angenommen, wir möchten eine mechanische Tastatur verkaufen. Hier ist der Code, den wir schreiben können:

#!/usr/bin/env python3 aus eBaysdk.Handelsimportverbindung, wenn __name__ == '__main__': api = Verbindung (config_file = "eBay.yaml ", domain =" api.Sandkasten.Ebay.com ", debug = true) request = " item ": " title ":" professionelle mechanische Tastatur "," Land ":" US "," Ort ":" It "," Site ":" US ",", " ConditionID ":" 1000 "," paymentmethods ":" paypal "," paypalemailaddress ":" [email protected] "," primaryCategory ": " categoryId ":" 33963 "," Beschreibung ":" Eine wirklich schöne mechanische Tastatur!"," ListingDuration ":" Days_10 "," Startprice ":" 150 "," Währung ":" USD "," Returnpolicy ": " returnsacceptedoption ":" Returnsaccepted "," Rückerstattung ":" Geldback "," Returnwithinoption " : "Days_30", "Beschreibung": "Wenn Sie nicht zufrieden sind, geben Sie die Tastatur zurück."," ShippingCostPaidByOption ":" Käufer "," ShippingDetails ": " ShippingServiceOptions ": " freeshiping ":" true "," shippingService ":" uspsmedia "," DispatchTimemax ":" 3 " api api.ausführen ("AddItem", Anfrage)

Kopieren

Schauen wir uns den obigen Code an. Als erstes haben wir das importiert Verbindung Klasse aus dem eBaysdk.Handel Modul. Wir sind die benötigte Bibliothek, wir haben eine neue Instanz der erstellt Verbindung Klasse: In seinem Konstruktor haben wir den Speicherort der Konfigurationsdatei angegeben, genau wie für die Finding -API und auch die Domäne, die für die Anforderung verwendet werden soll, was in diesem Fall ist API.Sandkasten.Ebay.com.

Dadurch haben wir erklärt, dass unsere Anfrage wird
an die Sandbox -Site gesendet werden: Unsere Anmeldeinformationen werden je nach Domain in der Konfigurationsdatei durchsucht. Schließlich haben wir den Debug -Modus aktiviert: Dies ist bei einer komplexen Anforderung sehr nützlich, da mögliche Fehler sofort erkannt werden.

Der nächste Schritt war die Erstellung der Anfrage und die Beschreibung unserer Artikel in Form eines einfachen Python -Wörterbuchs. Lassen Sie uns kurz die verschiedenen Eigenschaften sehen, die wir verwendet haben.

Standort und Landinformationen

Durch Verwendung der Titel Option Wir haben den Titel unserer Auflistung angegeben: Beim Verkauf eines Artikels bei eBay ist es sehr wichtig, einen guten Titel zu finden. Mit Land Wir haben das Land der Verkäuferregistrierungsadresse erklärt: Dieser Wert besteht aus zwei Ziffern; Sie können diese Liste konsultieren, um alle möglichen anwendbaren Werte zu finden.

Der nächste Schlüssel, den wir verwendet haben, ist Standort: Dies ist erforderlich, um den geografischen Ort des Artikels anzugeben, in diesem Fall Italien.

Mit Grundstück, Stattdessen haben wir die eBay -Site angegeben, in der das Element angezeigt werden soll. Dieser Parameter wirkt sich auf andere aus. Dieser Wert muss mit der im Konstruktor des Konstruktors angegebenen Stelle übereinstimmen Verbindung Klasse (der Standard ist "eBay-us").

Deklarieren Sie die Artikelbedingungen

Eine weitere wichtige Sache zu definieren ist der Zustand des Artikels. Ein Artikel kann zum Beispiel neu oder verwendet werden, und einige bestimmte Artikel haben je nach Kategorie eine dedizierte Bedingung, die verwendet werden kann. In diesem Fall haben wir verwendet "1000" Welches ist der Code, der dem "neuen" Status entspricht. Eine Tabelle der verfügbaren Codes finden Sie hier.

Festlegen einer Zahlungsmethode

Die Zahlungsmethode, die wir akzeptieren möchten, kann aus der Liste aller verfügbaren Zahlungsmethoden ausgewählt werden. In diesem Fall haben wir „PayPal“ verwendet, und wir haben auch die E -Mail -Adresse zur Verwendung für die Zahlung angegeben, indem wir die verwenden Zahlungsarten Und Paypalemailaddress Schlüssel.

Auswahl einer Kategorie für den Artikel

Der nächste Schritt bestand darin, eine Kategorie für den Artikel zu definieren, den wir verkaufen Primärkategorie Schlüssel, der einem Wörterbuch entspricht, in dem die tatsächliche Kategorie -ID durch die identifiziert wird Kategorie ID Taste. Jede Kategorie wird durch eine eindeutige ID im Kontext einer bestimmten Stelle identifiziert, die Kennungen können jedoch auf den verschiedenen eBay -Standorten unterschiedlich sein. Die richtige Kategorie zu finden kann eine mühsame Aufgabe sein. Um die richtige zu finden, können Sie bestimmte Anrufe wie verwenden wie Getugg -kategorien Oder Sie können solche Online -Tools konsultieren.

Eine weitere wichtige Sache ist zu bemerken, dass eBay bei der Auswahl einer Kategorie für einen Artikel erwartet, dass Sie eines der letzten Segment eines Kategoriebaum. In diesem Fall haben wir verwendet 33963 was entspricht Tastaturen & Tastaturen und ist eines der letzten Segmente der Computer/Tablets & Networking Kategorie, der vollständige Pfad ist Computer/Tablets & Networking> Tastaturen, Mäuse und Hinweise> Tastaturen & Tastaturen.

Festlegen der Artikelbeschreibung und des Preis

Die Beschreibung ist ein weiteres sehr wichtiges Feld: Dies ermöglicht es uns, das Element mit einer höheren Detailebene zu beschreiben. Wir sind hier nicht auf Klartext beschränkt, sondern können auch grundlegende HTML- und CSS -Code verwenden, aber wir dürfen keine aktiven Inhalte verwenden, sodass die Verwendung von JavaScript beispielsweise verboten ist. Wenn wir HTML -Tags bereitstellen und diese Funktion nutzen möchten, müssen wir verwenden CDATA Spezifische Syntax bei der Verwendung des Python SDK:

"Beschreibung": ""

Mit ListingDuration Wir haben das Zeitintervall angegeben, das die Auflistung aktiv bleibt. EBay verwendet eine Liste von Codetypen, die in diesem Feld verwendet werden sollen (einige Typen haben eine eingeschränkte Verwendung). In diesem Fall haben wir verwendet "Days_10" die eine Dauer von 10 Tagen festlegen.

Der Wert, den wir für einen Wert leisten Startprice wird je nach Art der Auflistung unterschiedlich interpretiert: Wenn es sich um eine Auktion handelt, gilt dies als Auktionsstartpreis; Wenn es sich um eine Festpreisliste handelt, wird sie stattdessen als der konstante Preis angesehen, den der Kunde zahlen muss, um den Artikel zu kaufen. Unsere Tastaturkosten 150 Einheit der Währung, mit der wir angegeben haben Währung. Der hier zu verwendende Wert muss aus der Liste der verfügbaren Währungen ausgewählt werden.

Einrichtung einer Rückgaberichtlinie

Der nächste Abschnitt, den wir definierten, war der Rücknahmegarantie Abschnitt, der unsere Richtlinien über Renditen beschreibt. Dieser Abschnitt ist definiert als ein Wörterbuch selbst, in dem wir die folgenden Schlüssel verwendet haben:

Returnacceptedoption definiert, ob der Verkäufer Rückgaben akzeptiert oder nicht: Die anwendbaren Werte sind Rückgabe akzeptiert oder Kehrtnotaccepted.

Rückerstattung Definiert, wie Verkäufer die Käufer bei den Renditen erholt haben: Auf allen eBay -Marktplätzen muss dieser Wert auf festgelegt werden Geld zurück, Auf dem US -Marktplatz kann es auch eingestellt werden MoneybackorRäLE.

Der Rückkehr Der Parameter ist ziemlich selbsterklärend: Mit diesem Parameter geben wir die Zeitspanne von der Lieferung an, dass der Käufer den Artikel zurückgeben muss. Die Liste der in diesem Abschnitt verwendeten Werte finden Sie auf dieser Seite. In diesem Fall haben wir verwendet "Days_30": Eine Zeit von 30 Tagen muss verwendet werden, um sich als "Top -bewertete" Auflistung zu qualifizieren.

Der Beschreibung Das Feld enthält eine detaillierte Erläuterung der Verkäufer -Rückgaberichtlinie und dessen im relativen Abschnitt der Seite „anzeigen“ angezeigt. Hier wird normalerweise eine freundliche Nachricht zur Verfügung gestellt.

Mit dem VersandkostpaidbyOption Parameter Es ist möglich zu erklären, wer zwischen dem Verkäufer und dem Käufer die Rücksendungsgebühren bezahlen sollte. Die akzeptierten Werte sind Verkäufer oder Käufer.

Versanddetails

Ein weiterer sehr wichtiger Abschnitt, der definiert werden muss Versendenserviceoption Taste. Dieser Schlüssel ist mit einem Wörterbuch verbunden, in dem wir verschiedene Parameter definieren können. In diesem Fall setzen wir eine kostenlose Versandrichtlinie mit der Verwendung der Kostenloser Versand Schlüssel und Bereitstellung WAHR (Zeichenfolge) als Wert, und wir haben den Versanddienst mit definiert Versand-Service. Wenden Sie sich an diese Liste, um einen vollständigen Überblick über mögliche Werte zu erhalten, die hier verwendet werden sollen.

Schließlich haben wir die benutzt Sendatimemax Option, die im Wesentlichen die maximale Anzahl von Werktagen definiert, die ein Verkäufer erklärt, wird zur Erstellung der Versand nach Erhalt einer Zahlung verwendet.

Senden unserer Anfrage und überprüfen Sie das Ergebnis

Wir haben unsere Anfrage erstellt und die erforderlichen Informationen über den Artikel zur Verfügung gestellt, den wir verkaufen möchten. Jetzt können wir unsere Anfrage mit dem verwenden ausführen Methode, so wie wir es für die getan haben API finden, Der Name des Anrufs, Artikel hinzufügen Als erstes Argument und das Anfrage -Wörterbuch als zweites. Wenn nach dem Senden der Anfrage alles gut läuft, sollte der Artikel jetzt auf der Sandbox -Site vorhanden sein. So ist es:

Erstellte Element mit Ebay und Python API

Schlussfolgerungen

In diesem Artikel haben wir uns dem angenommen Handels -API. Unter den vielen verfügbaren Anrufen haben wir uns auf die konzentriert Artikel hinzufügen eins. Wir haben einen Artikel erstellt, der die erforderlichen Felder für eine grundlegende Konfiguration bereitstellt, und unsere Anfrage erfolgreich an unser Sandbox -Konto gesendet. Im nächsten Artikel dieser Serie werden wir darüber sprechen Merchandising -API.

Inhaltsverzeichnis

Teil 0
Einführung
Teil I
Tasten erhalten und auf die Sandbox zugreifen
TEIL II
Die Finding -API
Teil III
Die Handels -API
Teil IV
Die Merchandising -API