Plattformspezifische Daten für eBay |
  
|
Plattformspezifische Daten für eBay |
|
Die XML-Struktur, welche die spezifischen Filter-Daten für eBay-Nachrichten enthält, muss als Kindelement in das Element request in den Request-Daten von fetchMessages eingebettet sein. Sie besitzt folgende Struktur: |
<ebay_message_filter> <mandator_id filter_method="=" filter_value="1" /> <account_ids filter_method="IN"> <filter_values> <filter_value>855350</filter_value> </filter_values> </account_ids> <created_at from_date="2014-01-01T00:00:00+01:00" to_date="2014-07-31T00:00:00+02:00" allow_null="false" /> <changed_at from_date="2014-01-01T00:00:00+01:00" to_date="2014-07-31T00:00:00+02:00" allow_null="false" /> <read filter_value="false" allow_null="false" /> <replied filter_value="false" allow_null="false" /> </ebay_message_filter> |
Name |
Beschreibung |
Anz. |
Typ |
sonstiges |
ebay_message_filter |
Root-Element des plattformspezifischen Nachrichten-Filters. |
1 |
Element |
|
mandator_id |
Schränkt die Ergebnismenge der Abfrage auf die angegebenen Mandanten-ID ein. |
0..1 |
Element |
|
filter_method |
Attribut von mandator_id. Legt das Verhalten des Mandanten-Filters fest. |
0..1 |
dateTime |
Fester Wert: „=“ |
filter_value |
Attribut von mandator_id. Legt den Filterwert des Mandanten-Filters fest. |
0..1 |
dateTime |
|
account_ids |
Schränkt die Ergebnismenge der Abfrage auf die angegebenen Account-IDs ein. |
0..1 |
Element |
|
filter_method |
Attribut von account_ids. Legt das Verhalten des Account-Filters fest. |
1 |
string |
Fester Wert: „IN“ |
filter_values |
Element von account_ids. Fasst ein oder mehrere Werte zusammen. |
1 |
Element |
|
filter_value |
Element von filter_values. Legt den Wert fest nach dem gefiltert werden soll. Es kann auch gleichzeitig nach mehreren Werten gefiltert werden. Dafür müssen mehrere filter_value-Elemente angegeben werden. |
1..n |
integer |
|
created_at |
Schränkt die Ergebnismenge der Abfrage nach dem Erstelldatum der Nachricht ein. |
0..1 |
Element |
|
from_date |
Attribut von created_at. Selektiert alle Nachrichten, die ab einschließlich des angegebenen Datums erstellt wurden. |
0..1 |
Element |
|
to_date |
Attribut von created_at. Selektiert alle Nachrichten, die bis einschließlich des angegebenen Datums erstellt wurden. |
0..1 |
dateTime |
|
allow_null |
Attribut von created_at. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden. |
0..1 |
dateTime |
|
filter_method |
Attribut von created_at. Wird verwendet um die Ergebnismenge ausschließlich nach NULL/NOT NULL-Werten einzuschränken |
0..1 |
string |
Feste Werte: „IS“ | „IS NOT“ |
filter_value |
Attribut von created_at. Wird verwendet um die Ergebnismenge ausschließlich nach NULL/NOT NULL-Werten einzuschränken |
0..1 |
string |
Fester Wert: „NULL“ |
changed_at |
Schränkt die Ergebnismenge der Abfrage nach dem Änderungsdatum der Nachricht ein. |
0..1 |
Element |
|
from_date |
Attribut von changed_at. Selektiert alle Nachrichten, die ab einschließlich des angegebenen Datums erstellt wurden. |
0..1 |
Element |
|
to_date |
Attribut von changed_at. Selektiert alle Nachrichten, die bis einschließlich des angegebenen Datums erstellt wurden. |
0..1 |
dateTime |
|
allow_null |
Attribut von changed_at. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden. |
0..1 |
dateTime |
|
filter_method |
Attribut von changed_at. Wird verwendet um die Ergebnismenge ausschließlich nach NULL/NOT NULL-Werten einzuschränken |
0..1 |
string |
Feste Werte: „IS“ | „IS NOT“ |
filter_value |
Attribut von changed_at. Wird verwendet um die Ergebnismenge ausschließlich nach NULL/NOT NULL-Werten einzuschränken |
0..1 |
string |
Fester Wert: „NULL“ |
read |
Schränkt die Ergebnismenge der Abfrage auf das Gelesen-Feld ein. |
0..1 |
Element |
|
filter_value |
Attribut von read. Legt den Filterwert des Gelesen-Filters fest. |
1 |
boolean |
|
allow_null |
Attribut von read. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden. |
0..1 |
boolean |
|
replied |
Schränkt die Ergebnismenge der Abfrage auf das Geantwortet-Feld ein. |
0..1 |
Element |
|
filter_value |
Attribut von replied. Legt den Filterwert des Geantwortet-Filters fest. |
1 |
boolean |
|
allow_null |
Attribut von replied. Legt fest ob auch Null-Werte in der Ergebnismenge berücksichtigt werden. |
0..1 |
boolean |
<ebay_message> <message_id>3942706</message_id> <account> <account_id>22125</account_id> <account_identifier>Testaccount</account_identifier> </account> <sender>Benutzername</sender> <recipient>Testaccount</recipient> <subject>Betreff: Anforderung zur Auftragsänderung...</subject> <internal_message_id>53672063281</internal_message_id> <external_message_id>756981517018</external_message_id> <replied>true</replied> <read_internal>false</read_internal> <message_type>ResponseToASQQuestion</message_type> <message_question_type>General</message_question_type> <message_specifics> <message_member> <display_public>false</display_public> <current_price>5.00</current_price> <sender_email>xyz@members.ebay.de</sender_email> <offer_start_date>2014-01-27T09:48:41.000+01:00</offer_start_date> <offer_modified>2014-01-27T16:24:03.000+01:00</offer_modified> </message_member> <message_my_message> <folder_id>0</folder_id> <high_priority>false</high_priority> <flagged>false</flagged> <read>true</read> <response_enabled>true</response_enabled> <response_url>https://contact.ebay.de/ws/eBayISAPI.dll?M2MContact&item=...</response_url> <send_to_name>metacross</send_to_name> <receive_date>2014-01-27T15:49:01.000+01:00</receive_date> <expiry_date>2015-01-27T15:49:00.000+01:00</expiry_date> </message_my_message> </message_specifics> <message_body> <content>plain text</content> <plain_text> <![CDATA[ <html> content </html> ]]> </plain_text> <message_only>Eigentliche Nachricht</message_only> </message_body> <external_offer_number>201027409827</external_offer_number> <offer_end_time>2014-01-27T09:59:22.000+01:00</offer_end_time> <offer_title>Speed4Trade-Kugelschreiber</offer_title> </ebay_message> |
Name |
Beschreibung |
Anz. |
Typ |
sonstiges |
ebay_message |
Wrapper-Element, das die Daten einer eBay-Nachricht zusammenfasst. |
0..n |
Element |
|
message_id |
ID der Nachricht. |
1 |
integer |
|
account |
Wrapper-Element, das die Daten des Accounts zusammenfasst. |
1 |
Element |
|
account_id |
Element von account. ID des Accounts. |
1 |
integer |
|
account_identifier |
Element von account. Bezeichnung des Accounts. |
1 |
string |
|
sender |
Benutzername des Absenders. |
1 |
string |
|
recipient |
Benutzername des Empfängers. |
1 |
string |
|
subject |
Betreff der Nachricht. |
1 |
string |
|
internal_message_id |
Interne Nachrichtennummer. |
1 |
string |
|
external_message_id |
Externe Nachrichtennummer. |
1 |
string |
|
replied |
Gibt an, ob auf die Nachricht geantwortet wurde. |
1 |
boolean |
|
read_internal |
Gibt an, ob die Nachricht als gelesen markiert wurde. |
1 |
boolean |
|
message_type |
Typ der Nachricht. |
0..1 |
string |
Feste Werte:
|
message_question_type |
Fragetyp der Nachricht. Ist nur gesetzt, wenn es sich bei der Nachricht um eine Frage handelt. |
0..1 |
string |
Feste Werte: |
message_specifics |
Wrapper-Element, das sowohl ein message_member-Element als auch ein message_my_message-Element beinhalten kann. |
1..2 |
Element |
|
message_member |
Element von message_specifics. Wrapper-Element, das die Nachricht eines eBay-Benutzers zusammenfasst. |
0..1 |
Element |
|
display_public |
Element von message_member. Gibt an, ob die Nachricht/Frage bezüglich eines Angebots im Selbigen angezeigt wird |
1 |
boolean |
|
current_price |
Element von message_member. Preis des Angebots zum Zeitpunkt der Fragestellung. |
0..1 |
decimal |
|
sender_email |
Element von message_member. Von eBay-Generierte Absender-E-Mail-Adresse. |
1 |
string |
|
offer_start_date |
Element von message_member. Startzeitpunkt des eBay-Angebots |
0..1 |
dateTime |
|
offer_last_modified |
Element von message_member. Letztes Änderungsdatum des eBay-Angebots |
0..1 |
dateTime |
|
message_my_message |
Element von message_specifics. Wrapper-Element, das Nachrichten unabhängig des Absenders zusammenfasst. |
0..1 |
Element |
|
folder_id |
Element von message_my_message. ID des eBay-Nachrichten-Ordners. |
1 |
long |
|
high_priority |
Element von message_my_message. Gibt an, welche Priorität die Nachricht hat. |
1 |
boolean |
|
flagged |
Element von message_my_message. Gibt an, ob die Nachricht vom eBay-Nutzer markiert wurde. |
1 |
boolean |
|
read |
Element von message_my_message. Gibt an, ob die Nachricht auf der eBay-Seite gelesen wurde. |
1 |
boolean |
|
response_enabled |
Element von message_my_message. Gibt an, ob auf die Nachricht geantwortet werden kann. |
1 |
boolean |
|
response_url |
Element von message_my_message. Direktlink zum Antworten auf die eBay-Nachricht. Ist nur gesetzt, wenn response_enabled aktiv ist. |
0..1 |
string |
|
send_to_name |
Element von message_my_message. Benutzername des Empfängers. |
1 |
string |
|
receive_date |
Element von message_my_message. Empfangsdatum der Nachricht. |
1 |
dateTime |
|
expiry_date |
Element von message_my_message. Ablaufdatum der Nachricht. |
1 |
dateTime |
|
message_body |
Wrapper-Element, das die Nachrichteninhalt zusammenfasst. |
1 |
Element |
|
content |
Element von message_body. Nachrichtentext. Der Nachrichtentext wird im Klartext angezeigt, auch wenn das bevorzugtes E-Mail-Format des Benutzers auf HTML gesetzt ist. Grafik-und Text-Formatierung werden dabei gelöscht. |
0..1 |
string |
|
plain_text |
Element von message_body. Nachrichtentext in Plain-Text oder HTML. Dieses Feld kann Text oder HTML-Code enthalten, je nach dem Format der ursprünglichen Nachricht. Das bevorzugte E-Mail-Format wird dabei außer Acht gelassen. |
0..1 |
string |
|
message_only |
Element von message_body. Eigentlicher Nachrichteninhalt. |
0..1 |
string |
|
external_offer_number |
eBay-Artikelnummer |
0..1 |
string |
|
offer_end_time |
Auslaufzeitpunkt des Angebots |
0..1 |
dateTime |
|
offer_title |
Titel des eBay-Angebots |
0..1 |
string |
Aufgeführte Werte gelten für das Feld message_type |
Wert |
Beschreibung |
|---|---|
All |
Alle Nachrichtentypen |
AskSellerQuestion |
Nachricht eines Bieters/potentiellen Bieters zu einem bestimmten Artikel eines Verkäufers. |
ClassifiedsBestOffer |
Nachricht bei einem Preisvorschlag. |
ClassifiedsContactSeller |
Frage zu einem Angebot |
ContactEbayMember |
Nachricht von einem eBay-Benutzer an einen eBay-Benutzer. |
ContacteBayMemberViaAnonymousEmail |
Nachricht via E-Mail von einem eBay-Benutzer an einen eBay-Benutzer. |
ContacteBayMemberViaCommunityLink |
Nachricht via Community-Forum innerhalb der letzten sieben Tage von einem eBay-Benutzer an einen eBay-Benutzer. |
ContactMyBidder |
Nachricht von einem Verkäufer an einen Bieter innerhalb eines laufenden Angebots. |
ContactTransactionPartner |
Nachricht zwischen den Auftragsbeteiligten innerhalb 90 Tage nach der Erstellung des Auftrags. |
ResponseToASQQuestion |
Antwort auf den Nachrichtentyp AskSellerQuestion |
ResponseToContacteBayMember |
Antwort auf den Nachrichtentyp ContactEbayMember. |
Aufgeführte Werte gelten für das Feld message_question_type |
Wert |
Beschreibung |
|---|---|
CustomizedSubject |
Benutzerdefiniert Betreff |
General |
Allgemeine Frage über den Artikel. |
MultipleItemShipping |
Frage über eine Zusammenfassung von mehreren Artikeln für den Versand. |
None |
Es wurde kein Fragetyp angegeben. |
Payment |
Frage zur Zahlung eines Artikels. |
Shipping |
Frage zum Versand eines Artikels. |
Version |
Änderungsbeschreibung |
3.4.9.1 |
Initiale Version |