Ebay-Verbindungsdetails

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 23.0.8803 des Connectors.

Erste Schritte

eBay Versionsunterstützung

Der Connector ermöglicht eine relationale Ansicht von Entitäten aus den Trading-, FileTransfer-, BulkData-, Feedback- und Merchandising-APIs.

Herstellen einer Verbindung

Verbindung zu eBay APIs

Um eine Verbindung mit eBay herzustellen, legen Sie folgende Punkte fest:

• SiteID: Setzen Sie dies auf die eBay-Site-ID. Standardmäßig ist dies „0“ (die US-Site).
• UseSandbox: Setzen Sie dies auf True um ein eBay Sandbox-Konto zu verwenden. Standardmäßig stellt der Connector eine Verbindung zu Produktionsumgebungen her.
• RuName: Legen Sie hier den RuName (Name der eBay Umleitungs URL) fest, den Sie zum Anmelden verwenden. Diesen finden Sie in Ihren eBay-Anmeldeeinstellungen.

Authentifizieren Sie sich bei eBay

Der Connector kann sich bei eBay entweder mit dem Authentifizierungsstandard OAuth 2.0 oder mit Auth'n'Auth authentifizieren, der traditionellen Authentifizierung, die von den eBay APIs verwendet wird.

Benutzerkonten (OAuth)

Satz AuthScheme Zu OAuth.

Desktop-Anwendungen

Sie müssen eine benutzerdefinierte OAuth-Anwendung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-App für Informationen zum Erstellen benutzerdefinierter Anwendungen.

OAuth-Zugriffstoken abrufen und aktualisieren

Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• OAuthClientId: Stellen Sie dies auf die App-ID (Client-ID) in Ihrem Schlüsselsatz ein.
• OAuthClientSecret: Setzen Sie dies auf die Cert-ID (Client Secret) in Ihrem Schlüsselsatz.
• CallbackURL: Auf eine URL setzen, die den Servernamen und den Port des Geräts enthält, auf dem der Connector ausgeführt wird. Jede lokale Hostadresse ist verwendbar. Die Standard-Callback-URL lautet: http://localhost:33333.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint von eBay in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab:

1. Der Connector erhält einen Zugriffstoken von eBay und verwendet ihn, um Daten anzufordern.
2. Die OAuth-Werte werden an dem in angegebenen Ort gespeichert OAuthSettingsLocation, soll über mehrere Verbindungen hinweg bestehen bleiben.

Der Connector aktualisiert das Zugriffstoken automatisch, wenn es abläuft.

Benutzerkonten mit Legacy-Apps (Auth'n'Auth)

Der Connector kann sich mit dem alten Auth'n'Auth-Protokoll von eBay authentifizieren. Wählen Sie dieses Authentifizierungsschema aus, wenn Sie eine ältere Anwendung verwenden, die für die Verwendung von Auth'n'Auth entwickelt wurde.

festlegen AuthScheme Zu AuthNAuth.

Sie müssen eine benutzerdefinierte OAuth-Anwendung erstellen. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Informationen.

Zugriffstoken

Ein OAuthAccessToken ist bei der Authentifizierung über Auth'n'Auth erforderlich. Legen Sie die folgenden Verbindungseigenschaften fest, um die zu erhalten OAuthAccessToken:

• OAuthClientId: Stellen Sie dies auf die App-ID (Client-ID) in Ihrem Schlüsselsatz ein.
• OAuthClientSecret: Setzen Sie dies auf die Cert-ID (Client Secret) in Ihrem Schlüsselsatz.
• DevID: Setzen Sie dies auf die Entwickler-ID aus Ihrem Schlüsselsatz.

Rufen Sie dann gespeicherte Prozeduren auf, um den Token-Austausch abzuschließen:

1. Rufen Sie GetOAuthAuthorizationURL auf gespeicherte Prozedur. Setzen Sie den RuName-Eingang auf eBay Redirect URL, die Sie in Ihren App-Einstellungen angegeben haben. Die gespeicherte Prozedur gibt die URL zum OAuth-Endpoint zurück.

2. Navigieren Sie zu der URL, die die gespeicherte Prozedur in Schritt 1 zurückgegeben hat. Melden Sie sich an und autorisieren Sie die Webanwendung. Nach der Authentifizierung leitet Sie der Browser zur Umleitungs-URI weiter. Dort wird ein Parameter namens sessionid an die Umleitungs-URI angehängt. Notieren Sie sich den Wert dieses Parameters. Wenn Sie die empfohlene https://oauth.cdata.com/oauth/ als Ihre „Authentifizierungs-Akzeptierte URL“, der Wert wird BASE64-codiert und muss vor dem Fortfahren decodiert werden.

3. Rufen Sie den GetOAuthAccessToken gespeicherte Prozedur. Setzen Sie den AuthMode-Eingang auf WEB. Setzen Sie den Eingabeparameter SessionId entweder auf den Wert der „SessionID“ in der Abfrage der Autorisierungs URL oder auf die BASE64-dekodierte Sitzungs-ID aus der Rückruf URL.

Legen Sie die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:

• OAuthClientId: Stellen Sie dies auf die App-ID (Client-ID) in Ihrem Schlüsselsatz ein.

• OAuthClientSecret: Setzen Sie dies auf die Cert-ID (Client Secret) in Ihrem Keyset.

• OAuthAccessToken: Setzen Sie dies auf das von GetOAuthAccessToken zurückgegebene Auth'n'Auth-Token.

• DevID: Setzen Sie dies auf die Entwickler-ID aus Ihrem Schlüsselsatz.

Erstellen einer benutzerdefinierten OAuth-App

Für die Verbindung mit eBay stehen zwei Authentifizierungsmethoden zur Verfügung: die Verwendung eines Tokens, der nur für den Zugriff auf persönliche Daten generiert wird, oder die Verwendung von Tokens, die anderen Benutzern den Zugriff auf ihre eigenen Daten ermöglichen. Für beide Methoden müssen Sie dem eBay Developers Program beitreten.

Registrieren Sie sich und erhalten Sie Ihren Schlüsselsatz

Nach dem Beitritt zum eBay Developers Program können Sie die folgenden Werte aus dem Developer Account Dashboard > Application Keysets Seite.

1. OAuthClientId (App-ID)
2. DevID
3. OAuthClientSecret (Zertifikats-ID)

Erstellen einer OAuth-App

Sie können OAuth-Apps erstellen, die entweder von einem oder mehreren Benutzern verwendet werden sollen. Diese Szenarien werden in den folgenden Abschnitten ausführlich beschrieben.

Einzelbenutzer

Wenn Sie mit Ihrem eigenen Konto arbeiten, befolgen Sie die nachstehenden Schritte, um ein Token über die eBay-Benutzeroberfläche zu generieren:

1. Gehen Sie zu Ihrem Entwicklerkonto-Dashboard und öffnen Sie das User Access Tokens Seite.
2. Wählen Sie die Umfeld für Ihre App aus.
   • Auswählen Production wenn Sie nach echten Artikeln suchen oder echte Artikel auf der Live eBay Site auflisten.
   • Auswählen Sandbox wenn Sie Testlisten in der Sandbox erstellen.
3. Darunter Get a User Token Here, wählen Sie die Authentifizierungsmethode aus, die beim Generieren eines Tokens verwendet werden soll. OAuth-Token sind für alle eBay APIs (RESTful APIs und traditionelle APIs) gültig, während Auth'n'Auth-Token nur für die traditionellen APIs gültig sind.
4. Klicken Sie auf Sign in to Sandbox oder Sign in to Production abhängig von der Umfeld, und melden Sie sich mit den Anmeldeinformationen für Ihr Sandbox- oder Produktions eBay Konto an.

Mehrere Benutzer

eBay implementiert den Authentifizierungsstandard OAuth, mit dem Sie auf Ihre eigenen Daten zugreifen oder anderen Benutzern den Zugriff auf ihre eigenen Daten ermöglichen können.

Führen Sie die folgenden Schritte aus, um den Ablauf der Benutzereinwilligung zu konfigurieren:

1. Gehen Sie zu Ihrem Entwicklerkonto-Dashboard und öffnen Sie das User Access Tokens Seite.
2. Wählen Sie die Umfeld für Ihre App aus.
   • Auswählen Production wenn Sie nach echten Artikeln suchen oder echte Artikel auf der Live eBay Site auflisten.
   • Auswählen Sandbox wenn Sie Testlisten in der Sandbox erstellen.
3. Darunter Your eBay Sign-in Settings im Get a Token from eBay via Your Application Abschnitt, fügen Sie einen neuen RuName (eBay Umleitungs URL) hinzu, indem Sie auf klicken Add eBay Redirect URL oder erweitern Sie die Tab für den RuName, den Sie zur Authentifizierung verwenden.
4. Überprüfen Sie die OAuth Enabled Kontrollkästchen für Ihren RuName. Wenn es nicht aktiviert ist, wird nur die Authentifizierungsmethode Auth'n'Auth unterstützt.
5. Setzen Sie Your auth accepted URL Zu https://oauth.cdata.com/oauth/, da eBay eine sichere Umleitungs-URI (https) erfordert und keine Localhost-URI akzeptiert.
6. Klicken Sie auf Save, um Ihre Änderungen zu speichern.
7. Wählen Sie OAuth, dann klick Test Sign-In um zu bestätigen, dass Sie sich mit Ihrem RuName anmelden können.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des eBay Konnektors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf eBay und verarbeitet den Rest der Abfrage dann im Speicher (clientseitig).

Benutzerdefinierte Ansichten

Mit dem eBay-Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM ItemListing WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft zur Angabe des Speicherorts Ihrer JSON-Konfigurationsdatei. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Definieren von Ansichten mit DDL-Anweisungen

Der Connector kann das Schema auch über DDL-Anweisungen wie CREATE LOCAL VIEW, ALTER LOCAL VIEW und DROP LOCAL VIEW erstellen und ändern.

Erstellen einer Ansicht

Um eine neue Ansicht mit DDL-Anweisungen zu erstellen, geben Sie den Ansichtsnamen und die Abfrage wie folgt an:

CREATE LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers LIMIT 20;

Wenn keine JSON-Datei vorhanden ist, erstellt der obige Code eine. Die Ansicht wird dann in der JSON-Konfigurationsdatei erstellt und ist nun erkennbar. Der Speicherort der JSON-Datei wird durch angegeben UserDefinedViews Verbindungseigenschaft.

Ändern einer Ansicht

Um eine vorhandene Ansicht zu ändern, geben Sie den Namen der vorhandenen Ansicht zusammen mit der neuen Abfrage an, die Sie stattdessen verwenden möchten:

ALTER LOCAL VIEW`[MeinAnsichtsname] `AS SELECT * FROM Customers WHERE TimeModified > '3/1/2020';

Die Ansicht wird dann in der JSON-Konfigurationsdatei aktualisiert.

Löschen einer Ansicht

Um eine vorhandene Ansicht zu löschen, geben Sie den Namen eines vorhandenen Schema neben der neuen Abfrage an, die Sie stattdessen verwenden möchten.

DROP LOCAL VIEW [MyViewName]

Dadurch wird die Ansicht aus der JSON-Konfigurationsdatei entfernt. Sie kann nicht mehr abgefragt werden.

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Der eBay-Connector modelliert Entitäten in der eBay API als Tabellen, Ansichten und gespeicherte Prozeduren. Diese werden in Schema definiert, bei denen es sich um einfache, textbasierte Konfigurationsdateien handelt.

API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Tabellen

Der eBay Connector modelliert Artikellisten in Tabellen, sodass sie einfach abgefragt, aktualisiert und gelöscht werden können. Sie können Artikel in Ihrem eBay-Shop auflisten, indem Sie die gespeicherte Prozedur AddItem aufrufen.

Ansichten

Ansichten sind Tabellen, die nicht geändert werden können. Normalerweise werden schreibgeschützte Daten als Ansichten angezeigt.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen zur Datenquelle. Sie können zum Suchen, Aktualisieren und Ändern von Informationen in der Datenquelle verwendet werden.

AuthNAuth-Einschränkungen

Wenn Sie das Auth'n'Auth-Authentifizierungsschema verwenden, sind die folgenden Tabellen/Ansichten Unavailable:

• API verkaufen

  • Tabellen
    • Aufgaben
  • Ansichten
    • Erfüllungsrichtlinien
    • Zahlungsrichtlinien
    • Rückgaberichtlinien
  • Gespeicherte Prozeduren
    • Datei hochladen
    • Ergebnisdatei abrufen
    • Auftragsaufgabe erstellen
    • Inventaraufgabe erstellen
  • Commerce-API
  • Ansichten
    • KategorieVorschläge
    • Kategorie-Unterbaum
    • Kompatibilitätseigenschaften
    • Kompatibilitätseigenschaftswerte
    • Kategoriebaum
    • Standard-Kategoriebaum-ID
    • Artikelaspekte für Kategorie

Tabellen

Der Connector modelliert die Daten in eBay als Liste von Tabellen in einer relationalen Datenbank, die mit Standard-SQL-Anweisungen abgefragt werden können.

Ebay Anschlusstabellen

Artikelliste

Aktualisieren, löschen und Abfrage Artikellisten für Verkäufer.

Tabellenspezifische Informationen

Wählen

Die folgende Abfrage ruft Verkäuferartikel ab. Standardmäßig gibt diese Abfrage Artikel zurück, die in den letzten 100 Tagen hinzugefügt wurden.

SELECT * FROM ItemListing

ItemListing ist die einzige Tabelle, die ORDER BY unterstützt. Für die Sortierung können nur zwei Spalten verwendet werden: StartTime und EndTime. Die folgende Abfrage ruft Elemente ab, die innerhalb der angegebenen Zeit enden, sortiert nach dem Element, das am frühesten endet.

SELECT * FROM ItemListing WHERE EndTimeFrom = '2016-01-25' AND EndTimeTo = '2016-02-05' ORDER BY EndTime

EINFÜGEN

Die gespeicherte Prozedur AddItem bietet die Funktion zum Hinzufügen eines neuen Elements.

Aktualisieren

Die für ein Update erforderlichen Eingaben hängen vom Typ des Artikels und seiner Kategorie ab. Bei einem Update müssen mindestens die ItemId und eine Eigenschaft des Artikels angegeben werden.

UPDATE ItemListing SET Title = 'My Awesome Item' WHERE ItemId = '123456789'

Nachdem ein Artikel in einer Auflistung mit mehreren Mengen verkauft wurde, können Verkäufer die Werte in den Feldern Titel, Primärkategorie, Sekundärkategorie, Auflistungsdauer und Auflistungstyp nicht mehr ändern. Alle anderen Felder können jedoch weiterhin bearbeitet werden.

Löschen

Um ein Element zu löschen, müssen die ItemId und der Endgrund angegeben werden.

DELETE FROM ItemListing WHERE ItemId = '123456789' AND  EndingReason = 'LostOrBroken'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Artikelvariationen

Artikelvarianten sind mehrere ähnliche (aber nicht identische) Artikel in einer einzigen Festpreisliste. Eine T-Shirt-Liste könnte beispielsweise mehrere Artikel derselben Marke enthalten, die sich in Farbe und Größe unterscheiden. Jede Variante würde eine Kombination aus einer dieser Farben und Größen angeben. Jede Variante kann eine andere Menge und einen anderen Preis haben. Sie können mehrere Artikel einer Variante gleichzeitig kaufen. (Das heißt, eine Bestellposition kann mehrere Artikel einer einzigen Variante enthalten.)

Tabellenspezifische Informationen

Wählen

Eine Artikel-ID muss angegeben werden, um Variationen für den Artikel zu erhalten, den diese ID darstellt.

SELECT * FROM ItemVariations WHERE ItemId = '110187147205'

Einfügen

Die zum Einfügen erforderlichen Felder sind ItemId, VariationSpecificsAggregate, StartPrice und Quantity. VariationSpecificsAggregate sollte Variationsdetails enthalten, die im XML-Format strukturiert sind. Beispielsweise fügt das folgende VariationSpecificsAggregate ein großes blaues Element hinzu:

<NameValueList>
  <Name>Color</Name>
  <Value>Blue</Value>
</NameValueList>
<NameValueList>
  <Name>Size</Name>
  <Value>L</Value>
</NameValueList>

Die folgende Abfrage fügt eine Variante eines großen blauen Artikels mit einem Startpreis von 15 und einer Menge von 100 hinzu.

INSERT INTO ItemVariations (ItemId, VariationSpecificsAggregate, Quantity, StartPrice) VALUES ('110188946596', '<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>', '100', '15')

Aktualisieren

ItemId und VariationSpecificsAggregate sind zum Aktualisieren einer Variante erforderlich. Optional können weitere Details für Varianten angegeben werden, wie StartPrice und Quantity. VariationSpecificsAggregate sollte im XML-Format vorliegen und alle Einzelheiten enthalten, die eine Variante identifizieren.

UPDATE ItemVariations SET Quantity = '5' WHERE ItemId = '110188946596' AND VariationSpecificsAggregate = '<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'

Löschen

ItemId und VariationSpecificsAggregate sind zum Löschen einer Variante erforderlich.

DELETE FROM ItemVariations WHERE ItemId = '110188946596' AND VariationSpecificsAggregate = '<NameValueList><Name>Color</Name><Value>Blue</Value></NameValueList><NameValueList><Name>Size</Name><Value>L</Value></NameValueList>'

Spalten

Aufgaben

Ruft alle Aufgaben für den Marktplatz ab, den Sie mit dem Abfrage MarketplaceId angeben.

Wählen

FeedType ist ein erforderlicher Filter in der Select Abfrage. Sie können der folgenden Abfrage folgen, um die erforderlichen Werte über SQL zu erhalten:

SELECT * FROM`[Aufgaben] `WHERE FeedType = 'LMS_ADD_ITEM'

Einige der Felder sind mit dem Suffix benannt Aggr. Diese Felder zeigen den Inhalt des gleichnamigen JSON-Tags an, der vom API Endpoint zurückgegeben wird.

Einfügen

In der Insert Abfrage werden FeedType, MarketplaceID und SchemaVersion benötigt. Sie können der folgenden Abfrage folgen, um die erforderlichen Werte über SQL zu erhalten:

INSERT INTO`[Aufgaben] `(FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Ansichten

Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten sind jedoch schreibgeschützt.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle.

Ebay Connector-Ansichten

Bieter

Fragen Sie eBay Benutzer ab, die auf ein bestimmtes Angebot geboten haben, unabhängig davon, ob das Angebot beendet wurde.

Tabellenspezifische Informationen

Wählen

Die einzigen unterstützten Spalten zum Filtern sind ItemId und ListMode. Zum Abrufen von Daten aus dieser Ansicht muss eine ItemId angegeben werden.

SELECT * FROM Bidders WHERE ItemId = '1234567'

SELECT * FROM Bidders WHERE ItemId = '1234567' AND ListMode = 'EndedListing'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kategorien

eBay Kategorien abfragen.

Tabellenspezifische Informationen

Wählen

Die einzigen zum Filtern unterstützten Spalten sind CategorySiteId, LevelLimit und CategoryParentId.

SELECT * FROM Categories.

Mit der folgenden Abfrage können Sie weitere Informationen zu einer bestimmten Kategorie und ihren Unterkategorien abrufen:

SELECT * FROM Categories WHERE LevelLimit = '2' AND CategoryParent = '267'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KategorieFeatures

Fragen Sie die von den eBay Kategorien unterstützten Einstellungen ab.

Tabellenspezifische Informationen

Wählen

Die einzigen zum Filtern unterstützten Spalten sind CategoryId, LevelLimit, AllFeaturesForCategory und FeatureId. Wenn keine CategoryId angegeben ist, werden alle Features für Kategorien der obersten Ebene zurückgegeben.

SELECT * FROM CategoryFeatures WHERE LevelLimit = '2' AND CategoryId = '277'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Kategorie-Unterbaum

Rufen Sie alle Knoten der Kategoriebaumhierarchie (des Unterbaums) unterhalb einer angegebenen Kategorie in einem angegebenen Kategoriebaum ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. CategoryTreeId und CategoryId sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.
• CategoryId unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM CategorySubtree WHERE CategoryTreeId = 0 AND CategoryId = 11450

Spalten

KategorieVorschläge

Gibt ein Array vorgeschlagener Kategorien zurück, die laut eBay den Schlüsselwörtern entsprechen, die einen Artikel beschreiben.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. CategoryTreeId und Q sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.
• Q unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM CategorySuggestions WHERE CategoryTreeId = 0 AND Q = 'iphone'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

KategorieBaum

Rufen Sie den vollständigen Kategorienbaum ab, der einer angegebenen Kategorienbaum-ID entspricht.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die CategoryTreeId ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM CategoryTree WHERE CategoryTreeId = 0

Spalten

Kompatibilitätseigenschaften

Rufen Sie eine Reihe von Teilekompatibilitätsaspekten ab, die zur Beschreibung kompatibler Fahrzeuge verwendet werden.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. CategoryTreeId und CategoryId sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.
• CategoryId unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM CompatibilityProperties WHERE CategoryTreeId = 101 AND CategoryId = 33559

Spalten

Kompatibilitätseigenschaftswerte

Rufen Sie ein Array von Teilekompatibilitätsaspektwerten ab, die zur Beschreibung kompatibler Fahrzeuge verwendet werden.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. CategoryTreeId, CategoryId und CompatibilityProperty sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.
• CategoryId unterstützt den '='-Vergleich.
• CompatibilityProperty unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM CompatibilityPropertyValues WHERE CategoryTreeId = 101 AND CategoryId = 33559 AND CompatibilityProperty = 'Trim'

Spalten

Länder

Listet den Ländercode und den zugehörigen Namen der vom eBay-System unterstützten Länder auf, unabhängig von der in der Anfrage angegebenen Site.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Währungen

Fragen Sie die unterstützten Währungen bei eBay ab.

Tabellenspezifische Informationen

Wählen

Gibt alle unterstützten Währungen zurück. Zum Filtern werden keine Spalten unterstützt.

SELECT * FROM Currencies

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Standard-Kategoriebaum-ID

Rufen Sie die Standard-Kategoriebaumreferenz für einen bestimmten eBay Marktplatz ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Die MarketplaceId ist erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• MarketplaceId unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM DefaultCategoryTreeId WHERE MarketplaceId = 'EBAY_US'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Erfüllungsrichtlinien

Ruft alle Erfüllungsrichtlinien ab, die für den Marktplatz konfiguriert sind, den Sie mit dem Abfrage MarketplaceId angeben.

Wählen

MarketplaceId ist ein erforderlicher Filter in der Select Abfrage. Sie können der folgenden Abfrage folgen, um die erforderlichen Werte über SQL zu erhalten:

SELECT * FROM FulfillmentPolicies WHERE MarketplaceId = 'EBAY_US'

Einige der Felder sind mit dem Suffix benannt Aggr. Diese Felder zeigen den Inhalt des gleichnamigen JSON-Tags an, der vom API Endpoint zurückgegeben wird.

Spalten

Höchstbietender

Fragen Sie den Höchstbietenden der eBay-Benutzer ab, die auf ein bestimmtes Angebot geboten haben, unabhängig davon, ob das Angebot beendet wurde.

Tabellenspezifische Informationen

Wählen

Die einzigen unterstützten Spalten zum Filtern sind ItemId und ListMode. Zum Abrufen von Daten aus dieser Ansicht muss eine ItemId angegeben werden.

SELECT * FROM HighestBidder WHERE ItemId = '1234567'

SELECT * FROM HighestBidder WHERE ItemId = '1234567' AND ListMode = 'EndedListing'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Artikelaspekte für Kategorie

Rufen Sie eine Reihe von Aspekten ab, die für die Beschreibung von Elementen in einer bestimmten Kategorie geeignet sind.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die eBay API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. CategoryTreeId und CategoryId sind erforderlich, um eine Anfrage zu stellen, und der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• CategoryTreeId unterstützt den '='-Vergleich.
• CategoryId unterstützt den '='-Vergleich.

Beispiel:

SELECT * FROM ItemAspectsForCategory WHERE CategoryTreeId = 101 AND CategoryId = 67726

Spalten

Artikelkompatibilitätsliste

Kompatibilitätskategorien und mögliche Kompatibilitätswerte für einen bestimmten Artikel abfragen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

ArtikelVersand

Fragen Sie Details zu einem oder mehreren Artikeln ab, für die der Verkäufer berechnete Versandkosten angeboten hat, wie z. B. Paketgröße, Gewicht und Verpackungs-/Bearbeitungskosten.

Tabellenspezifische Informationen

Wählen

Um Daten aus dieser Ansicht abzurufen, müssen die Filter DestinationCountryCode und ItemId angegeben werden. Außerdem kann der Filter QuantitySold verwendet werden, dies ist jedoch optional.

SELECT * FROM ItemShipping WHERE ItemId = '110177686055' AND DestinationCountryCode = 'US'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Artikelspezifikationen

Artikeldetails für einen bestimmten Artikel abfragen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Artikeltransaktionen

Fragen Sie Bestellpositionsinformationen (Transaktionsinformationen) für ein bestimmtes Angebot ab. Bei Auktionsangeboten werden Bestellpositionen erst erstellt, wenn die Auktion mit einem Höchstbietenden endet oder wenn die Sofort-Kaufen-Funktion für das Angebot aktiviert ist und vom Käufer zum Kauf des Artikels verwendet wird. Bei Festpreisangeboten werden Bestellpositionen erstellt, nachdem sich ein Käufer zum Kauf der Artikel verpflichtet hat.

Tabellenspezifische Informationen

Wählen

Um Transaktionsinformationen abzurufen, muss die Spalte „ItemId“ angegeben werden.

Alle Transaktionen abrufen, die sich auf einen bestimmten Artikel beziehen:

SELECT * FROM ItemTransactions WHERE ItemId = '012345678901'

Filtern Sie die Anzahl der zurückgegebenen Transaktionen, indem Sie die Anzahl der Tage in der Vergangenheit angeben:

SELECT * FROM ItemTransactions WHERE ItemId = '012345678901' AND NumberOfDays = '25'

Informationen zu einer bestimmten Transaktion abrufen, die für einen bestimmten Artikel getätigt wurde:

SELECT * FROM ItemTransactions WHERE ItemId = '012345678901' AND TransactionId = '0'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

MeistgeseheneArtikel

Suchen Sie nach Artikeln mit den höchsten Beobachtungszahlen für die gesamte Site oder für eine bestimmte Kategorie. Die Top-Artikel werden anhand der Gesamtzahl der Beobachtungen vom Vortag ermittelt. Die Rangfolge der am häufigsten beobachteten Artikel wird anhand der neuesten Informationen zur Beobachtungszahl berechnet.

Tabellenspezifische Informationen

Wählen

Die einzigen Spalten, die zum Filtern verwendet werden können, sind CategoryId, AffiliateCustomId, AffiliateNetworkId und AffiliateTrackingId. Diese Filter sind optional.

SELECT * FROM MostWatchedItems

SELECT * FROM MostWatchedItems WHERE CategoryId = '277'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

BestellenZahlungen

Frage alle Zahlungen der Bestellungen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur Zahlungsdetails von Bestellungen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Zahlungsdetails von Bestellungen, die älter als 90 Tage sind, können durch Angabe der Bestell-ID abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der OrderPayments-Ansicht:

SELECT * FROM OrderPayments WHERE ModTimeFrom = '2/22/2018'

SELECT * FROM OrderPayments WHERE NumberOfDays = '30'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Bestellungen

Frage alle Bestellungen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur Bestellungen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Bestellungen, die älter als 90 Tage sind, können durch Angabe der Bestell-ID abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der Auftragsansicht:

SELECT * FROM Orders WHERE OrderId = '110276240386-28854859001'

SELECT * FROM Orders WHERE OrderId IN ('110276240386-28854859001', '110277719772-28859911001')

SELECT * FROM Orders WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'

SELECT * FROM Orders WHERE OrderStatus = 'Active'

SELECT * FROM Orders WHERE NumberOfDays = '26'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

BestellungVersand

Fragen Sie die Versanddetails der Bestellungen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur die Versanddetails von Bestellungen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Versanddetails von Bestellungen, die älter als 90 Tage sind, können durch Angabe der Bestell-ID abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der OrderShipping-Ansicht:

SELECT * FROM OrderShipping WHERE NumberOfDays = '30'

SELECT * FROM OrderShipping WHERE CreateTimeFrom = '2018-02-10' AND CreateTimeTo = '2018-03-16'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Zahlungsbedingungen

Ruft alle Zahlungsrichtlinien ab, die für den Marktplatz konfiguriert sind, den Sie mit dem Abfrage MarketplaceId angeben.

Wählen

MarketplaceId ist ein erforderlicher Filter in der Select Abfrage. Sie können der folgenden Abfrage folgen, um die erforderlichen Werte über SQL zu erhalten:

SELECT * FROM PaymentPolicies WHERE MarketplaceId = 'EBAY_US'

Einige der Felder sind mit dem Suffix benannt Aggr. Diese Felder zeigen den Inhalt des gleichnamigen JSON-Tags an, der vom API Endpoint zurückgegeben wird.

Spalten

Rückgaberichtlinien

Ruft alle Rückgaberichtlinien ab, die für den Marktplatz konfiguriert sind, den Sie mit dem Abfrage MarketplaceId angeben.

Wählen

MarketplaceId ist ein erforderlicher Filter in der Select Abfrage. Sie können der folgenden Abfrage folgen, um die erforderlichen Werte über SQL zu erhalten:

SELECT * FROM ReturnPolicies WHERE MarketplaceId = 'EBAY_US'

Einige der Felder sind mit dem Suffix benannt Aggr. Diese Felder zeigen den Inhalt des gleichnamigen JSON-Tags an, der vom API Endpoint zurückgegeben wird.

Spalten

VersandSpediteure

Fragen Sie nach Versandunternehmen, die von der angegebenen Site unterstützt werden.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

VersandKategorien

Eine für die Site unterstützte Versanddienstkategorie.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Versandstandorte

Listet die Regionen und Standorte auf, die von den Versanddiensten von eBay unterstützt werden. Gibt alle von eBay unterstützten Versandstandorte zurück, unabhängig von der in der Anfrage angegebenen Site.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Versanddienste

Fragen Sie die von der angegebenen eBay Site unterstützten Versanddienste ab.

Tabellenspezifische Informationen

Wählen

Die folgende Abfrage ruft alle verfügbaren Versanddienste ab. Für diese Ansicht gibt es keine unterstützten Filter.

SELECT * FROM ShippingServices

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Seiten

Listet alle verfügbaren eBay-Sites und die zugehörigen SiteID-Nummern auf.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Vorgeschlagene Kategorien

Abfrage der eBay Liste der Kategorien mit der höchsten Anzahl an Einträgen.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

MeistverkaufteProdukte

Fragen Sie Ihre meistverkauften Produkte bei eBay ab.

Tabellenspezifische Informationen

Wählen

Die einzigen Spalten, die zum Filtern verwendet werden können, sind AffiliateCustomId, AffiliateNetworkId und AffiliateTrackingId. Diese Filter sind optional.

SELECT * FROM TopSellingProducts

SELECT * FROM TopSellingProducts WHERE AffiliateCustomId = '12345'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Transaktionsverknüpfte Elemente

Fragen Sie alle verknüpften Positionen der Transaktionen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur verknüpfte Positionen von Transaktionen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Verknüpfte Positionen der Transaktionen in Bestellungen, die älter als 90 Tage sind, können durch Angabe von OrderIds abgerufen werden.

Spalten

Transaktionszahlungen

Fragen Sie alle Zahlungen der Transaktionen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur Zahlungen der Transaktionen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Zahlungen der Transaktionen in Bestellungen, die älter als 90 Tage sind, können durch Angabe von OrderIds abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der TransactionPayments-Ansicht:

SELECT * FROM TransactionPayments WHERE OrderRole = 'Seller'

SELECT * FROM TransactionPayments WHERE OrderId = '110277719772-28859911001'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Transaktionsrückerstattungen

Fragen Sie alle Rückerstattungen der Transaktionen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur Rückerstattungen von Transaktionen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Rückerstattungen der Transaktionen in Bestellungen, die älter als 90 Tage sind, können durch Angabe von OrderIds abgerufen werden.

Spalten

Transaktionen

Frage alle Transaktionen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur Transaktionen von Bestellungen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Transaktionen von Bestellungen, die älter als 90 Tage sind, können durch Angabe der Bestell-ID abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der Transaktionsansicht.

SELECT * FROM Transactions WHERE OrderRole = 'Seller'

SELECT * FROM Transactions WHERE OrderId = '110276240386-28854859001'

SELECT * FROM Transactions WHERE CreateTimeFrom = '2/10/2018' AND CreateTimeTo = '3/16/2018'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

TransaktionVersand

Fragen Sie die Versanddetails der Transaktionen ab, bei denen der authentifizierte Benutzer entweder der Käufer oder der Verkäufer ist. Standardmäßig werden nur die Versanddetails der Transaktionen zurückgegeben, die in den letzten 90 Tagen getätigt wurden. Versanddetails der Transaktionen in Bestellungen, die älter als 90 Tage sind, können durch Angabe von OrderIds abgerufen werden.

Spezifische Informationen anzeigen

Wählen

Beispiele für die Abfrage der TransactionShipping-Ansicht:

SELECT * FROM TransactionShipping WHERE ModTimeFrom = '2/22/2018' AND ModTimeTo = '3/4/2018'

SELECT * FROM TransactionShipping WHERE OrderId = '110277719772-28859911001'

SELECT * FROM TransactionShipping WHERE OrderId IN ('110277719772-28859911001', '110276240386-28854859001')

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Gespeicherte Prozeduren

Gespeicherte Prozeduren sind funktionsähnliche Schnittstellen, die die Funktionalität des Connectors über einfache SELECT/INSERT/UPDATE/DELETE-Operationen mit eBay hinaus erweitern.

Gespeicherte Prozeduren akzeptieren eine Liste von Parametern, führen ihre beabsichtigte Funktion aus und geben dann alle relevanten Antwortdaten von eBay zurück, zusammen mit einer Angabe, ob die Prozedur erfolgreich war oder fehlgeschlagen ist.

Gespeicherte Prozeduren für den eBay Connector

Artikel hinzufügen

Erstellen und veröffentlichen Sie eine neue Artikelliste auf einer eBay-Site.

Gespeicherte Prozedurspezifische Informationen

Nach der erfolgreichen Erstellung einer Artikelliste wird in der Antwort eine Artikel-ID zusammen mit den geschätzten Gebühren für die Auflistung des Artikels zurückgegeben. Nachdem Sie einen Artikel hinzugefügt haben, können Sie die ItemListing-Tabelle zum Aktualisieren, Löschen und Abfrage verwenden.

Zum Hinzufügen eines Artikels sind folgende Eingaben erforderlich: Titel, Beschreibung, Kategorie-ID, Startpreis, Zustands-ID, Land, Währung, Maximale Versandzeit, Angebotsdauer, Angebotstyp, Zahlungsmethode, PayPal-E-Mail-Adresse, Menge, Standort und Option „Akzeptierte Rücksendungen“.

Sie müssen außerdem mehrere Eingaben machen, die zur Auswahl einer Versandart erforderlich sind: Pauschal oder Berechnet. Für beide Versandarten muss ein Versanddienst angegeben werden.

Einen Artikel hinzufügen

Mit dem nachstehenden Verfahren können Sie die erforderlichen Werte abrufen und ein Element über SQL hinzufügen:

1. Wählen Sie in der Ansicht „Kategorien“ eine Kategorie der obersten Ebene aus, z. B. „Bücher“. Sie können die folgende Abfrage verwenden:

   SELECT * FROM Categories
   

2. Wählen Sie in der Ansicht „Kategorien“ eine Unterkategorie aus, z. B. Belletristik und Literatur. Zum Hinzufügen eines Artikels ist eine Unterkategorie-ID erforderlich. Sie können eine Abfrage wie die folgende verwenden:

   SELECT * FROM Categories WHERE CategoryParentId = '267'
   

3. Verwenden Sie die Ansicht „ShippingServices“, um einen Versanddienst auszuwählen. Der Wert der Spalte „ValidForSellingFlow“ muss „true“ sein. Andernfalls ist diese bestimmte Versanddienstoption nicht mehr gültig und kann Käufern nicht über eine Auflistung angeboten werden.

Pauschalversand auswählen

Für die Versandart „Pauschal“ sind folgende Eingaben erforderlich: Versandart, Versanddienst, Versanddienstpriorität und Versanddienstkosten.

Auswählen von CalculatedShipping

Die berechnete Versandart erfordert zusätzliche Informationen zu den Paketstatistiken. Für diese Versandart sind die folgenden Eingaben erforderlich: Versandart, Hauptgewicht, Nebengewicht, Ursprungspostleitzahl, Versanddienst und Versanddienstpriorität.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für das Verfahren.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Um mehrere Instanzen eines indexierten Parameters wie diesen einzugeben, führen Sie Folgendes aus:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

In der folgenden Tabelle sind indexierte Parameter mit einem gekennzeichnet #-Zeichen am Ende ihrer Namen.

Eingang

Ergebnissatzspalten

KomplettVerkauf

Erledigen Sie nach der Erstellung einer Einzel- oder Mehrfachbestellung verschiedene Aufgaben. Schließen Sie beispielsweise einen Verkauf ab und hinterlassen Sie Feedback.

Eingang

Ergebnissatzspalten

Inventaraufgabe erstellen

Dieses Verfahren erstellt eine inventarbezogene Download-Aufgabe für einen angegebenen Feedtyp mit optionalen Filterkriterien.

Eingang

Ergebnissatzspalten

Auftragserstellungsaufgabe erstellen

Dieses Verfahren erstellt eine Auftragsdownload-Aufgabe mit Filterkriterien für den Auftragsbericht.

Eingang

Ergebnissatzspalten

GetOAuthAccessToken

Ruft den OAuth-Zugriffstoken von eBay ab.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationURL

Ruft die eBay Autorisierungs URL ab. Greifen Sie in einem Internetbrowser auf die in der Ausgabe zurückgegebene URL zu. Dadurch wird das Zugriffstoken angefordert, das als Teil der Verbindungszeichenfolge zu eBay verwendet werden kann.

Eingang

Ergebnissatzspalten

Ergebnisdatei abrufen

Dieses Verfahren ruft die generierte Datei ab, die mit der angegebenen Aufgaben-ID verknüpft ist. Die Antwort auf diesen Aufruf ist eine komprimierte oder unkomprimierte CSV-, XML- oder JSON-Datei mit der entsprechenden Dateierweiterung (z. B. csv.gz).

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert den OAuth-Zugriffstoken, der für die Authentifizierung bei eBay verwendet wird.

Eingang

Ergebnissatzspalten

Benutzernotizen festlegen

Fügen Sie „Mein eBay“ -Notizen für Artikel hinzu, ersetzen und löschen Sie sie, die in den Bereichen „Mein eBay - Verkaufen“ und „Kaufen“ verfolgt werden.

Indizierte Parameter erleichtern die Bereitstellung mehrerer Instanzen eines einzelnen Parameters als Eingaben für das Verfahren.

Angenommen, es gibt einen Eingabeparameter mit dem Namen Param#. Um mehrere Instanzen eines indexierten Parameters wie diesen einzugeben, führen Sie Folgendes aus:

EXEC ProcedureName Param#1 = "value1", Param#2 = "value2", Param#3 = "value3"

In der folgenden Tabelle sind indexierte Parameter mit einem gekennzeichnet #-Zeichen am Ende ihrer Namen.

Eingang

Ergebnissatzspalten

Datei hochladen

Lädt eine Datei auf das eBay-Konto hoch.

Gespeicherte Prozedurspezifische Informationen

Dieses Verfahren verknüpft die angegebene Datei mit der angegebenen Task-ID und lädt die Eingabedatei hoch. Nachdem die Datei hochgeladen wurde, beginnt die Verarbeitung der Datei.

Zum Hochladen einer Datei sind folgende Eingaben erforderlich: TaskID und FilePath.

Hochladen einer Datei

Um einen erfolgreichen Datei-Upload durchzuführen, können Sie die folgende Vorgehensweise befolgen:

1. Verwenden Sie die Aufgabentabelle, um eine neue Aufgabe zu erstellen. Sie können die folgende Abfrage verwenden:

   INSERT INTO`[Aufgaben] `(FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')
   

2. Sie können die neu generierte TaskID entweder aus den generierten Schlüsseln abrufen oder indem Sie zur Auswahl erneut die Tasks-Tabelle verwenden.

       Statement stat = conn.createStatement();
       stat.executeUpdate("INSERT INTO`[Aufgaben] `(FeedType, MarketplaceID, SchemaVersion) VALUES ('LMS_ADD_ITEM', 'EBAY_US', '1149')", Statement.RETURN_GENERATED_KEYS);
       ResultSet rs = stat.getGeneratedKeys();
       while (rs.next()) {
         for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
           System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
         }
   }
   

   oder

   SELECT * FROM`[Aufgaben] `WHERE FeedType = 'LMS_ADD_ITEM' AND CreationDate > '2021-11-16 09:19:00'
   

3. Verwenden Sie diese Aufgaben-ID zusammen mit dem Dateipfad der hochzuladenden Datei als Eingabe in der gespeicherten Prozedur UploadFile.

       CallableStatement callableStatement = conn.prepareCall("UploadFile");
       callableStatement.setString("TaskID", "task-5-1XXXXX");
       callableStatement.setString("FilePath", "C:\\Users\\User\\Documents\\upload.csv");
   
       boolean ret = callableStatement.execute();
       if (!ret) {
         int count = callableStatement.getUpdateCount();
         if (count != -1) {
           System.out.println("Affected rows: " + count);
         }
       } else {
         ResultSet rs = callableStatement.getResultSet();
         while (rs.next()) {
           for (int i = 1; i <= rs.getMetaData().getColumnCount(); i++) {
             System.out.println(rs.getMetaData().getColumnName(i) + "=" + rs.getString(i));
           }
         }
   }
   

4. Dann sollte Ihre Datei verarbeitet werden. Um den Status zu verfolgen, können Sie eine SELECT Abfrage in der Tasks-Tabelle mit der TaskID ausführen und die Spalte „Status“ überprüfen.

   SELECT Status FROM`[Aufgaben] `WHERE TaskID = '{Generated Task ID}'
   

Eingang

Ergebnissatzspalten

Systemtabellen

Sie können die in diesem Abschnitt beschriebenen Systemtabellen Abfrage, um auf Schema, Informationen zur Datenquellenfunktionalität und Statistiken zu Operation Charge.

Schematabellen

Die folgenden Tabellen geben Datenbankmetadaten für eBay zurück:

• sys_catalogs: Listet die verfügbaren Datenbanken auf.
• sys_schemas: Listet die verfügbaren Schemata auf.
• sys_tables: Listet die verfügbaren Tabellen und Ansichten auf.
• sys_tablecolumns: Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.
• sys_procedures: Beschreibt die verfügbaren gespeicherten Prozeduren.
• sys_procedureparameters: Beschreibt Parameter gespeicherter Prozeduren.
• sys_keycolumns: Beschreibt die Primär- und Fremdschlüssel.
• sys_indexes: Beschreibt die verfügbaren Indizes.

Datenquellentabellen

Die folgenden Tabellen enthalten Informationen dazu, wie eine Verbindung zur Datenquelle hergestellt und diese Abfrage wird:

• sys_connection_props: Gibt Informationen zu den verfügbaren Verbindungseigenschaften zurück.
• sys_sqlinfo: Beschreibt die SELECT-Abfragen, die der Connector an die Datenquelle auslagern kann.

Abfrageinformationstabellen

Die folgende Tabelle gibt Abfrage für Datenänderungsabfragen zurück:

• Systemidentität: Gibt Informationen zu Charge oder einzelnen Updates zurück.

Sys_catalogs

Listet die verfügbaren Datenbanken auf.

Die folgende Abfrage ruft alle durch die Verbindungszeichenfolge ermittelten Datenbanken ab:

SELECT * FROM sys_catalogs

Spalten

Sys_schemas

Listet die verfügbaren Schemas auf.

Die folgende Abfrage ruft alle verfügbaren Schemata ab:

SELECT * FROM sys_schemas

Spalten

Sys_tables

Listet die verfügbaren Tabellen auf.

Die folgende Abfrage ruft die verfügbaren Tabellen und Ansichten ab:

SELECT * FROM sys_tables

Spalten

Sys_tablecolumns

Beschreibt die Spalten der verfügbaren Tabellen und Ansichten.

Die folgende Abfrage gibt die Spalten und Datentypen für die ItemListing-Tabelle zurück:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='ItemListing'

Spalten