Share via


API Best Practices

Im Folgenden werden die empfohlenen bewährten Methoden aufgeführt.

Products-Ressource

Allgemeine Tipps

  • Minimieren Sie die Anzahl von Anforderungen, die Sie senden, indem Sie nur die Produkte aktualisieren, die sich geändert haben.

  • Geben Sie ein Ablaufdatum für Ihre Produkte an. Ist dies nicht der Fall, laufen die Produkte 30 Tage ab dem Datum ab, an dem Sie sie hinzufügen.

  • Stellen Sie sicher, dass Sie Ihre Produkte aktualisieren, bevor sie ablaufen. Wenn ein Produkt abläuft, müssen Sie es erneut hinzufügen, was zu einer Verzögerung führt, während das Produkt die redaktionelle Überprüfung durchläuft. 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.

Batchtipps

  • Verwenden Sie die Batchverarbeitung, wenn Sie mehr als ein Element verarbeiten. Die Verwendung der Batchverarbeitung reduziert die mit HTTP-Anforderungen verbundenen Mehraufwand. Anstatt die Kosten für jeden Artikel zu verursachen, wenn Sie die Anfragen einzeln senden würden, fallen ihnen die Kosten nur einmal an.

  • Verwenden Sie für Batchvorgänge das Gzip-Komprimierungsschema, um den Anforderungs- und Antworttext zu komprimieren. Wenn Sie die Komprimierung verwenden, schließen Sie den HTTP-Anforderungsheader Content-Encoding ein, und legen Sie ihn auf gzip fest. Die Inhalts-API unterstützt nur die Gzip-Komprimierung.

Lautstärketipps

  • Wenn Sie planen, mehr als 50 Millionen Produkte anzubieten, wenden Sie sich vor dem Erstellen Ihrer Anwendung an Ihren Microsoft-Kundenbetreuer oder technischen Supportmitarbeiter.

Statusressource

  • Der Katalog status Bericht enthält ALLE zuvor hochgeladenen und abgelehnten Angebote in den letzten 30 Tagen. Da die Größe des Berichts je nach Aktivität sehr groß sein kann, sollten Sie die Häufigkeit, mit der Sie ihn anfordern, auf stündlich beschränken.