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.
|
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 insert fest, wenn das Element ein Produkt löscht, legen Sie die Methode auf delete fest, und wenn das Element ein Produkt erhält, legen Sie die Methode auf get fest. 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.
|
String | Nein |
availability <availability> |
Die Verfügbarkeit status des Produkts. Im Folgenden sind die möglichen Werte aufgeführt.
|
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.
|
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.
|
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:
|
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.
|
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.
|
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.
|
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#product festgelegt. |
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 googleProductCategory kann. 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.
|
String | Nein |
sizeType <size_type> |
Der Schnitt des Produkts. Im Folgenden sind die möglichen Werte aufgeführt.
|
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:
|
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).
|
UnitPricingBaseMeasure | Nein |
unitPricingMeasure <unit_pricing_measure> |
Das Measure und die Dimension des Produkts beim Verkauf.
|
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.
|
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.
|
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.
|
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:
|
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:
|
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. |