ユーザー Store ID キーを更新する

[アーティクル]
06/20/2024

ユーザー Store ID キーを更新する方法を説明します。

ユーザー Store ID キーを生成する場合、有効期間は 30 日です。有効期間が 30 日以内であれば、キーは Microsoft Store サービスの認証を受けられます。トークンを更新して、同じ Entra アプリケーションクライアント ID とユーザー ID に対して新しいユーザー Store ID を生成することもできます。ユーザー Store ID は Store サービスを 30 日間呼び出すときに受けられますが、有効期間全体で更新できることを保証するものではありません。これらのキーに使用される署名証明書は頻繁にローテーションされます。署名証明書が古すぎると、ユーザー Store ID の更新時に拒否されます。そのため、キャッシュされたユーザー Store ID の更新を計画している場合は、少なくとも 14 日ごとに更新することをお勧めします。これにより、最新の署名証明書が使用され、新しいユーザー Store ID が今後 14 日以内に再び更新できるようになります。

前提条件

ユーザー Store ID キーを更新するには、次の条件があります:

対象ユーザーの URI 値 https://onestore.microsoft.com を持つ Microsoft Entra ID アクセストークン
アプリのクライアント側コードから生成された有効期限切れの Microsoft Store ID キー。

詳細については、「サーバー間認証にユーザー Store ID を要求する」を参照してください。

要求

要求の構文

キーの種類	メソッド	要求 URI
`Collections`	`POST`	`https://collections.mp.microsoft.com/v6.0/b2b/keys/renew`
`Purchase`	`POST`	`https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew`

要求ヘッダー

ヘッダー	型	説明
`Host`	`string`	値 `collections.mp.microsoft.com` または `purchase.mp.microsoft.com` を設定する必要があります。
`Content-Length`	`number`	要求本文の長さ。
`Content-Type`	`string`	要求と応答の種類を指定します。現在唯一サポートされている値は `application/json` です。

リクエストの本文

パラメーター	型	説明	必須
`serviceTicket`	`string`	Microsoft Entra ID サービスアクセストークン	はい
`key`	`string`	有効期限が切れた 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..."
}

応答

応答の本文

パラメーター	型	説明
`key`	`string`	以降の Microsoft Store コレクション API または Microsoft Store 購入 API の呼び出しで使用できる、更新されたユーザー Store ID キー。

応答の例

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2019 07:31:12 GMT

{
    "key":"eyJ0eXAi..."
}

状況コード

コード	エラー	内部エラーコード	説明
401	未承認	`AuthenticationTokenInvalid`	Microsoft Entra ID アクセストークンが無効です。場合によっては、`ServiceError` の詳細に追加情報が含まれていることがあります (トークンの有効期限切れや `appid` 要求の欠落など)。
401	未承認	`InconsistentClientId`	ユーザー Store ID キーの `clientId` 要求と Microsoft Entra ID アクセストークンの `appid` 要求が一致しません。

次の方法で共有