ハードウェアダッシュボードAPI
組織のパートナー センター アカウント内でハードウェア製品の申請をプログラムで照会したり、作成したりするには、Microsoft Hardware API を使用します。 これらの API は、アカウントで多数の製品を管理しており、これらのアセットの送信プロセスを自動化および最適化したい場合に役立ちます。 これらの API は、Microsoft Entra ID (Microsoft Entra ID) を使用して、アプリまたはサービスからの呼び出しを認証します。
ハードウェア ダッシュボード API を使用できるのは、ハードウェア パートナー センター プログラム に属するアカウントのみです。 Microsoft ハードウェア API を使用するエンド ツー エンドのプロセスを次に示します。
次のセクションの前提条件を完了します。
Microsoft ハードウェア API でメソッドを呼び出す前に、Microsoft Entra ID アクセス トークンを取得します。 トークンを取得したら、トークンの有効期限が切れる前に、Microsoft Store 申請 API の呼び出しでトークンを使用する時間が 60 分になります。 トークンの有効期限が切れた後、新しいトークンを生成できます。
Microsoft ハードウェア API を呼び出します。
Microsoft ハードウェア API を使うための前提条件を満たす
Microsoft Hardware API を呼び出すコードの記述を開始する前に、次の必須の前提条件を満たす必要があります。
あなた (またはあなたの組織) は Microsoft Entra ID ディレクトリを持っている必要があり、そのディレクトリに対する グローバル管理者権限を持っている必要があります。 すでに Microsoft 365 または Microsoft のその他のビジネス サービスを使用している場合は、Microsoft Entra ID ディレクトリがすでにあります。 それ以外の場合 、追加料金なしでパートナー センター で新しい Microsoft Entra ID を作成できます。
Microsoft Entra ID アプリケーションがまだ存在しない場合は、1 つの Microsoft Entra ID アプリケーションを作成する必要があります。
Microsoft Entra ID アプリケーションをパートナー センター アカウント に関連付け 、マネージャー ロールを割り当てる必要があります 。
Microsoft Entra ID アプリケーション テナント ID、クライアント ID、およびキーを収集します。 必ずこのキー情報を印刷またはコピーしてください。このキー作成ページを閉じると、この情報にはアクセスできなくなります。
Microsoft Entra IDアプリケーションへの適切なハードウェアの役割の割り当て
前提条件 を完了後、Microsoft Entra ID アプリケーションが申請と出荷ラベルを作成および管理できるように、適切なロールを割り当てます。
パートナー センターで、歯車アイコン (ダッシュボードの右上隅の近く) を選択し、[開発者向け設定] を選択します。 [設定] メニューで [ユーザー] を選択します。
[ユーザー] ページで、Microsoft Entra ID アプリケーション と、パートナー センター アカウントの申請にアクセスするために使用するアプリまたはサービスを表す Microsoft Entra ID アプリケーションを選択します。
このページで、[Roles]\(役割\) の下の [ハードウェア] を選択します。
[Driver Submitter]\(ドライバーの送信者\)、[Shipping Label owner]\(配送先住所ラベルの所有者\)、(使用できる場合は) [Shipping Label promoter]\(配送先住所ラベルのプロモーター\) を選択します。 これらのロールに関する詳細情報
Microsoft Entra IDアクセス トークンを取得する
Microsoft Hardware API のメソッドを呼び出す前に、まず Microsoft Entra ID アクセス トークンを取得し、API の各メソッドの Authorization ヘッダーに渡す必要があります。 アクセス トークンを取得した後、アクセス トークンを使用できるのは、その有効期限が切れるまでの 60 分間です。 トークンの有効期限が切れた後は トークンを更新してそれ以降の API 呼び出しで引き続き使用できます。 アクセス トークンを取得するには、「クライアント資格情報を使用したサービス間の呼び出し」の手順に従って、HTTP POST を https://login.microsoftonline.com/<tenant_id>/oauth2/token
エンドポイントに送信します。 要求の例を次に示します。
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
POST URI の tenant_id 値と、client_id パラメーターと client_secret パラメーターに、前のセクションでパートナー センターから取得したアプリケーションのテナント ID、クライアント ID、およびキーを指定します。 resource パラメーターには、https://manage.devcenter.microsoft.com
を指定します。
アクセストークンの有効期限が切れたら アクセストークン の更新 の手順に従って更新できます。
Microsoft ハードウェア API を使用する
Microsoft Entra ID アクセス トークンを取得したら、Microsoft ハードウェア API でメソッドを呼び出すことができます。 API には、アプリのシナリオにグループ化された多くのメソッドが含まれています。 送信を作成または更新するには、通常、Microsoft Hardware API の複数のメソッドを特定の順序で呼び出します。 各シナリオと各メソッドの構文の詳細については、次の表の記事を参照してください。
シナリオ | 説明 |
---|---|
ドライバー | パートナー センター アカウントに登録されているドライバーを取得、作成、更新します。 これらの方法の詳細については、次の記事を参照してください。 |
コード サンプル
次のコード サンプルは、Microsoft Surfaceおよびデバイス チームによって作成された完全なエンド ツー エンドの事前構築済みソリューションを提供します。
その他のヘルプ
Microsoft Store 申請 API について質問がある場合や、この API を使った申請の管理に関してサポートが必要な場合は、サポート ページにアクセスしてサポートを要求してください。