Hardware-Dashboard-API
Verwenden Sie die Microsoft Hardware-APIs, um Hardwareprodukte innerhalb des Partner Center-Kontos Ihrer Organisation programmgesteuert abzufragen und einzureichen. Diese APIs sind nützlich, wenn Ihr Konto viele Produkte verwaltet und Sie den Einreichungsprozess für diese Assets automatisieren und optimieren möchten. Diese APIs verwenden Microsoft Entra ID (Microsoft Entra ID), um die Aufrufe Ihrer App oder Ihres Dienstes zu authentifizieren. Die folgenden Schritte beschreiben den End-to-End-Prozess der Verwendung der Microsoft Hardware-API:
Diese APIs können nur von Konten verwendet werden, die dem Hardware Partner Center-Programm angehören.
Vergewissern Sie sich, dass Sie die unten aufgeführten Voraussetzungen erfüllt haben.
Bevor Sie eine Methode der Microsoft Hardware-API aufrufen, besorgen Sie sich ein Microsoft Entra ID-Token für den Zugriff, wie unten dargestellt. Nach dem Abruf eines Tokens können Sie es für einen Zeitraum von 60 Minuten in Aufrufen der Microsoft Store-Übermittlungs-API verwenden, bevor es abläuft. Nach Ablauf des Tokens können Sie ein neues Token generieren.
Rufen Sie die Microsoft Hardware-API auf.
Erfüllung der Voraussetzungen für die Verwendung der Microsoft Hardware-API
Bevor Sie mit dem Schreiben von Code für den Aufruf der Microsoft Hardware-API beginnen, sollten Sie sicherstellen, dass Sie die folgenden Anforderungen erfüllt haben.
Sie (oder Ihre Organisation) müssen über ein Microsoft Entra ID-Verzeichnis verfügen und Sie müssen die Berechtigung Globaler Administrator für dieses Verzeichnis haben. Wenn Sie bereits Microsoft 365 oder andere Dienste von Microsoft für Unternehmen nutzen, verfügen Sie bereits über ein Microsoft Entra ID-Verzeichnis. Andernfalls können Sie eine neue Microsoft Entra ID im Partner Center ohne zusätzliche Kosten erstellen.
Wenn eine Microsoft Entra ID-Anwendung noch nicht existiert, müssen Sie eine erstellen.
Sie müssen eine Microsoft Entra ID-Anwendung mit Ihrem Partner Center-Konto verknüpfen und ihr die Rolle Manager zuweisen.
Ermitteln Sie Ihre Microsoft Entra ID-Anwendung, die Mandanten-ID, die Client-ID und den Schlüssel. Stellen Sie sicher, dass Sie diese Schlüsselinformationen ausdrucken oder kopieren, da Sie nicht mehr darauf zugreifen können, nachdem Sie die Seite zur Schlüsselerstellung verlassen haben.
Zuweisung der entsprechenden Hardware-Rollen zu Ihrer Microsoft Entra ID-Anwendung
Nachdem Sie die oben genannten Voraussetzungen erfüllt haben, müssen wir nun die entsprechenden Rollen zuweisen, sodass die Microsoft Entra ID-Anwendung Einreichungen und Shipping-Labels erstellen und verwalten kann.
Wählen Sie im Partner Center das Symbol mit dem Zahnrad (in der Nähe der oberen rechten Ecke des Dashboards) und wählen Sie dann Entwicklereinstellungen. Wählen Sie im Menü Einstellungen die Option Benutzer aus.
Auf der Seite Benutzer wählen Sie Microsoft Entra ID-Anwendungen und die Microsoft Entra ID-Anwendung, die für die App oder den Dienst steht, die/den Sie für den Zugriff auf Einreichungen für Ihr Partner Center-Konto verwenden werden.
Wählen Sie auf dieser Seite unter Rollen die Option Hardware.
Wählen Sie Treiber-Einreicher, Besitzer des Labels und, falls verfügbar, Promoter des Labels. Erfahren Sie mehr über diese Rollen
Erhalten eines Microsoft Entra ID-Zugriffstokens
Bevor Sie eine der Methoden der Microsoft Hardware API aufrufen, müssen Sie zunächst ein Microsoft Entra ID-Zugriffstoken erhalten, das Sie an den Authorization-Header jeder Methode der 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 es aktualisieren, sodass Sie es bei weiteren Aufrufen der API weiter verwenden können. Um das Zugriffstoken zu erhalten, folgen Sie den Anweisungen in Aufrufe von Dienst zu Dienst mit Anmeldeinformationen des Clients, um einen HTTP-POST an den https://login.microsoftonline.com/<tenant_id>/oauth2/token-Endpunkt zu senden. Hier ist eine Beispielanforderung:
POST https://login.microsoftonline.com/<tenant_id>/oauth2/token HTTP/1.1
Host: login.microsoftonline.com
Content-Type: application/x-www-form-urlencoded; charset=utf-8
grant_type=client_credentials
&client_id=<your_client_id>
&client_secret=<your_client_secret>
&resource=https://manage.devcenter.microsoft.com
Für den Wert Mandant_id im POST-URI und die Parameter Client_id und Client_secret geben Sie die ID des Mandanten, die ID des Clients und den Schlüssel für Ihre Anwendung an, den Sie im vorherigen Abschnitt vom Partner Center erhalten haben. Für den Parameter resource müssen Sie https://manage.devcenter.microsoft.com angeben.
Nachdem Ihr Zugriffstoken abgelaufen ist, können Sie es aktualisieren, indem Sie die Anweisungen unter Zugriffstoken aktualisieren befolgen.
Verwenden der Microsoft Hardware-API
Nachdem Sie über einen Microsoft Entra ID-Zugriffstoken verfügen, können Sie die Methoden der Microsoft Hardware-API aufrufen. Die API enthält viele Methoden, die in Szenarien gruppiert sind. Um Einreichungen zu erstellen oder zu aktualisieren, rufen Sie in der Regel mehrere Methoden in der Microsoft Hardware-API in einer bestimmten Reihenfolge auf. Informationen zu den einzelnen Szenarien und der Syntax der einzelnen Methoden finden Sie in den Artikeln der folgenden Tabelle.
| Szenario | Beschreibung |
|---|---|
| Treiber | Sie können Treiber abrufen, erstellen und aktualisieren, die in Ihrem Partner Center-Konto registriert sind. Weitere Informationen zu diesen Methoden finden Sie in den folgenden Artikeln: |
Codebeispiele
Das folgende Beispiel enthält detaillierten Code, der die Verwendung der Microsoft Hardware-API zusammen mit einer vollständigen, vom Microsoft Surface and Devices Team erstellten End-to-End-Lösung demonstriert:
Weitere Hilfe
Wenn Sie Fragen zur Microsoft Store Einreichungs-API haben oder Hilfe bei der Verwaltung Ihrer Einreichungen mit dieser API benötigen, besuchen Sie die Support-Seite und fordern Sie Hilfe an.