Freigeben über


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.