Statusressource

Mit der Ressource Status können Sie die status von Produktangeboten abrufen, die Sie in den angegebenen Katalog hochgeladen haben. Nachdem Sie Angebote in den Katalog hochgeladen haben, durchlaufen sie einen Validierungs- und redaktionellen Überprüfungsprozess. Dieser Vorgang kann bis zu 36 Stunden dauern. Das Angebot wird erst nach Abschluss des Überprüfungsprozesses in den Bericht aufgenommen.

Eine Übersicht über die Funktionsweise des Prozesses finden Sie unter Wie erhalte ich den Status von Produktangeboten?

Ein Codebeispiel, das zeigt, wie Sie die status des Katalogs abrufen und den Bericht herunterladen, finden Sie unter Herunterladen des Katalogstatusberichts.

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 Abrufen der status von Produktangeboten in einem Katalog verwendet werden, fügen Sie die entsprechende Vorlage an den Basis-URI an.

Hinweis

{bmcMerchantId}/catalogs/{catalogId}/status ist veraltet und wird nicht empfohlen.

Vorlage	HTTP-Verb	Beschreibung	Ressource
{bmcMerchantId}/catalogs/{catalogId}/status	GET	Verwenden Sie , um die Anzahl der hochgeladenen Angebote abzurufen, die die Validierung und die redaktionelle Überprüfung bestanden oder nicht bestanden haben. Legen Sie auf die MMC-Speicher-ID fest {bmcMerchantId} . Legen Sie auf die ID des Katalogs fest {catalogId} .	Anforderung: N/A Antwort: Status

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.

Header

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

Header	Beschreibung
Accept	Anforderungsheader.<p>Fügen Sie diesen Header ein, wenn Sie den Bericht herunterladen. Sie müssen diesen Header auf application/x-zip-compressedfestlegen.
AuthenticationToken	Anforderungsheader. Legen Sie diesen Header auf ein OAuth-Authentifizierungstoken fest. Informationen zum Abrufen eines Tokens 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.
CustomerAccountId	Anforderungsheader. Die Konto-ID eines der Konten, die 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 Entwicklerzugriffstoken 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 die Details zur 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
Status	Definiert die status der Produktangebote, die in den Katalog hochgeladen wurden.

Status

Definiert die status der Produktangebote, die in den Katalog hochgeladen wurden. Der XML-Name des Objekts lautet <catalogStatus>.

Name	Wert	Typ	XML-Elementname
catalogId	Die ID des gemeldeten Katalogs.	ulong	<catalog_id>
publishedCount	Die Anzahl der Angebote, die validierung und redaktionelle Überprüfung bestanden haben.	ulong	<published_count>
rejectedCount	Die Anzahl der Angebote, bei denen die Validierung und die redaktionelle Überprüfung fehlgeschlagen sind. Diese Anzahl gibt die Anzahl der Zeilen im Textkörper des Berichts an (siehe Berichtsformat).	ulong	<rejected_count>
rejectionReportUrl	Die URL, die Sie zum Herunterladen des Berichts verwenden. Das -Objekt enthält dieses Feld nur, wenn rejectedCount größer als 0 (null) ist. Der Bericht ist komprimiert und muss entzippt werden, bevor Sie ihn lesen können.	string	<catalog_id>

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 die Berichts-URL (siehe ablehnungReportUrl) ist nicht mehr gültig.
401	Unbefugt. Die Anmeldeinformationen des Benutzers sind ungültig.
404	Nicht gefunden. Entweder status für den angegebenen Katalog nicht verfügbar ist, oder die Katalog- oder Speicher-ID ist ungültig.
500	Serverfehler.

Berichtsformat

Die heruntergeladene Berichtsdatei befindet sich in einem komprimierten Zip-Ordner (*.zip). Sie müssen den Ordner und seinen Inhalt entzippen, bevor Sie den Bericht lesen können. Der Bericht ist eine durch Trennzeichen getrennte Datei namens MerchantCatalogReport.csv.

Der Bericht ist in einen Kopfzeilenabschnitt und einen Berichtstextabschnitt unterteilt. Die erste Zeile enthält die folgenden Spaltennamen für den Kopfzeilenabschnitt.

Spaltenname	Beschreibung
Katalogname	Der Name des Katalogs.
Katalog-ID	Die ID des Katalogs.
Store-ID	Die ID des Speichers, der den Katalog enthält.
Uploadzeit	Nicht verwenden. Wenn dieses Feld vorhanden ist, ignorieren Sie es.

Die zweite Zeile enthält die Headerdaten.

Die dritte Zeile ist leer.

Die vierte Zeile enthält die folgenden Spaltennamen für den Berichtstext, der in der fünften Zeile beginnt.

Spaltenname	Beschreibung
Element-ID	Die offerId des Angebots, bei dem die Validierung oder die redaktionelle Überprüfung fehlgeschlagen ist. Der Bericht enthält eindeutige IDs.
Nachricht	Der gemeldete Fehler.
Typ	Der Fehlertyp. Die möglichen Werte sind Fehler oder Warnung.
Werte	Der Datenwert, der den Fehler verursacht hat, wenn der Fehler durch einen ungültigen Wert verursacht wurde.
Angebotsausschnitt	Eine durch Semikolons getrennte Liste der Teilmenge der Angebotsdaten. Das Format ist titel; productType; Link; imageLink; Preis; salePrice; saleStartDate; saleEndDate. Nicht alle Fehler enthalten alle Komponenten.

Ein Beispiel für den Bericht finden Sie unter Beispielbericht.