ユーザーのサブスクリプションの取得
特定のユーザーが使う権利を持っているサブスクリプション アドオンを取得するには、Microsoft Store 購入 API の以下のメソッドを使います。
注意
このメソッドは、ユニバーサル Windows プラットフォーム (UWP) アプリ用のサブスクリプション アドオンを作成できるように Microsoft がプロビジョニングした開発者アカウントでのみ使うことができます。 現在のところ、サブスクリプション アドオンはほとんどの開発者アカウントで使うことができません。
Microsoft.StoreServices ライブラリは、StoreServicesClient.RecurrenceQueryAsync API を介して、このメソッドの機能を提供します。
前提条件
このメソッドを使用するための要件:
- 対象ユーザー URI の値が
https://onestore.microsoft.comの Azure AD アクセス トークン。 - 取得対象のサブスクリプションを所有するユーザーの ID を表す Microsoft Store ID キー。
詳しくは、「サービスによる製品の権利の管理」をご覧ください。
要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| POST | https://purchase.mp.microsoft.com/v8.0/b2b/recurrences/query |
要求ヘッダー
| Header | 型 | 説明 |
|---|---|---|
| 承認 | string | 必須。 Bearer<トークン> という形式の Azure AD アクセス トークン。 |
| Host | string | 値 purchase.mp.microsoft.com に設定する必要があります。 |
| Content-Length | number | 要求本文の長さです。 |
| Content-Type | string | 要求と応答の種類を指定します。 現時点では、サポートされている唯一の値は application/json です。 |
要求本文
| パラメーター | 型 | 内容 | 必須 |
|---|---|---|---|
| b2bKey | string | 取得対象のサブスクリプションを所有するユーザーの ID を表す Microsoft Store ID キー。 | はい |
| continuationToken | string | ユーザーが複数のサブスクリプションの権利を持っている場合、ページ制限に達すると応答本文は継続トークンを返します。 残りの製品を取得する後続の呼び出しで、この継続トークンを指定します。 | いいえ |
| PageSize | string | 1 つの応答で返すサブスクリプションの最大数。 既定値は 25 です。 | いいえ |
要求の例
次の例は、このメソッドを使って、特定のユーザーが使う権利を持っているサブスクリプション アドオンを取得する方法を示しています。 b2bKey 値は、取得対象のサブスクリプションを持つユーザーの ID を表す Microsoft Store ID キーに置き換えます。
POST https://purchase.mp.microsoft.com/v8.0/b2b/recurrences/query HTTP/1.1
Authorization: Bearer <your access token>
Content-Type: application/json
Host: purchase.mp.microsoft.com
{
"b2bKey": "eyJ0eXAiOiJ..."
}
Response
このメソッドは、ユーザーが使う権利を持っているサブスクリプション アドオンについて説明する、データ オブジェクトのコレクションを含む JSON 応答本文を返します。 次の例は、1 つのサブスクリプションの権利を持っているユーザーの応答本文を示しています。
{
"items": [
{
"autoRenew":true,
"beneficiary":"pub:gFVuEBiZHPXonkYvtdOi+tLE2h4g2Ss0ZId0RQOwzDg=",
"expirationTime":"2017-06-11T03:07:49.2552941+00:00",
"id":"mdr:0:bc0cb6960acd4515a0e1d638192d77b7:77d5ebee-0310-4d23-b204-83e8613baaac",
"lastModified":"2017-01-08T21:07:51.1459644+00:00",
"market":"US",
"productId":"9NBLGGH52Q8X",
"skuId":"0024",
"startTime":"2017-01-10T21:07:49.2552941+00:00",
"recurrenceState":"Active"
}
]
}
応答本文
応答本文には、次のデータが含まれています。
| 値 | 種類 | 説明 |
|---|---|---|
| items | array | 指定したユーザーが使う権利を持っている各サブスクリプション アドオンに関するデータが含まれるオブジェクトの配列。 各オブジェクトのデータの詳細については、以下の表を参照してください。 |
items 配列内の各オブジェクトには、次の値が保持されています。
| 値 | 種類 | 説明 |
|---|---|---|
| autoRenew | ブール値 | 現在のサブスクリプション期間の終了時にサブスクリプションが自動的に更新されるように構成されているかどうかを示します。 |
| beneficiary | string | このサブスクリプションに関連付けられている権利の受益者 ID。 |
| expirationTime | string | サブスクリプションの有効期限が切れる日時 (ISO 8601形式)。 このフィールドは、サブスクリプションが特定の状態のときのみ利用可能です。 有効期限は通常、現在の状態の有効期限がいつ切れるかを示します。 たとえば、アクティブなサブスクリプションの場合、有効期限日は次の自動更新がいつ行われるかを示します。 |
| expirationTimeWithGrace | string | サブスクリプションの有効期限が切れる日時です (ISO 8601 形式、猶予期間を含みます)。 この値は、サブスクリプションが自動的に更新されなくなった後に、ユーザーがサブスクリプションへのアクセス権を失う日時を示します。 |
| id | string | サブスクリプションの ID です。 ユーザーのサブスクリプションの請求状態を変更するメソッドを呼び出すときに変更するサブスクリプションを指定するには、この値を使います。 |
| isTrial | Boolean | サブスクリプションが試用版であるかどうかを示します。 |
| lastModified | string | サブスクリプションが前回変更された日時 (ISO 8601形式)。 |
| market | string | ユーザーがサブスクリプションを取得した国コード (2 文字の ISO 3166-1 alpha-2 形式)。 |
| productId | string | Microsoft Store カタログ内のサブスクリプション アドオンを表す製品の Store ID。 製品のストア ID の例は、9NBLGGH42CFD です。 |
| skuId | string | Microsoft Store カタログ内のサブスクリプション アドオンを表す SKU の Store ID。 SKU の Store ID の例は、0010 です。 |
| startTime | string | サブスクリプションの開始日時 (ISO 8601 形式)。 |
| recurrenceState | string | 次のいずれかの値です。
注:
|
| cancellationDate | string | ユーザーのサブスクリプションがキャンセルされた日時 (ISO 8601 形式)。 |