Microsoft Store ID キーを更新する
Microsoft Store キーを更新するには、このメソッドを使用します。 Microsoft Store ID キーを生成すると、キーは 30 日間有効です。 キーの有効期限が切れる前に、このメソッドを使用して新しいキーを再ネゴシエーションするために使用できます。
Microsoft.StoreServices ライブラリ は、UserStoreId.RefreshStoreId API を介してこのメソッドの機能を提供します。
手記
以前は、Microsoft Store キーの有効期間が長く、キーの有効期限が既に切れた後に更新できる場合がありました。 現時点では、開発者は有効期間中にのみキーが更新可能であると想定し、有効期限が切れる前にキーを更新するために、キーの有効期限をメモする必要があります。
重要
Microsoft Store キーは有効期限が切れる前に更新できますが、セキュリティ上の懸念に応じて、有効期限が切れる前にキーが取り消される可能性があります。 そのため、AuthenticationTokenInvalid で更新の試行が失敗した場合は、サービスで処理する必要があります。 この場合、クライアント上のユーザーまたは元の Microsoft Store キーの生成に使用されるメソッドに対して、新しい Microsoft Store キーを生成する必要があります。
前提 条件
このメソッドを使用するには、次のものが必要です。
- 対象ユーザー URI 値が
https://onestore.microsoft.com/.defaultされる Entra ID アクセス トークン。 - アプリのクライアント側コードから生成された期限切れの Microsoft Store ID キー
。
詳細については、「サービスから製品の権利を管理する」を参照してください。
依頼
要求の構文
| キーの種類 | 方式 | 要求 URI |
|---|---|---|
| コレクション | POST | https://collections.mp.microsoft.com/v6.0/b2b/keys/renew |
| Purchase | POST | https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew |
要求ヘッダー
| ヘッダ | 種類 | 説明 |
|---|---|---|
| Host | 糸 | 値 collections.mp.microsoft.com または purchase.mp.microsoft.com に設定する必要があります。 |
| Content-Length | 数値 | 要求本文の長さ。 |
| Content-Type | 糸 | 要求と応答の種類を指定します。 現在、サポートされている唯一の値は application/json |
要求本文
| パラメーター | 種類 | 説明 | 必須 |
|---|---|---|---|
| serviceTicket | 糸 | Entra ID アクセス トークン。 | はい |
| 鍵 | 糸 | 期限切れの Microsoft Store ID キー。 | はい |
要求の例
POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com
{
"serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb….",
"Key": "eyJ0eXAiOiJKV1QiLCJhbG…."
}
応答
応答本文
| パラメーター | 種類 | 説明 |
|---|---|---|
| 鍵 | 糸 | Microsoft Store コレクション API または購入 API の今後の呼び出しで使用できる、更新された Microsoft Store キー。 |
応答の例
HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT
{
"key":"eyJ0eXAi….."
}
エラー コード
| コード | エラー | 内部エラー コード | 説明 |
|---|---|---|---|
| 401 | 未認可 | 認証トークンが無効です | 更新中の Entra ID アクセス トークンまたは Microsoft Store キーが無効です。 場合によっては、トークンの有効期限が切れている場合や、appid 要求が見つからない場合など、ServiceError の詳細に詳細情報が含まれる場合があります。 |
| 401 | 無許可 | 一貫性のないクライアントID | Microsoft Store ID キーの clientId の要求と、Entra ID アクセス トークンの appid の要求が一致しません。 |
関連トピック
- サービス から製品の権利を管理する
- 製品検索クエリ
- コンシューマブルな製品をフルフィルメント完了として報告する
- 無料製品 を付与する
- Microsoft.StoreServices ライブラリ (GitHub)