Freigeben über


Products-Ressource

Mit der Ressource Produkte können Sie Produktangebote in Ihrem Microsoft Merchant Center Store (MMC) verwalten. Informationen zur Verwendung der Products-Ressourcen finden Sie unter Verwalten Ihrer Produkte. Beispiele zum Hinzufügen, Löschen und Abrufen von Produkten finden Sie unter Codebeispiele.

Basis-URI

Im Folgenden sehen Sie den Basis-URI, an den Sie die Vorlagen anfügen.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Vorlagen

Um die Endpunkte zu erstellen, die zum Verwalten Ihrer Produktangebote verwendet werden, fügen Sie die entsprechende Vorlage an den Basis-URI an.

Vorlage HTTP-Verb Beschreibung Ressource
{mmcMerchantId}/products/batch POST Verwenden Sie , um mehrere Einfügungen (Updates), Abrufen und Löschen in einer einzelnen Anforderung auszuführen. Der Batch darf nicht mehrere Aktionen für dasselbe Produkt enthalten. Beispielsweise darf die Anforderung nicht versuchen, dasselbe Produkt einzufügen und zu löschen.

Legen Sie auf die MMC-Speicher-ID fest {mmcMerchantId} .
Anforderung: Batch
Antwort: Batch
{mmcMerchantId}/products/{productUniqueId} LÖSCHEN Verwenden Sie , um ein einzelnes Produktangebot aus dem Store zu löschen.

Legen Sie auf die MMC-Speicher-ID fest {mmcMerchantId} .

Legen Sie {productUniqueId} auf die vollqualifizierte Produkt-ID fest (z. B. Online:en:US:Sku123).

Wenn Sie ein Produkt mit derselben ID in mehrere Kataloge eingefügt haben, wird es aus allen Katalogen gelöscht.

Es kann bis zu 12 Stunden dauern, bis gelöschte Produkte nicht mehr zu liefern sind. Es wird empfohlen, die Produktverfügbarkeit vor dem Löschen auf "nicht vorrätig" zu aktualisieren.
Anforderung: N/A
Antwort: N/A
{mmcMerchantId}/products/{productUniqueId} GET Verwenden Sie , um ein einzelnes Produktangebot aus dem Store zu erhalten.

Legen Sie auf die MMC-Speicher-ID fest {mmcMerchantId} .

Legen Sie {productUniqueId} auf die vollqualifizierte Produkt-ID fest (z. B. Online:en:US:Sku123).

Wenn Sie ein Produkt mit der gleichen ID in mehrere Kataloge eingefügt haben, gibt der Dienst nur einen davon zurück, und das produkt ist unbestimmt.
Anforderung: N/A
Antwort: Produkt
{mmcMerchantId}/products GET Verwenden Sie , um eine Liste der Produkte im Store abzurufen.

Legen Sie auf die MMC-Speicher-ID fest {mmcMerchantId} .
Anforderung: N/A
Antwort: Produkte
{mmcMerchantId}/products POST Verwenden Sie , um ein einzelnes Produktangebot im Store einzufügen (zu aktualisieren).

Wenn das Produkt nicht vorhanden ist, wird es hinzugefügt. Andernfalls wird das Produkt aktualisiert. Da Updates das aktuelle Angebot überschreiben, müssen Sie alle Felder einschließen, aus denen das Angebot besteht.

Um das Angebot in einen bestimmten Katalog einzufügen, geben Sie den Abfrageparameter bmc-catalog-id an. Andernfalls wird das Produkt in den Standardkatalog des Stores eingefügt.

Legen Sie auf die MMC-Speicher-ID fest {mmcMerchantId} .

Beachten Sie , dass Sie ein Produkt mit demselben Kanal, contentLanguage, targetCountry und offerId nicht in mehrere Kataloge einfügen sollten, da Get/List- und Delete-Anforderungen gegen den Store und nicht für einen bestimmten Katalog gelten.
Anfrage: Produkt
Antwort: Produkt

Abfrageparameter

Die Endpunkte können die folgenden Abfrageparameter enthalten.

Parameter Beschreibung
alt Optional. Verwenden Sie , um den Inhaltstyp anzugeben, der in der Anforderung und Antwort verwendet wird. Die möglichen Werte sind json und xml. Der Standardwert lautet json.
bmc-catalog-id Optional. Verwenden Sie , um den Katalog anzugeben, in den Produktangebote eingefügt (aktualisiert) werden sollen.

Verwenden Sie diesen Parameter, wenn Ihr Speicher mehrere Kataloge enthält. Wenn Sie diesen Parameter nicht angeben, wird das Produkt in den Standardkatalog des Stores eingefügt.

Dieser Parameter wird nur zum Einfügen von Produktangeboten verwendet. Dieser Parameter wird für Get-, List- und Delete-Anforderungen ignoriert, da sie katalogübergreifend ausgeführt werden.
Probelauf Optional. Verwenden Sie beim Debuggen Ihrer Anwendung, um Aufrufe zu testen. Aufrufe, die diesen Parameter enthalten, wirken sich nicht auf Produktionsdaten aus (Produkte werden nicht eingefügt oder gelöscht); Die Antwort enthält jedoch alle Fehler, die der Aufruf generiert.

Beachten Sie die folgenden Einschränkungen, wenn Sie diesen Parameter verwenden.
  • Einfügevorgänge geben keine IDs zurück.
  • Der Dienst generiert oder gibt keine sekundären Fehlermeldungen wie Datenqualität, redaktionelle Probleme und datenbankbezogene Überprüfungen zurück.
Weitere Informationen zum Testen Ihrer Anwendung finden Sie unter Sandbox.
max-results Optional. Verwenden Sie , um die maximale Anzahl von Elementen anzugeben, die in einer List-Anforderung zurückgegeben werden sollen. Der Maximalwert, den Sie angeben können, ist 250. Der Standardwert ist 25.
Starttoken Optional. Verwenden Sie , um die Liste der Produkte eines Stores zu durchlaufen. Das Token identifiziert die nächste Seite von Produkten, die in einer Listenanforderung zurückgegeben werden sollen. Geben Sie diesen Parameter nicht in der ersten List-Anforderung an. Wenn der Katalog mehr als die angeforderte Anzahl von Produkten enthält (siehe den Max-results-Abfrageparameter ), enthält die Antwort das nextPageToken Feld (siehe Produkte), das den Tokenwert enthält, den Sie in der nächsten List-Anforderung verwenden.

Header

Im Folgenden sind die Anforderungs- und Antwortheader aufgeführt.

Header Beschreibung
AuthenticationToken Anforderungsheader.

Legen Sie diesen Header auf ein OAuth-Zugriffstoken fest. Informationen zum Abrufen eines Zugriffstokens finden Sie unter Authentifizieren Ihrer Anmeldeinformationen.
Inhaltsspeicherort Antwortheader.

Eine URL, die den Speicher identifiziert, in den das Produkt eingefügt wurde. Dieser Header ist in der Antwort einer Insert-Anforderung enthalten.
Content-Type Anforderungs- und Antwortheader.

Der Inhaltstyp im Textkörper der Anforderung oder Antwort. Wenn Sie JSON verwenden, legen Sie für POSTs diesen Header auf fest application/json. Wenn Sie XML verwenden, legen Sie andernfalls diesen Header auf fest application/xml.
CustomerAccountId Anforderungsheader.

Die Konto-ID eines Kontos, das Sie im Namen des im CustomerId Header angegebenen Kunden verwalten. Es spielt keine Rolle, welches Konto Sie angeben. Geben Sie diesen Header nur an, wenn Sie ein Konto im Namen des Kunden verwalten.
CustomerId Anforderungsheader.

Die Kunden-ID des Kunden, dessen Geschäft Sie verwalten. Geben Sie diesen Header nur an, wenn Sie den Speicher im Namen des Kunden verwalten. Wenn Sie diesen Header festlegen, müssen Sie auch den CustomerAccountId Header festlegen.
DeveloperToken Anforderungsheader.

Das Entwicklertoken der Clientanwendung. Jede Anforderung muss diesen Header enthalten. Informationen zum Abrufen eines Tokens finden Sie unter Verfügen Sie über Ihre Microsoft Advertising-Anmeldeinformationen und das Entwicklertoken?
Standort Antwortheader.

Eine URL, die den Speicher identifiziert, in den das Produkt eingefügt wurde. Dieser Header ist in der Antwort einer Insert-Anforderung enthalten.
WebRequestActivityId Antwortheader.

Die ID des Protokolleintrags, der Details der Anforderung enthält. Sie sollten diese ID immer erfassen, wenn ein Fehler auftritt. Wenn Sie das Problem nicht ermitteln und beheben können, geben Sie diese ID zusammen mit den anderen Informationen an, die Sie dem Supportteam zur Verfügung stellen.

Anforderungs- und Antwortobjekte

Im Folgenden werden die von der API verwendeten Anforderungs- und Antwortobjekte aufgeführt.

Jedes Objekt definiert den JSON-Schlüsselnamen und den XML-Elementnamen, die Sie abhängig vom Inhaltstyp verwenden, den Sie für die Anforderung angegeben haben.

Objekt Beschreibung
Stapel Definiert die Liste der Elemente, die in einer Batchanforderung verarbeitet werden sollen.
Error Definiert einen Fehler.
ErrorResponse Definiert das Fehlerobjekt der obersten Ebene für eine einzelne Produkteinfügung.
BatchItemError Definiert Fehler, die für ein Element während der Batchverarbeitung aufgetreten sind.
Item Definiert ein Element in einer Batchanforderung oder -antwort.
Produkt Definiert ein Produkt.
ProductCustomAttribute Definiert ein benutzerdefiniertes Attribut.
ProductCustomGroup Definiert eine Gruppe von benutzerdefinierten Attributen.
ProductDestination Definiert ein Ziel.
ProductPrice Definiert den Preis eines Produkts.
ProductTax Definiert den geografischen Standort, der die anwendbaren Steuern bestimmt.
Produkte Definiert eine Liste von Produkten.
ProductShipping Definiert die Versandkosten.
ProductShippingWeight Definiert das Versandgewicht des Artikels.
UnitPricing Definiert den Preis pro Einheit des Artikels.
Warning Definiert eine Warnmeldung.

Stapel

Definiert die Liste der Elemente, die in einer Batchanforderung verarbeitet werden sollen. Beachten Sie , dass dieses Objekt in einer Batchanforderung und -antwort verwendet wird.

Name Wert Typ XML-Elementname
Einträge Ein Array von Elementen, die in einer Batchanforderung verarbeitet werden sollen.

Die maximale Anzahl von Elementen, die Sie angeben können, ist 12.000. Die maximale Anforderungsgröße beträgt jedoch 4 MB, sodass die tatsächliche Anzahl der Elemente von der Anzahl der Produktattribute (z. B. Größe, Farbe, Muster) abhängt, die Sie einschließen, und davon, ob Sie die Daten komprimieren. Wenn Sie z. B. die Daten komprimieren, können Sie möglicherweise 12.000 Elemente angeben, aber wenn dies nicht der Fall ist, können Sie möglicherweise nur 2.000 Elemente angeben.
Element[] <Stapel>

BatchItemError

Definiert Fehler, die für ein Element während der Batchverarbeitung aufgetreten sind.

Name Wert Typ XML-Elementname
errors Eine Liste der Fehler, die bei der Verarbeitung des Elements aufgetreten sind. Fehler[] <Irrtümer>
code Der HTTP-status Code des Fehlers. String
message Eine Meldung, die dem Fehler zugeordnet ist. String

Error

Definiert einen Fehler.

Name Wert Typ XML-Elementname
domain Ausschließlich für interne Zwecke. String <Domäne>
Speicherort Nicht verwendet. String <location type="string">
locationType Nicht verwendet. String Sehen Sie sich das Type-Attribut des <Location-Elements> an.
message Eine Beschreibung des Fehlers. String <internalReason>
reason Der Grund, warum die Anforderung fehlgeschlagen ist. Beispielsweise konnte das Produkt nicht überprüft werden. String <Grund>

ErrorResponse

Definiert das Fehlerobjekt der obersten Ebene für eine einzelne Produkteinfügung.

Name Wert Typ XML-Elementname
error Eine Liste der Fehler, die bei der Verarbeitung des Elements aufgetreten sind. Fehler[] <Fehler>

Fehler

Definiert die Liste der Fehler und Warnungen für ein Angebot.

Name Wert Typ XML-Elementname
errors Eine Liste der Fehler, die bei der Verarbeitung des Elements aufgetreten sind. Fehler[] <Irrtümer>
Warnungen Eine Liste der Warnungen, die bei der Verarbeitung des Elements aufgetreten sind. Das Angebot wurde angenommen, aber Sie sollten die Probleme so früh wie möglich beheben. Mmc gibt z. B. Warnungen zurück, wenn Sie die Gtin-, mpn- und Markenbezeichner nicht angeben, wenn sie bekannt sein sollen. Warnung[] <Warnungen>
code Der HTTP-status Code oder der Fehler. String
message Eine Meldung, die dem Fehler zugeordnet ist. String

Artikel

Definiert ein Element in einer Batchanforderung.

Name Wert Typ XML-Elementname
batchId Eine benutzerdefinierte ID, die dieses Element in der Batchanforderung identifiziert. Wenn der Batch beispielsweise 10 Elemente enthält, können Sie ihnen die IDs 1 bis 10 zuweisen. Unsigned Integer <entry batch_id="unsigned integer" method="string">
errors Ein Fehlerobjekt, das eine Liste der aufgetretenen Validierungsfehler enthält. Die Antwort enthält dieses Feld nur, wenn ein Fehler auftritt. BatchItemError <Irrtümer>
merchantId Die Store-ID des Merchant Center. Unsigned Long <merchant_id>
Methode Die Aktion, die auf das Element angewendet werden soll. Die gültigen Werte sind insert, get und delete. Wenn das Element ein Produktangebot hinzufügt oder aktualisiert, legen Sie die Methode auf insertfest, wenn das Element ein Produkt löscht, legen Sie die Methode auf deletefest, und wenn das Element ein Produkt erhält, legen Sie die Methode auf getfest. Bei den Zeichenfolgen wird die Groß-/Kleinschreibung nicht beachtet. String Sehen Sie sich das method Attribut des Eintragselements <> an.
Produkt Das Produktangebot. Geben Sie dieses Feld in einer Anforderung nur an, wenn Sie ein Produkt einfügen (aktualisieren). Die Antwort enthält dieses Feld nur für Get- und Inserts (Updates). Produkt <Produkt>
Productid Die vollqualifizierte Produkt-ID (z. B. Online:en:US:Sku123). Fügen Sie dieses Feld nur beim Abrufen oder Löschen eines Produktangebots ein.

Schließen Sie nicht mehrere Elemente mit derselben Produkt-ID in eine Batchanforderung ein.
String <product_id>

Produkt

Definiert ein Produkt. Weitere Informationen zu den Feldern in diesem Objekt finden Sie unter Wie ist die Feeddatei organisiert?

JSON- und XML-Name Wert Typ Erforderlich für insert
additionalImageLinks

<additional_image_link>
Die URLs zusätzlicher Bilder des Produkts, die in der Produktanzeige verwendet werden können. So geben Sie mehrere Images an

MMC verwendet keine zusätzlichen Bilder; Dieses Feld ist für die Google-Kompatibilität enthalten.
String[] Nein
adult

<Erwachsene>
Ein boolescher Wert, der bestimmt, ob es sich bei dem Artikel um ein nicht jugendfreies Produkt handelt. Legen Sie auf TRUE fest, wenn der Zielmarkt des Elements Erwachsene ist. Der Standardwert ist false.

Beachten Sie, dass Nicht-Produkte nicht unterstützt werden und abgelehnt werden.
Boolean Nein
adwordsGrouping

<adwords_grouping>
Eine Gruppe von Elementen für CPA-Gebote (Cost-per-Acquisition).

MMC verwendet dieses Feld nicht. Es ist für die Google-Kompatibilität enthalten.
String Nein
adwordsLabels

<adwords_label>
Die Bezeichnungen für gruppierte Elemente (siehe adwordsGrouping). Gilt nur für Cost-per-Click (CPC).

MMC verwendet dieses Feld nicht. Es ist für die Google-Kompatibilität enthalten.
String[] Nein
adwordsRedirect

<adwords_redirect>
Die URL, die in der Produktanzeige verwendet werden soll. Falls angegeben, muss diese URL an die url umgeleitet werden, die im Link angegeben ist. String Nein
ageGroup

<age_group>
Die Zielgruppe des Elements. Im Folgenden sind die möglichen Werte aufgeführt.

  • adult
  • Kinder
  • Kleinkind
  • Säugling
  • Neugeborene
String Nein
availability

<availability>
Die Verfügbarkeit status des Produkts. Im Folgenden sind die möglichen Werte aufgeführt.

  • vorrätig
  • nicht mehr vorrätig
  • vorbestellen
Der Standardwert ist auf Lager.
String Ja
availabilityDate

<availability_date>
Das UTC-Datum, an dem ein Vorbestellungsprodukt für den Versand verfügbar ist (siehe Feld availability ). Dieses Feld ist optional, aber wenn Sie das Datum kennen, an dem das vorbestellte Produkt für den Versand verfügbar sein wird, sollten Sie dieses Feld festlegen. Geben Sie das Datum im ISO 8601-Format an.

ANMERKUNG: MMC ignoriert derzeit den Inhalt dieses Felds.
String Nein
Marke

<Marke>
Die Marke, der Hersteller oder der Herausgeber des Artikels. Die Zeichenfolge darf maximal 10 Wörter und 1.000 Zeichen enthalten. Um sicherzustellen, dass die Zeichenfolge in der Benutzeroberfläche gut angezeigt wird, sollten Sie den Markennamen auf maximal 70 Zeichen beschränken. String Ja
Kanal

<Kanal>
Der Vertriebskanal für das Produkt. Im Folgenden sind die möglichen Werte aufgeführt, bei denen die Groß-/Kleinschreibung nicht beachtet wird.

  • Lokal
  • Online
Da der Kanal zum Erstellen der Produkt-ID verwendet wird, können Sie dieses Feld nach dem Hinzufügen des Produkts zum Store nicht ändern.
String Ja
color

<Farbe>
Die dominante Farbe des Produkts. Wenn es sich bei der Farbe um eine Farbmischung handelt, können Sie eine durch Schrägstrich getrennte Liste mit bis zu 3 Farben (z. B. Rot/Grün/Blau) angeben.

Wenn ein Kleid in mehreren Farben verfügbar ist, erstellen Sie ein Produkt für jede Farbe und verwenden itemGroupId , um die Varianten des Produkts zu gruppieren.

Das Feld ist auf 100 Zeichen beschränkt.

Empfohlen für Bekleidungsartikel.
String Nein
Zustand

<Zustand>
Der Zustand des Produkts. Im Folgenden sind die möglichen Werte aufgeführt.

  • Neu
  • aufpoliert
  • used
Der Standardwert ist neu.
String Ja
contentLanguage

<content_language>
Der zweistellige ISO 639-1-Sprachcode für das Produkt. Im Folgenden sind die möglichen Werte aufgeführt, bei denen die Groß-/Kleinschreibung nicht beachtet wird:
  • Albanisch (sq)
  • Bosnisch (bs)
  • Bulgarisch (bg)
  • Kroatisch (hr)
  • Tschechisch (cs)
  • Niederländisch (nl)
  • Englisch (en)
  • Estnisch (et)
  • Französisch (fr)
  • Deutsch (de)
  • Griechisch (el)
  • Ungarisch (hu)
  • Isländisch (is)
  • Italienisch (it)
  • Lettisch (lv)
  • Litauisch (lt)
  • Mazedonisch (mk)
  • Maltesisch (mt)
  • Polnisch (pl)
  • Portugiesisch (pt)
  • Rumänisch (ro)
  • Serbisch (sr)
  • Slowakisch (sk)
  • Slowenisch (sl)
  • Spanisch (es)
  • Schwedisch (sv)
  • Türkisch (tr)
Da die Sprache zum Erstellen der Produkt-ID verwendet wird, können Sie dieses Feld nach dem Hinzufügen des Produkts zum Store nicht mehr ändern.
String Ja
customAttributes

<custom_attribute>
Eine Liste der benutzerdefinierten Attribute, die vom Händler verwendet werden. ProductCustomAttribute[] Nein
customGroups<custom_group> Eine Liste der benutzerdefinierten Gruppen, die vom Händler verwendet werden. ProductCustomGroup[] Nein
customLabel0

<custom_label_0>
Benutzerdefinierte Bezeichnung 0, die zum Filtern von Produkten für Microsoft Shopping-Kampagnen verwendet wird. Die Bezeichnung ist auf 100 Zeichen beschränkt. String Nein
customLabel1

<custom_label_1>
Benutzerdefinierte Bezeichnung 1, die zum Filtern von Produkten für Microsoft Shopping-Kampagnen verwendet wird. Die Bezeichnung ist auf 100 Zeichen beschränkt. String Nein
customLabel2

<custom_label_2>
Benutzerdefinierte Bezeichnung 2, die zum Filtern von Produkten für Microsoft Shopping-Kampagnen verwendet wird. Die Bezeichnung ist auf 100 Zeichen beschränkt. String Nein
customLabel3

<custom_label_3>
Benutzerdefinierte Bezeichnung 3, die zum Filtern von Produkten für Microsoft Shopping-Kampagnen verwendet wird. Die Bezeichnung ist auf 100 Zeichen beschränkt. String Nein
customLabel4

<custom_label_4>
Benutzerdefinierte Bezeichnung 4, die zum Filtern von Produkten für Microsoft Shopping-Kampagnen verwendet wird. Die Bezeichnung ist auf 100 Zeichen beschränkt. String Nein
description

<Beschreibung>
Eine Beschreibung des Produkts. Die Beschreibung darf keinen Werbetext enthalten. Die Beschreibung ist auf maximal 10.000 Zeichen beschränkt und kann unicode-Zeichen enthalten.

Die Beschreibung wird einer redaktionellen Überprüfung unterzogen.
String Nein
flugziele

<Bestimmungsort>
Die beabsichtigten Ziele des Produkts.

MMC verwendet dieses Feld nicht. Es ist für die Google-Kompatibilität enthalten.
ProductDestination[] Nein
energyEfficiencyClass

<energy_efficiency_class>
Die in der EU-Richtlinie 2010/30/EU definierte Energieeffizienzklasse. Im Folgenden sind die möglichen Werte aufgeführt.

  • A
  • A+
  • A++
  • A+++
  • B
  • C
  • D
  • E
  • F
  • G
String Nein
expirationDate

<expiration_date>
Das UTC-Datum und die UTC-Uhrzeit, die angibt, wann das Produkt abläuft.

Wenn Sie kein Ablaufdatum angeben, läuft das Produkt 30 Tage ab dem Datum und der Uhrzeit ab, zu dem Sie das Produkt hinzufügen oder aktualisieren (Datum und Uhrzeit basieren auf der Zeitzone des Microsoft-Servers).

Verwenden Sie dieses Feld, um ein Ablaufdatum anzugeben, das weniger als 30 Tage ab heute liegt.

Ihr Ablaufdatum sollte immer die Zeitkomponente enthalten und die Zeitzonen- oder Offsetinformationen angeben. Wenn dies nicht der Fall ist, versucht die API, die Zeitzone mithilfe von targetCountry zu bestimmen. Für Länder oder Regionen mit mehreren Zeitzonen bestimmt die API die zu verwendende Zeitzone. Wenn das Land z. B. USA ist, verwendet die API die pazifische Standardzeit (PST).

Sie sollten Produkte nachverfolgen, deren Ablauf sich nähert, und bevor sie ablaufen, entweder ihr Ablaufdatum aktualisieren oder einfach das Produkt aktualisieren (Sie müssen keines der Felder des Produkts aktualisieren), wodurch das Ablaufdatum automatisch um weitere 30 Tage verlängert wird. Wenn Sie das Ablaufdatum explizit festlegen, müssen Sie selbst ein neues Ablaufdatum festlegen. Durch die Aktualisierung des Produkts wird das Ablaufdatum in diesem Fall nicht automatisch um weitere 30 Tage verlängert.
String Nein
gender

<Geschlecht>
Das Geschlecht, auf das das Produkt abzielt. Im Folgenden sind die möglichen Werte aufgeführt.

  • Weiblich
  • Männlich
  • unisex
String Nein
googleProductCategory

<google_product_category>
Die Produktkategorie, in der sich das Produkt befindet. Sie können entweder eine Kategoriezeichenfolge (z. B. Tiere & Pet Supplies > Pet supplies > Bird Supplies) oder eine Kategorie-ID (z. B. 3) angeben. Bei einer Kategoriezeichenfolge wird die Liste der Unterkategorien durch das Größer-als-Symbol ('>') getrennt. Das Feld ist auf 255 Zeichen beschränkt. String Nein
gtin

<gtin>
Die vom Hersteller zugewiesene Global Trade Item Number (GTIN). Wenn der Hersteller eine GTIN zuweist, müssen Sie diese angeben. Die folgenden GTIN-Typen sind aufgeführt.

  • EAN (Europäische Artikelnummer)
  • ISBN (Internationale Standard Buchnummer)
  • JAN (Japanische Artikelnummer)
  • UPC (Universal Product Code)
String Ja
id

<id>
Die vollqualifizierte Produkt-ID. Die ID ist eine Kombination aus channel, contentLanguage, targetCountry und offerId. Bei der ID wird die Groß-/Kleinschreibung beachtet.

Verwenden Sie diese ID, um ein Produkt abzurufen oder zu löschen.
String Nein
identifierExists

<identifier_exists>
Ein boolescher Wert, der bestimmt, ob das Produktangebot die GTIN-, MPN- oder Marken-IDs angibt. The default is true. Legen Sie auf false fest, wenn Sie nicht alle drei Bezeichner angeben.

Eindeutige Produktbezeichner definieren ein Produkt in einem globalen Marketplace. Wenn Sie Ihre Produkte mit eindeutigen Bezeichnern markieren, können Kunden Ihre Produkte leichter finden. Sie sollten alle drei Bezeichner angeben, sofern bekannt.
Boolean Nein
imageLink

<image_link>
Die URL zu einem Bild des Produkts, das in der Produktanzeige verwendet werden kann. Die URL ist auf 1.000 Zeichen beschränkt und kann das HTTP- oder HTTPS-Protokoll verwenden. Die zulässigen Bildtypen sind bmp, gif, exif, jpg, png und tiff. Die empfohlene Bildgröße beträgt 200 x 200 Pixel. Das Bild darf 3,9 MB nicht überschreiten.

Das Bild wird einer redaktionellen Überprüfung unterzogen.
String Ja
isBundle

<is_bundle>
Ein boolescher Wert, der bestimmt, ob es sich bei dem Produkt um ein vom Händler definiertes Bündel handelt. Der Wert ist true , wenn es sich bei dem Produkt um ein Bündel handelt. Boolean Nein
itemGroupId

<item_group_id>
Eine ID, die zum Gruppieren aller Varianten desselben Produkts verwendet werden kann. Wenn das Kleid beispielsweise in drei Farben verfügbar ist, können Sie ein Produkt für jede Farbe erstellen und diese ID verwenden, um sie zu gruppieren. In der Regel gruppieren Sie Elemente, die je nach Farbe, Material, Muster oder Größe variieren.

Die ID muss innerhalb eines Katalogs eindeutig sein und ist auf 50 Zeichen beschränkt.
String Nein
kind

<Art>
Der Typ des Objekts. Dieses Feld ist auf content#productfestgelegt. String Nein
verbinden

<verbinden>
Die URL zur Produktseite auf Ihrer Website. Die URL ist auf 2.000 Zeichen beschränkt und kann das HTTP- oder HTTPS-Protokoll verwenden. Die Domäne muss mit der Domäne des Speichers übereinstimmen.

Der Link wird in der Produktanzeige verwendet. Die URL wird möglicherweise nicht umgeleitet. Informationen zur Verwendung einer anderen URL in der Produktanzeige, die möglicherweise zu dieser URL umgeleitet wird, finden Sie unter adwordsRedirect.

Die Webseite, auf die dieser Link verweist, wird einer redaktionellen Überprüfung unterzogen.
String Ja
Material

<Material>
Das dominante Material des Produkts. Wenn es sich bei dem Material um eine Materialmischung handelt, können Sie eine durch Schrägstrich getrennte Liste mit bis zu 3 Materialien (z. B. Leder/Wildleder/Seide) angeben.

Wenn ein Kleid in mehreren Materialien verfügbar ist, erstellen Sie ein Produkt für jedes Material und verwenden itemGroupId , um die Varianten des Produkts zu gruppieren.

Das Feld ist auf 200 Zeichen beschränkt.

Empfohlen für Bekleidungsartikel.
String Nein
mobileLink

<mobile_link>
Eine URL zu einer für Mobilgeräte optimierten Version der Webseite, die Informationen zum Produkt enthält (siehe Link). String Nein
multipack

<multipack>
Die Anzahl identischer Produkte, die als einzelne Einheit verkauft werden (z. B. 4 Taschenlampen). Beim Festlegen des Preises muss dies der Gesamtpreis des Multipacks sein. Ganze Zahl Nein
mpn

<mpn>
Die Herstellerteilnummer (MPN) des Produkts. Wenn der Hersteller ein MPN zuweist, müssen Sie es angeben. Der MPN ist auf 70 Zeichen beschränkt. String Ja
offerId

<offer_id>
Die benutzerdefinierte ID des angebotenen Produkts. Bei der Angebots-ID wird die Groß-/Kleinschreibung nicht beachtet und muss innerhalb eines Katalogs eindeutig sein und ist auf maximal 50 Zeichen beschränkt.

Da die Angebots-ID zum Erstellen der Produkt-ID verwendet wird, können Sie dieses Feld nach dem Hinzufügen des Produkts zum Store nicht mehr ändern.
String Ja
onlineOnly

<online_only>
Ein boolescher Wert, der bestimmt, ob das Produkt nur online erworben werden kann. Der Wert ist true , wenn das Produkt nur online verfügbar ist. Der Standardwert ist false. Boolean Nein
Muster

<Muster>
Das Muster oder der grafische Druck des Produkts (z. B. Plaid). Das Muster ist auf 100 Zeichen beschränkt.

Wenn ein Kleid in mehreren Mustern verfügbar ist, erstellen Sie ein Produkt für jedes Muster und verwenden itemGroupId , um die Varianten des Produkts zu gruppieren.

Empfohlen für Bekleidungsartikel.
String Nein
Preis

<Preis>
Der Preis des Produkts. Geben Sie den Preis in der Währung des Ziellandes an. Informationen dazu, ob Steuern in den Preis einbezogen werden sollen, finden Sie unter Steuerrichtlinie für den Microsoft Merchant Center-Katalog. Der Preis muss mit dem preis auf der Webseite des Produkts (siehe Link) übereinstimmen und muss im Bereich von 0,01 (1 Cent) bis 1000000,00 (10 Millionen) liegen.

Wenn jedoch die folgenden Bedingungen erfüllt sind, können Sie den Preis auf 0,0 (null) festlegen.

1. Das Feld googleProductCategory ist auf eine der folgenden Kategorien festgelegt:
    - Elektronische > Kommunikation > Telefonie > Mobiltelefone
    - Elektronik > Computer > Tablet Computer
2. Das Titelfeld enthält eines der folgenden Schlüsselwörter:
    -Vertrag
    -Rate
    -mieten
    -Zahlung

Die oben genannten Schlüsselwörter werden in Englisch angezeigt; Der Titel und die Schlüsselwort (keyword) müssen jedoch in der Sprache des angegebenen Marktes sein.

In der Regel enthält der Titel Ausdrücke wie "... mit Ratenplan" oder "... nur mit Vertrag". Der Vertrag Schlüsselwort (keyword) kann in allen Märkten verwendet werden; Ratenzahlung, Zahlung und Leasing dürfen jedoch nur auf dem US-Markt verwendet werden.
ProductPrice Ja
productType

<product_type>
Die vom Werbetreibenden definierte Produktkategorie, die sich von unterscheiden googleProductCategorykann. Zum Beispiel, Animals & Pet Supplies > Pet liefert > Vogelbedarf > Veterinär. Die Liste der Unterkategorien wird durch das Größer-als-Symbol ("")> getrennt. Das Feld ist auf 750 Zeichen beschränkt.

Sie können mehrere Kategoriezeichenfolgen angeben, die durch Trennzeichen getrennt sind. Beispielsweise Kostüme & Accessoires > PerückenZubehör > Perückenkappen, Kostüme & Accessoires > Perückenlei > .
String Nein
promotionId

<promotion_id>
Eine durch Trennzeichen getrennte Liste von IDs, die Werbeaktionen in Ihrem Promotionsfeed identifizieren. Sie können maximal 10 Höherstufungs-IDs angeben.

Die ID muss mindestens 1 Zeichen und maximal 60 Zeichen enthalten. Zulässige Zeichen sind alle alphanumerischen Zeichen, ein Bindestrich (-) und ein Unterstrich (_).

Alle IDs für einen Markt (siehe contentLanguage und targetCountry) müssen eindeutig sein. Innerhalb eines Marktes dürfen Sie beispielsweise PROMO1 und promo1 nicht verwenden, aber Sie können PROMO1 im en-US-Markt und promo1 im en-GB-Markt verwenden. Sie können dieselbe eindeutige Werbe-ID für ein oder mehrere Produkte angeben.

Microsoft wirbt für das Produkt, wenn die von Ihnen angegebene ID mit einer Werbe-ID in Ihrem Promotionsfeed (für dasselbe Zielland) übereinstimmt. Die IDs stimmen nur überein, wenn die Groß-/Kleinschreibung identisch ist. Beispielsweise stimmen die IDs überein, wenn die ID des Produkts PROMO1 und die ID des Feeds PROMO1 ist, aber sie stimmen nicht überein, wenn die ID des Feeds Promo1 lautet.

Um sicherzustellen, dass das Produkt in Zukunft nicht versehentlich höhergestuft wird, sollten Sie die IDs der beendeten Werbeaktionen entfernen. Obwohl die ID 6 Monate nach Ende der Promotion nicht erneut in einem Promotionsfeed verwendet werden kann, wird das Produkt höher gestuft, wenn die ID anschließend in einer anderen Promotion wiederverwendet wird.
String Nein
salePrice

<sale_price>
Der Verkaufspreis des Artikels. Der Verkaufspreis muss im Bereich von 0,01 (1 Cent) bis 1000000,00 (10 Millionen) liegen.

Legen Sie für Verkaufsartikel sowohl den Verkaufspreis als auch das Effektive Datum des Verkaufs fest (siehe salePriceEffectiveDate). Wenn Sie den Verkaufspreis, aber nicht das Gültigkeitsdatum des Verkaufspreises festlegen, wird der Verkaufspreis weiterhin verwendet, bis das Produkt abläuft oder Sie ein Gültigkeitsdatum festlegen.

Wenn die folgenden Bedingungen erfüllt sind, können Sie den Verkaufspreis auf 0,0 (null) festlegen.

1. Das Feld googleProductCategory ist auf eine der folgenden Kategorien festgelegt:
    - Elektronische > Kommunikation > Telefonie > Mobiltelefone
    - Elektronik > Computer > Tablet Computer
2. Das Titelfeld enthält eines der folgenden Schlüsselwörter:
    -Vertrag
    -Rate
    -mieten
    -Zahlung

Die oben genannten Schlüsselwörter werden in Englisch angezeigt; Der Titel und die Schlüsselwort (keyword) müssen jedoch in der Sprache des angegebenen Marktes sein.

In der Regel enthält der Titel Ausdrücke wie "... mit Ratenplan" oder "... nur mit Vertrag". Der Vertrag Schlüsselwort (keyword) kann in allen Märkten verwendet werden; Ratenzahlung, Zahlung und Leasing dürfen jedoch nur auf dem US-Markt verwendet werden.
ProductPrice Nein
salePriceEffectiveDate

<sale_price_effective_date>
Das UTC-Start- und Enddatum des Verkaufs. Geben Sie die Datumsangaben im ISO 8601-Format an. Beispiel: 2016-04-05T08:00-08:00/2016-04-10T19:30-08:00 (Verwenden Sie einen Schrägstrich ('/'), um das Start- und Enddatum zu trennen). Weitere Informationen finden Sie unter salePrice. String Nein
sellerName

<seller_name>
Der Name des Händlers, der das Produkt verkauft. Wird nur von Aggregatoren verwendet, um den Händler zu identifizieren. Aggregatoren sind Websites von Drittanbietern, die sich im Namen einzelner Händler verhalten. Die Produkte, die ein Aggregator im Namen des Händlers übermittelt, müssen den Microsoft Advertising-Richtlinien und -Nutzungsbedingungen entsprechen.

Aggregatoren müssen dieses Feld auf den Namen des Verkäufers festlegen. Wenn der Aufrufer kein Aggregator ist und dieses Feld nicht festgelegt ist, wird standardmäßig der Speichername verwendet.

Der Name ist auf 255 Zeichen beschränkt.
String Nein
Versand

<Versand>
Der Preis für den Versand des Produkts basierend auf dem Standort.

HINWEIS: Versand ist erforderlich, wenn das Zielland DE (Deutschland) ist; Andernfalls ist dies optional.
ProductShipping[] Ja
shippingLabel

<shipping_label>
Das Versandetikett.

HINWEIS: Versandinformationen sind erforderlich, wenn das Zielland DE (Deutschland) ist; Andernfalls ist dies optional.
String Ja
shippingWeight

<shipping_weight>
Das Gewicht des Produkts. Das Gewicht wird für Versandzwecke verwendet.

HINWEIS: Versandinformationen sind erforderlich, wenn das Zielland DE (Deutschland) ist; Andernfalls ist dies optional.
ProductShippingWeight Ja
Größen

<size>
Die verfügbaren Größen des Produkts. Beispiel: "small", "medium" und "large". Wenden Sie die Größenanpassung konsistent an. Der Größenwert ist benutzerdefinierter Wert, sollte aber auf Ihrem Zielland basieren. Dieses Feld ist für alle Apparel & Accessories-Produkte erforderlich, wenn es sich um Frankreich, Deutschland, Vereinigtes Königreich und USA handelt. String[] Nein
sizeSystem

<size_system>
Das Messsystem, das zur Größenbestimmung des Produkts verwendet wird. Schuhe können z. B. mit dem US-System oder dem britischen System angepasst werden.

Im Folgenden sind die möglichen Werte aufgeführt.

  • AU
  • DE
  • FR
  • GB
  • US
Standardmäßig wird das system verwendet, das vom Zielland verwendet wird. Empfohlen für Bekleidungsartikel.
String Nein
sizeType

<size_type>
Der Schnitt des Produkts. Im Folgenden sind die möglichen Werte aufgeführt.

  • regelmäßig
  • Mutterschaft
  • zierlich
  • plus
  • groß und groß
Der Standardwert ist "Normal". Empfohlen für Bekleidungsartikel.
String Nein
targetCountry

<target_country>
Der aus zwei Buchstaben bestehende ISO 3166-Ländercode des Ziellandes (das Land, in dem Sie das Produkt bewerben möchten). Das Land muss mit dem im Katalog angegebenen Markt übereinstimmen.

Im Folgenden sind die möglichen Werte aufgeführt, bei denen die Groß-/Kleinschreibung nicht beachtet wird:

  • AD (Andorra)
  • AL (Albanien)
  • AR (Argentinien)
  • AW (Aruba)
  • AT (Österreich)
  • AU (Australien)
  • BS (Bahamas)
  • BD (Bangladesch)
  • BA (Bosnien und Herzegowina)
  • BE (Belgien)
  • BO (Bolivien)
  • BG (Bulgarien)
  • BR (Brasilien)
  • BN (Brunei)
  • CA (Kanada)
  • KY (Kaimaninseln)
  • CH (Schweiz)
  • CL (Chile)
  • CO (Kolumbien)
  • CR (Costa Rica)
  • CY (Zypern)
  • CZ (Tschechische Republik)
  • DE (Deutschland)
  • DK (Dänemark)
  • DM (Dominica)
  • DO (Dominikanische Republik)
  • EG (Ecuador)
  • SV (El Salvador)
  • EE (Estland)
  • ES (Spanien)
  • FJ (Fidschi)
  • FI (Finnland)
  • FR (Frankreich)
  • GF (Französisch-Guayana)
  • PF (Französisch-Polynesien)
  • GB (Großbritannien)
  • GR (Griechenland)
  • GU (Guam)
  • GT (Guatemala)
  • GY (Guyana)
  • HT (Haiti)
  • HN (Honduras)
  • HR (Kroatien)
  • HU (Ungarn)
  • ID (Indonesien)
  • IE (Irland)
  • IN (Indien)
  • IS (Island)
  • IT (Italien)
  • LI (Liechtenstein)
  • LT (Litauen)
  • LU (Luxemburg)
  • LV (Lettland)
  • MV (Malediven)
  • MC (Monaco)
  • ME (Montenegro)
  • MK (Nordmazedonien)
  • MT (Malta)
  • MQ (Martinique)
  • MY (Malaysia)
  • MX (Mexiko)
  • MN (Mongolei)
  • MS (Montserrat)
  • NP (Nepal)
  • NL (Niederlande)
  • NC (Neukaledonien)
  • NO (Norwegen)
  • NZ (Neuseeland)
  • PA (Panama)
  • PG (Papua-Neuguinea)
  • PH (Philippinen)
  • PY (Paraguay)
  • PE (Peru)
  • PL (Polen)
  • PT (Portugal)
  • PR (Puerto Rico)
  • RO (Rumänien)
  • RS (Serbien)
  • LK (Sri Lanka)
  • SE (Schweden)
  • SG (Singapur)
  • SI (Slowenien)
  • SK (Slowakei)
  • SM (San Marino)
  • TH (Thailand)
  • TT (Trinidad und Tobago)
  • TR (Türkiye)
  • USA (USA)
  • UT (Uruguay)
  • VA (Vatikanstadt)
  • VE (Venezuela)
  • VN (Vietnam)
  • ZA (Südafrika)
Da das Land zum Erstellen der Produkt-ID verwendet wird, können Sie dieses Feld nach dem Hinzufügen des Produkts zum Geschäft nicht ändern.
String Ja
Steuern

<Steuer>
Die Steuerinformationen des Produkts.

MMC verwendet dieses Feld nicht. Es ist für die Google-Kompatibilität enthalten.
ProductTax[] Nein
Titel

<Titel>
Der Titel des Produkts (z. B. Damenschuhe). Der Titel darf keinen Werbetext enthalten. Der Titel ist auf maximal 150 Zeichen beschränkt und kann ein beliebiges Unicode-Zeichen enthalten.

Der Titel wird einer redaktionellen Überarbeitung unterzogen.
String Ja
unitPricingBaseMeasure

<unit_pricing_base_measure>
Das Basismeasure des Produkts für die Preisgestaltung (z. B. 100ml bedeutet, dass der Preis auf der Grundlage einer Einheit von 100 ml berechnet wird).
  • Gewicht: oz, lb, mg, g, kg
  • Volume (US imperial): floz, pt, qt, gal
  • Volumen: ml, cl, l, cbm
  • Länge: in, ft, yd, cm, m
  • Fläche: sqft, qm
  • Pro Einheit: ct

UnitPricingBaseMeasure Nein
unitPricingMeasure

<unit_pricing_measure>
Das Measure und die Dimension des Produkts beim Verkauf.
  • Gewicht: oz, lb, mg, g, kg
  • Volume (US imperial): floz, pt, qt, gal
  • Volumen: ml, cl, l, cbm
  • Länge: in, ft, yd, cm, m
  • Fläche: sqft, qm
  • Pro Einheit: ct

UnitPricingMeasure Nein
validatedDestinations

<validated_destination>
Die schreibgeschützte Liste der beabsichtigten Ziele, die die Überprüfung bestanden haben.

MMC verwendet dieses Feld nicht. Es ist für die Google-Kompatibilität enthalten.
String[] Nein
Warnungen Eine Liste von Warnungen zu Problemen mit dem Produktangebot. Das Angebot wurde angenommen, aber Sie sollten die Probleme so früh wie möglich beheben. Mmc gibt z. B. Warnungen zurück, wenn Sie die Gtin-, mpn- und Markenbezeichner nicht angeben, wenn sie bekannt sein sollen.

Das Angebot enthält dieses Feld nur in der Antwort eines Einfüge-/Aktualisierungsvorgangs.
Warnung[] Nein

ProductCustomAttribute

Definiert ein benutzerdefiniertes Attribut.

Name Wert Typ XML-Elementname
name Ruft den Namen des Attributs ab oder legt den Namen fest. String <Name>
type Ruft den Typ des Attributs ab oder legt den Typ fest. Im Folgenden sind die möglichen Werte aufgeführt.

  • Boolescher Wert
  • datetimerange
  • Gleitkommazahl
  • Gruppe
  • int
  • Preis
  • text
  • Uhrzeit
  • url
Zeichenfolge <Art>
Einheit Ruft die Maßeinheit des Attributs ab oder legt sie fest. Wird nur für Werte vom Typ INT und FLOAT verwendet. String <Einheit>
Wert Ruft den Wert des Attributs ab oder legt den Wert fest. String <Wert>

ProductCustomGroup

Definiert eine Gruppe von Kundenattributen.

Name Wert Typ XML-Elementname
attributes Ruft die Attribute für die Gruppe ab oder legt diese fest. ProductCustomAttribute <Attribute>
name Ruft den Namen der Gruppe ab oder legt den Namen fest. String <Name>

ProductDestination

Definiert ein Ziel.

Name Wert Typ XML-Elementname
Absicht Im Folgenden sind die möglichen Werte aufgeführt.

  • Vorgabe
  • ausgeschlossen
  • Optional
  • Erforderlich
String <Absicht>
destinationName Ruft den Namen des Ziels ab oder legt den Namen fest. String <destination_name>

ProductPrice

Definiert den Preis oder verkaufspreis eines Produkts.

Name Wert Typ XML-Elementname
Währung Ruft die Währung ab, in der der Preis angegeben ist, oder legt diese fest. Geben Sie die Währung mithilfe von ISO 4217-Währungscodes an. Im Folgenden sind die möglichen Werte aufgeführt.

  • AUD (Australischer Dollar)
  • CHF (Schweizer Franken)
  • CAD (Kanadischer Dollar)
  • EUR (Euro)
  • GBP (Britisches Pfund)
  • IDR (Indonesische Rupiah)
  • INR (Indische Rupien)
  • MYR (Malaysischer Ringgit)
  • NZD (Neuseeländischer Dollar)
  • PHP (Philippinischer Peso)
  • SEK (Schwedische Krone)
  • SGD (Singapur-Dollar)
  • THB (Thai Baht)
  • USD (USA Dollar)
  • VND (Vietnamesisch dong)
String currency Attribut.

Beispiel: <price currency="USD">.
Wert Ruft den Preis des Elements ab oder legt diesen fest. Schließen Sie keine Währungssymbole wie "$" ein. Gleitkommawert mit doppelter Genauigkeit Textwert.

Beispiel: <price currency="USD">38.0<\price>.

Produkte

Definiert eine Liste von Produkten. Beachten Sie , dass dies das Objekt der obersten Ebene ist, das die List-Anforderung zurückgibt.

Name Wert Typ XML-Elementname
kind Ruft den Typ des Objekts ab. Dieses Feld ist auf content#productsListResponse festgelegt. String <Art>
nextPageToken Ruft das Token ab, das zum Abrufen der nächsten Ergebnisseite verwendet wird. Wenn das Objekt dieses Feld nicht enthält, gibt es keine weiteren Seiten, die abgerufen werden können. Siehe Starttoken. String <next_page_token>
Ressourcen Ruft die Liste der Produkte ab. Wenn der Katalog keine Angebote enthält, ist das Array leer. Produkt[] <Produkte>

ProductShipping

Definiert die Versandkosten.

Name Wert Typ XML-Elementname
Land/Region Ruft den aus zwei Buchstaben bestehenden ISO 3166-Ländercode des Landes ab, in das der Artikel versendet wird, oder legt diesen fest. String <Land>
locationGroupName Ruft den Namen der Standortgruppe ab oder legt den Namen fest. String <location_group_name>
locationId Ruft die ID des geografischen Standorts ab, an den der Artikel versendet wird, oder legt diese fest. Eine Liste der IDs finden Sie unter Codes für geografische Standorte. String <location_id>
postalCode Ruft die Postleitzahl oder den Postleitzahlbereich des Speicherorts ab, an den der Artikel versendet wird, oder legt diesen fest. Sie können die Postleitzahl wie folgt angeben:

  • Vollständige Postleitzahl: 94114

  • Eine Postleitzahl mit einem Wildcard (nur Suffix): 94*

  • Codebereich: 94002-95460

  • Ein Codebereich mit Wildcards (die Postleitzahlpräfixe müssen gleich lang sein: 94*-95*
String <postal_code>
Preis Ruft den Festpreis ab, um das Element an den angegebenen Speicherort zu versenden, oder legt diesen fest. ProductPrice <Preis>
Region Ruft die geografische Region ab, in die das Element versendet wird (z. B. Postleitzahl), oder legt diese fest. String <Region>
Dienst Ruft eine Textbeschreibung ab, die die Dienstklasse oder die Übermittlungsgeschwindigkeit beschreibt, oder legt diese fest. String <Dienst>

ProductShippingWeight

Definiert das Versandgewicht des Artikels.

Name Wert Typ XML-Elementname
Einheit Ruft die Maßeinheit ab oder legt sie fest. String unit Attribut.

Beispiel: <shipping_weight unit="oz">.
Wert Ruft das Gewicht des Elements ab, das zum Berechnen der Versandkosten des Artikels verwendet wird, oder legt dieses fest. String Textwert.

Beispiel <: shipping_weight unit="oz">20.3<shipping_weight>.

ProductTax

Definiert den geografischen Standort, der die anwendbaren Steuern bestimmt.

Name Wert Typ XML-Elementname
Land/Region Ruft das Land ab, dessen Steuersatz gilt, oder legt dieses fest. Verwendet den zweistelligen ISO 3166-Ländercode . String <Land>
locationId Ruft die ID des geografischen Standorts ab, dessen Steuersatz gilt, oder legt diese fest. Eine Liste der IDs finden Sie unter Codes für geografische Standorte. Long <location_id>
postalCode Ruft die Postleitzahl oder den Postleitzahlbereich ab, deren Steuersatz gilt, oder legt diese fest. Sie können die Postleitzahl wie folgt angeben:

  • Vollständige Postleitzahl: 94114

  • Eine Postleitzahl mit einem Wildcard (nur Suffix): 94*

  • Codebereich: 94002-95460

  • Ein Codebereich mit Wildcards (die Postleitzahlpräfixe müssen gleich lang sein: 94*-95*
String <postal_code>
Rate Ruft den Prozentualen Steuersatz ab, der auf den Preis des Elements angewendet werden soll, oder legt diesen fest. Um eine Rate von 5 % anzugeben, legen Sie dieses Feld auf 5 fest. Um eine Rate von 9,8 % anzugeben, legen Sie dieses Feld auf 9,8 fest. Gleitkommawert mit doppelter Genauigkeit <Rate>
Region Ruft eine geografische Region ab, deren Steuersatz gilt, oder legt diese fest. String <Region>
taxShip Ruft einen booleschen Wert ab, der bestimmt, ob die Steuer auf die Versandkosten angewendet werden soll, oder legt diesen fest. Legen Sie diesen Wert auf TRUE fest, wenn beim Versand Steuern berechnet werden. Boolesch <Schiff>

UnitPricing

Definiert den Preis pro Einheit des Artikels.

Name Wert Typ XML-Elementname
Einheit Ruft die Maßeinheit ab oder legt sie fest. Beispiel : oz , wenn der Preis pro Unze ist. String unit Attribut.

Beispiel: <unit_pricing_measure unit="oz">
Wert Ruft den Preis pro Einheit ab oder legt den Preis fest. Gleitkommawert mit doppelter Genauigkeit Textwert.

Beispiel: <unit_pricing_measure unit="oz">34.5<\unit_pricing_measure>

Warnung

Definiert eine Warnmeldung.

Name Wert Typ XML-Elementname
domain Ausschließlich für interne Zwecke. String <Domäne>
message Eine Beschreibung der Warnung. String <internalReason>
reason Der Grund, warum das Angebot eine Warnung generiert hat. Beispielsweise haben Sie keinen Bezeichner (gtin, mpn oder brand) angegeben, wenn bekannt ist, dass der Hersteller diese zugewiesen hat. String <Grund>

HTTP-Statuscodes

Die Anforderungen geben möglicherweise die folgenden HTTP-status-Codes zurück.

Statuscode Beschreibung
200 Erfolg.
204 Das Produkt wurde erfolgreich gelöscht.
400 Ungültige Anforderung. Entweder ist ein Abfrageparameterwert ungültig, oder etwas im Anforderungstext ist ungültig.

Batch: Wenn ein Fehler auftritt, enthält das fehlerhafte Batchelement die Fehler.
401 Unbefugt. Die Anmeldeinformationen des Benutzers sind ungültig.
404 Nicht gefunden.
409 Konflikt. Der Vorgang konnte aufgrund eines Konflikts mit dem aktuellen Zustand der Ressource nicht abgeschlossen werden.
413 Die Anforderungsentität ist zu groß. Die Größe der Anforderung überschreitet den maximal zulässigen Wert.
500 Serverfehler.