Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Pomocí rozhraní API Microsoftu programově dotazovat a vytvářet odesílání pro hardwarové produkty v účtu Partnerského centra vaší organizace. Tato rozhraní API jsou užitečná, pokud váš účet spravuje mnoho produktů a chcete automatizovat a optimalizovat proces odesílání pro tyto zdroje. Tato rozhraní API používají Microsoft Entra ID (Microsoft Entra ID) k ověření volání z vaší aplikace nebo služby.
Rozhraní API hardwarového řídicího panelu můžou používat jenom účty, které patří do programu Partnerské centrum hardwaru. Tady je kompletní proces používání rozhraní Microsoft Hardware API:
Dokončete požadavky v další části.
Před voláním metody v rozhraní Microsoft Hardware API získejte přístupový token Microsoft Entra ID. Jakmile získáte token, máte 60 minut na jeho použití při volání do rozhraní API pro odeslání do Microsoft Storu, než token vyprší. Po vypršení platnosti tokenu můžete vygenerovat nový.
Volejte rozhraní MICROSOFT HARDWARE API.
Splnění požadavků pro použití rozhraní Microsoft Hardware API
Než začnete psát kód pro volání rozhraní Microsoft Hardware API, musíte splnit tyto požadované požadavky:
You (or your organization) must have a Microsoft Entra ID directory and you must have Global administrator permission for the directory. Pokud už používáte Microsoft 365 nebo jiné obchodní služby od Microsoftu, už máte adresář Microsoft Entra ID. Jinak můžete vytvořit nové ID Microsoft Entra v Partnerském centru bez dalších poplatků.
Pokud aplikace Microsoft Entra ID ještě neexistuje, musíte vytvořit jeden.
Aplikaci Microsoft Entra ID musíte přidružit k účtu Partnerského centra a přiřadit ji roli Manager.
Shromážděte ID tenanta aplikace Microsoft Entra ID, ID klienta a klíč. Nezapomeňte tyto informace o klíči vytisknout nebo zkopírovat, protože po opuštění stránky pro vytvoření klíče k němu nebudete mít přístup znovu.
Přiřazení odpovídajících hardwarových rolí k aplikaci Microsoft Entra ID
Po dokončení požadavkůpřiřaďte příslušné role, aby aplikace Microsoft Entra ID mohla vytvářet a spravovat odesílání a expediční štítky.
From Partner Center, select the gear icon (near the upper right corner of the dashboard) and then select Developer settings. In the Settings menu, select Users.
On the Users page, select Microsoft Entra ID applications and the Microsoft Entra ID application that represents the app or service you use to access submissions for your Partner Center account.
On this page, under Roles, select Hardware.
Select Driver Submitter, Shipping Label owner, and if available, Shipping Label promoter. Další informace o těchto rolích
Získání přístupového tokenu Microsoft Entra ID
Before you call any of the methods in the Microsoft Hardware API, you must first obtain a Microsoft Entra ID access token that you pass to the Authorization header of each method in the API. Po získání přístupového tokenu ho budete mít 60 minut, než vyprší jeho platnost. Po vypršení platnosti tokenu můžete token aktualizovat, abyste ho mohli dál používat při dalších voláních rozhraní API. Pokud chcete získat přístupový token, postupujte podle pokynů v části Volání služby do služby pomocí přihlašovacích údajů klienta k odeslání protokolu HTTP POST do koncového bodu https://login.microsoftonline.com/<tenant_id>/oauth2/token. Tady je ukázkový požadavek.
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
For the tenant_id value in the POST URI and the client_id and client_secret parameters, specify the tenant ID, client ID, and the key for your application that you retrieved from Partner Center in the previous section. For the resource parameter, you must specify https://manage.devcenter.microsoft.com.
Po vypršení platnosti přístupového tokenu ho můžete aktualizovat podle pokynů v části Aktualizace přístupových tokenů.
Použití rozhraní Microsoft Hardware API
Jakmile budete mít přístupový token Microsoft Entra ID, můžete volat metody v rozhraní Microsoft Hardware API. Rozhraní API obsahuje mnoho metod seskupených do scénářů. Chcete-li vytvářet nebo aktualizovat podání, obvykle voláte v rozhraní Microsoft Hardware API více metod v určitém pořadí. Informace o jednotlivých scénářích a syntaxi jednotlivých metod najdete v článcích v následující tabulce.
| Scenario | Description |
|---|---|
| Drivers | Získejte, vytvořte a aktualizujte ovladače zaregistrované v účtu Partnerského centra. Další informace o těchto metodách najdete v následujících článcích: |
Code sample
Následující ukázka kódu poskytuje kompletní předem připravené řešení vytvořené týmem Microsoft Surface a Devices:
More help
If you have questions about the Microsoft Store submission API or need assistance managing your submissions with this API, visit the support page and request help.