Freigeben über

Bestandsressource

  • Artikel

Hinweis

Die Bestands-API ist nur für geschlossene Pilotteilnehmer verfügbar. Api und Dokumentation können geändert werden.

Mit der Ressource Bestand können Sie Preise und Verfügbarkeit von Produkten in Ihrem Microsoft Merchant Center (MMC)-Store aktualisieren. Informationen zur Verwendung der Bestandsressourcen finden Sie unter Aktualisieren der Produktpreise. Beispiele, die zeigen, wie Sie Preise und Verfügbarkeit aktualisieren, 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

Vorlagen

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

Vorlage HTTP-Verb Beschreibung
/bmc/{mmcMerchantId}/inventory/batch POST Verwenden Sie , um mehrere Produktpreisaktualisierungen in einer einzelnen Anforderung durchzuführen.

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

Anforderungsobjekt: Batch
Antwortobjekt: Batch
/bmc/{mmcMerchantId}/inventory/{storeCode}/products/{productUniqueId} POST Verwenden Sie , um Preise und Verfügbarkeit eines einzelnen Produkts zu aktualisieren.

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

Legen Sie diese Einstellung auf online fest {storeCode} .

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

Anforderungsobjekt: Produkt
Antwortobjekt: Product

Abfrageparameter

Die Endpunkte können die folgenden Abfrageparameter enthalten.

Parameter Beschreibung
Probelauf Optional. Verwenden Sie beim Debuggen Ihrer Anwendung, um Aufrufe zu testen. Aufrufe, die diesen Parameter enthalten, wirken sich nicht auf Produktionsdaten aus. Wenn ein Fehler auftritt, enthält die Antwort alle Fehler, die der Aufruf normalerweise generiert, mit Ausnahme sekundärer Fehlermeldungen wie Datenqualität, redaktionelle Probleme und datenbankbezogene Überprüfungen. Weitere Informationen zum Testen Ihrer Anwendung finden Sie unter Sandbox.

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.
Content-Type Anforderungs- und Antwortheader.

Der Inhaltstyp im Textkörper der Anforderung oder Antwort. Legen Sie auf application/json fest.
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.

Die URL des Produkts, das aktualisiert wurde.
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.

Objekt Beschreibung
Batch Definiert die Liste der Produkte, die in einer Batchanforderung aktualisiert werden sollen.
Error Definiert einen Fehler.
ErrorResponse Definiert das Fehlerobjekt der obersten Ebene für ein Nicht-Batchupdate.
BatchEntryError Definiert Fehler, die für ein Element während der Batchverarbeitung aufgetreten sind.
Eintrag Definiert einen Eintrag in einer Batchanforderung oder -antwort.
Produkt Definiert ein Produkt.
ProductPrice Definiert den Preis eines Produkts.

Batch

Definiert die Liste der Produkte, die in einem Batch aktualisiert werden sollen.

Name Wert Typ
Einträge Eine Liste der Produkte, die in einem Batch aktualisiert werden sollen. Die maximale Anzahl von Produkten, die Sie angeben können, ist 400. Eintrag[]

BatchEntryError

Definiert Fehler, die für einen Eintrag während der Batchverarbeitung aufgetreten sind.

Name Wert Typ
errors Eine Liste der Fehler, die bei der Verarbeitung des Eintrags aufgetreten sind. Fehler[]
code Der HTTP-status Code des Fehlers. Zeichenfolge
message Die dem Fehler zugeordnete Meldung. Zeichenfolge

Fehler

Definiert einen Fehler.

Name Wert Typ
domain Ausschließlich für interne Zwecke. Zeichenfolge
message Eine Beschreibung des Fehlers. Zeichenfolge
reason Der Grund, warum die Anforderung fehlgeschlagen ist. Beispielsweise konnte das Produkt nicht überprüft werden. Zeichenfolge

ErrorResponse

Definiert das Fehlerobjekt der obersten Ebene für ein einzelnes Produktupdate.

Name Wert Typ
error Eine Liste der Fehler, die bei der Verarbeitung des Elements aufgetreten sind. Fehler[]

Fehler

Definiert die Liste der Fehler für ein Produkt.

Name Wert Typ
errors Eine Liste der Fehler, die bei der Verarbeitung des Eintrags aufgetreten sind. Fehler[]
code Der HTTP-status Code des Fehlers. Zeichenfolge
message Eine Meldung, die dem Fehler zugeordnet ist. Zeichenfolge

Eintrag

Definiert einen Eintrag in einer Batchanforderung.

Name Wert Typ
batchId Eine benutzerdefinierte ID, die diesen Eintrag in der Batchanforderung eindeutig identifiziert. Wenn der Batch beispielsweise 10 Einträge enthält, können Sie ihnen die IDs 1 bis 10 zuweisen. Unsigned Integer
errors Ein Fehlerobjekt, das eine Liste der aufgetretenen Validierungsfehler enthält. Die Antwort enthält dieses Feld nur, wenn ein Fehler auftritt. BatchEntryError
inventory Der aktualisierte Preis und die Verfügbarkeit. Produkt
merchantId Die Store-ID des Merchant Center. Da die URL die Store-ID enthält, wird dieses Feld ignoriert. Unsigned Long
Productid Die vollqualifizierte Produkt-ID (z. B. Online:en:US:Sku123) des zu aktualisierenden Produkts. Schließen Sie nicht mehrere Einträge mit derselben Produkt-ID ein. Zeichenfolge
storeCode Der Code, der den zu aktualisierenden Speicher identifiziert. Legen Sie diese Einstellung auf online fest, um den Preis und die Verfügbarkeit von Produkten im Onlineshop zu aktualisieren. Zeichenfolge

Produkt

Definiert ein Produkt.

Eigenschaft Beschreibung Typ Erforderlich
Verfügbarkeit Die Verfügbarkeit des Produkts. Mögliche Werte:
  • auf Lager
  • nicht mehr vorrätig
  • Preorder
 Zeichenfolge Ja
kind Der Typ des Objekts. Legen Sie auf content#inventory fest. Zeichenfolge Nein
Preis Der neue Preis des Produkts. Geben Sie den Preis in der Währung des Ziellandes oder der Zielregion 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 auf der Webseite des Produkts angezeigten Preis übereinstimmen und 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 des googleProductCategory Produkts ist auf eine der folgenden Kategorien festgelegt:
    • Elektronische > Kommunikation > Telefonie > Mobiltelefone
    • Elektronik > Computer > Tablet Computer
  2. Das Feld des title Produkts enthält eines der folgenden Schlüsselwörter:
    • contract
    • 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
salePrice Der Verkaufspreis des Produkts. 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.

Der Verkaufspreis 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 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:
    • contract
    • 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.
Wenn nicht angegeben, wird der Preis des aktuellen Verkaufs aus dem Angebot entfernt. Übergeben Sie nicht NULL.		 ProductPrice Nein
salePriceEffectiveDate Das UTC-Start- und Enddatum des Verkaufs. Geben Sie nur ein Datum an, wenn Sie festlegen salePrice.

Geben Sie das Anfangs- und Enddatum 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.

Wenn nicht angegeben, wird das Aktuelle Verkaufsdatum aus dem Angebot entfernt. Übergeben Sie nicht NULL.		 Zeichenfolge Nein

ProductPrice

Definiert den Preis oder verkaufspreis eines Produkts.

Name Wert Typ
Währung Die Währung, in der der Preis angegeben ist. Mögliche Werte:
  • AUD (Australischer Dollar)
  • CAD (Kanadischer Dollar)
  • CHF (Schweizer Franken)
  • EUR (Euro)
  • GBP (Britisches Pfund)
  • INR (Indische Rupien)
  • SEK (Schwedische Krone)
  • USD (USA Dollar)
 Zeichenfolge
Wert Der Preis des Produkts. Gleitkommawert mit doppelter Genauigkeit

HTTP-Statuscodes

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

Statuscode Beschreibung
200 Erfolg.
400 Ungültige Anforderung. Entweder ist ein Abfrageparameterwert ungültig, oder etwas im Anforderungstext ist ungültig.

Wenn ein Fehler auftritt, enthält der fehlgeschlagene Batcheintrag die Fehler.
401 Unbefugt. Die Anmeldeinformationen des Benutzers sind ungültig.
403 Verboten. Der Benutzer verfügt nicht über Berechtigungen zum Verwenden der Ressource.
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.