Wie erhalte ich den Status von Produktangeboten?

  • Artikel

Wenn Sie ein Produktangebot in einem Katalog oder Store hinzufügen oder aktualisieren, durchläuft das Angebot eine erste Überprüfung, bevor es die redaktionelle Überprüfung durchläuft. Dieser Prozess kann bis zu 36 Stunden dauern. Verwenden Sie die Ressource Status , um festzustellen, ob das Angebot den Überprüfungsprozess bestanden hat.

Hinweis

Eine Liste der Produkte, deren status auf "Abgelehnt" oder "Warnung" festgelegt ist, finden Sie unter Abrufen der status Ihrer Produktangebote.

Im Folgenden finden Sie den Basis-URI, den Sie zum Abrufen der Status Ressource verwenden.

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

Fügen Sie die folgende Vorlage an den Basis-URI an, um die status von Produktangeboten abzurufen.

{bmcMerchantId}/catalogs/{catalogId}/status

Legen Sie {bmcMerchantId} auf Ihre BMC-Store-ID und auf die ID des Katalogs fest{catalogId}, der die Produktangebote enthält, deren status Sie abrufen möchten.

Jede HTTP-Anforderung muss das OAuth-Zugriffstoken des Benutzers und Ihr Entwicklertoken enthalten. Um das Zugriffstoken des Benutzers anzugeben, legen Sie den AuthenticationToken-Header fest. Um Ihr Entwicklertoken anzugeben, legen Sie den DeveloperToken-Header fest.

Wenn Sie Kataloge im Namen anderer Kunden verwalten, müssen Sie Folgendes festlegen:

  • Der CustomerId-Header zur Kunden-ID des Kunden, dessen Geschäft Sie verwalten.
  • Der CustomerAccountId-Header auf die Konto-ID eines der Konten des Kunden, die Sie verwalten (es spielt keine Rolle, welches verwaltete Konto verwendet wird).

Sie müssen weder das Zugriffstoken noch das Entwicklertoken angeben, um den Bericht herunterzuladen. Sie müssen sie nur angeben, um die status zu erhalten.

Standardmäßig verwendet die Inhalts-API JSON-Objekte, um die status darzustellen. Um XML zu verwenden, legen Sie den Abfrageparameter alt auf XML fest.

Senden Sie eine HTTP GET-Anforderung an die resultierende URL. Die Antwort enthält ein Status-Objekt , das die Anzahl der Angebote enthält, die den Überprüfungsprozess in den letzten 30 Tagen bestanden oder fehlgeschlagen haben. Wenn ein Angebot bei der Überprüfung nicht erfolgreich war, enthält die Status Ressource eine URL, die Sie zum Herunterladen eines Berichts verwenden können, der beschreibt, warum das Angebot fehlgeschlagen ist.

Im Folgenden sehen Sie ein Beispielobjekt Status .

{
  "catalogId": 12345,
  "publishedCount": 80,
  "rejectedCount": 6,
  "rejectionReportUrl": "https://merchantcenter.bingads.microsoft.com/api/Public/DownloadFeedReport?token=..."
}

Der Bericht identifiziert das fehlgeschlagene Angebot, stellt jedoch nicht den Zeitstempel oder die Informationen zur Versionskontrolle bereit, mit denen Sie ermitteln können, auf welche der Updates sich der Bericht bezieht. Wenn Sie beispielsweise vor 2 Tagen ein Angebot hochgeladen und dann gestern aktualisiert haben, wissen Sie nicht, ob das Problem mit der Version zusammenhängt, die vor 2 Tagen hochgeladen wurde, oder mit der version, die gestern hochgeladen wurde. Sie können jedoch die Attribute des Elements in der Spalte Angebotsausschnitt des Berichts verwenden, um abzuleiten, welche Version des Elements gemeldet wird.

Da die Berichtsdatei ZIP-komprimiert ist, müssen Sie die Datei entzippen, um den Bericht zu lesen. Die Anzahl der Berichte, die das System speichern kann, ist nicht begrenzt. Die Dauer, in der die Berichte gespeichert werden, ist jedoch nicht definiert. Informationen zum Inhalt des Berichts finden Sie unter Berichtsformat.

Abhängig von der Aktivität, die dem Katalog zugeordnet ist, kann der Bericht groß sein. Sie sollten den Bericht nicht mehr häufig als erforderlich anfordern. Das empfohlene Intervall ist nicht mehr als einmal pro Stunde.

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

Im Folgenden sehen Sie einen Beispielbericht.

"Catalog Name","Catalog Id","Store Id","Upload Time"
"Default Catalog","1234","5678","04/21/2016 01:59:06"

"Item Id","Message","Type","Values","Offer Snippet"
"SKU1234","The product URL should be a sub-path of the store's domain. ","Error","",";eBay Motors>Parts & Accessories>Car & Truck Parts>Brakes>Brake Hoses>;http://contentapis.cloudapp.net/sku123;http://i.ebayimg.com/00/s/NzY4WDI5Mg==/z/irkAAOxyB9RS14Rj/$_1.JPG?set_id=880000500F;24.25;-1;;"
"SKU5678","The product URL should be a sub-path of the store's domain. ","Error","",";;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=Ma8674a23cc755995efecf822b3836f07o0&pid=Api;1205;-1;;"
"SKU0987","The product URL should be a sub-path of the store's domain. ","Error","",";Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1;-1;;"
"SKU6543","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"
"SKU2435","The offer expiration date is in the past.","Error","","full product title;Apparel & Accessories > Clothing > Outerwear;http://v-vagancclaimedapi.cloudapp.net/;http://google.com/;1.00"
"SKU8675","The price field is required.","Error","","Mens T-shirt;N/A;http://www.contoso.com/;https://tse3.mm.bing.net/th?id=OIP.Ma8674a23cc755995efecf822b3836f07o0&pid=Api;N/A"