Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
Kuruluşunuzun İş Ortağı Merkezi hesabındaki donanım ürünlerini program aracılığıyla sorgulamak ve oluşturmak için Microsoft Donanım API'lerini kullanın. Hesabınız birçok ürünü yönetiyorsa ve bu varlıklar için gönderim sürecini otomatikleştirmek ve iyileştirmek istiyorsanız bu API'ler yararlıdır. Bu API'ler, uygulama veya hizmetinizden gelen çağrıların kimliğini doğrulamak için Microsoft Entra Id (Microsoft Entra ID) kullanır.
Yalnızca Donanım İş Ortağı Merkezi programına ait olan hesaplar donanım panosu API'lerini kullanabilir. İşte Microsoft Donanım API'sini kullanmanın uçtan uca işlemi:
Sonraki bölümde önkoşulları tamamlayın.
Microsoft Donanım API'sinde bir yöntem çağırmadan önce bir Microsoft Entra ID erişim belirteci alın. Belirteciniz olduktan sonra, belirtecin süresi dolmadan önce Microsoft Store gönderim API'sine yapılan çağrılarda kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra yeni bir tane oluşturabilirsiniz.
Microsoft Donanım API'sini çağırın.
Microsoft Donanım API'sini kullanma önkoşullarını tamamlayın
Microsoft Donanım API'sini çağırmak için kod yazmaya başlamadan önce şu gerekli önkoşulları tamamlamanız gerekir:
You (or your organization) must have a Microsoft Entra ID directory and you must have Global administrator permission for the directory. Microsoft 365'i veya Microsoft'un diğer iş hizmetlerini zaten kullanıyorsanız, Microsoft Entra Id dizininiz zaten vardır. Aksi takdirde, ek ücret ödemeden İş Ortağı Merkezi yeni bir Microsoft Entra Id oluşturabilirsiniz.
Microsoft Entra ID uygulaması yoksa, biroluşturmanız gerekir.
bir Microsoft Entra ID uygulamasını İş Ortağı Merkezi hesabınızla ilişkilendirmeniz ve uygulamayı Yönetici rolüne atamanız gerekir.
Microsoft Entra ID uygulama kiracı kimliğinizi, istemci kimliğinizi ve anahtarınızıtoplayın. Anahtar oluşturma sayfasından ayrıldıktan sonra yeniden erişemeyeceğiniz için bu anahtar bilgilerini yazdırdığınızdan veya kopyaladığınızdan emin olun.
Microsoft Entra ID uygulamanıza uygun Donanım rollerini atama
önkoşulları tamamladıktansonra, Microsoft Entra ID uygulamasının gönderimleri ve gönderim etiketlerini oluşturup yönetebilmesi için uygun rolleri atayın.
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. Bu roller hakkında daha fazla bilgi edinin
Microsoft Entra ID erişim belirteci alma
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. Erişim belirtecini aldıktan sonra süresi dolmadan önce kullanmak için 60 dakikanız olur. Belirtecin süresi dolduktan sonra belirteci yenileyebilir, böylece API'ye yapılan diğer çağrılarda bu belirteci kullanmaya devam edebilirsiniz. Erişim belirtecini almak için, uç noktasına HTTP POST göndermek için https://login.microsoftonline.com/<tenant_id>/oauth2/token yönergeleri izleyin. İşte örnek bir istek.
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.
Erişim belirtecinizin süresi dolduktan sonra erişim belirteçlerini yenileme başlığındaki yönergeleri izleyerek bunu yenileyebilirsiniz.
Microsoft Donanım API'sini kullanma
Microsoft Entra ID erişim belirtecini aldıktan sonra, Microsoft Donanım API'sinde yöntemleri çağırabilirsiniz. API, senaryolar halinde gruplandırılmış birçok yöntem içerir. Gönderimleri oluşturmak veya güncelleştirmek için genellikle Microsoft Donanım API'sinde belirli bir sırada birden çok yöntem çağırırsınız. Her senaryo ve her yöntemin söz dizimi hakkında bilgi için aşağıdaki tabloda yer alan makalelere bakın.
| Scenario | Description |
|---|---|
| Drivers | İş Ortağı Merkezi Hesabınıza kayıtlı sürücüleri alın, oluşturun ve güncelleştirin. Bu yöntemler hakkında daha fazla bilgi için aşağıdaki makalelere bakın: |
Code sample
Aşağıdaki kod örneği, Microsoft Surface ve Devices ekibi tarafından oluşturulmuş eksiksiz bir uçtan uca önceden oluşturulmuş çözüm sağlar:
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.