Freigeben über

Verwaltung von Shipping-Labels

  • Artikel

Verwenden Sie die folgenden Methoden zur Verwaltung der Shipping-Labels für Ihre Einreichungen über das Windows Hardware-Dashboard. Eine Einführung in die Hardware Dashboard-APIs von Microsoft, einschließlich der Voraussetzungen für die Verwendung der API, finden Sie unter Hardware Dashboard-API.

https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

Methoden zur Verwaltung von Shipping-Labels

Beschreibung Method URI
Erstellen eines neuen Shipping-Labels NACHRICHT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels
Aktualisieren eines Shipping-Labels PATCH https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId}
Stornieren eines Shipping-Labels PUT https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels/{shippingLabelId/cancel}

Erstellen eines neuen Shipping-Labels

  1. Falls Sie dies noch nicht getan haben, erfüllen Sie alle Voraussetzungen für die Microsoft Hardware-APIs.

  2. Erhalten eines Microsoft Entra ID-Zugriffstokens. Sie müssen dieses Zugriffstoken an die Methoden in der Microsoft Store-Übermittlungs-API übergeben. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

  3. Um ein Shipping-Label erstellen zu können, sollten Sie ein Produkt und eine Einreichung erstellt haben. Siehe Produkteinreichungen verwalten für Details zum Erstellen eines Produkts und einer Einreichung.

  4. Erstellen Sie ein neues Shipping-Label für diese Vorlage, indem Sie die folgende Methode ausführen. Verwenden Sie die ProductID und SubmissionID, die im vorherigen Schritt unter Produkteinreichungen verwalten erstellt wurden.

    https://manage.devcenter.microsoft.com/v2.0/my/hardware/products/{productid}/submissions/{submissionid}/shippingLabels

    Der Antwort-Body enthält eine Ressource Shipping-Label, die die ID für das neu erstellte Shipping-Label und andere Details enthält.

Codebeispiele

Das folgende Code-Beispiel zeigt Ihnen, wie Sie die Microsoft Hardware-API verwenden können:

Datenressourcen

Die Methoden der Microsoft Hardware-APIs zur Erstellung und Verwaltung von Produktdaten verwenden die folgende JSON-Datenressource:

Fehlercodes

Informationen über Fehlercodes finden Sie unter Fehlercodes.

Weitere Informationen