このメソッドを使用して、ユーザーが対象オファーの顧客セグメントに含まれているかどうかに基づいて、現在のユーザーが使用できる対象オファーを取得します。 詳細については、「Store サービスを使用して対象オファーを管理する」を参照してください。
[前提条件]
このメソッドを使用するには、まず、アプリ 現在サインインしているユーザーの Microsoft アカウント トークン を取得する必要があります。 このトークンは、このメソッドの Authorization 要求ヘッダーに渡す必要があります。 このトークンは、現在のユーザーの対象オファーを取得するためにストアによって使用されます。
リクエスト
リクエスト構文
| メソッド | URI リクエスト |
|---|---|
| 取得する | https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user |
リクエストヘッダー
| ヘッダ | タイプ | 説明 |
|---|---|---|
| 認証 | ひも | 必須。 現在サインインしているアプリユーザーのMicrosoftアカウントトークンは、の Bearer<トークン>形式です。 |
要求パラメーター
このメソッドには、URI パラメーターまたはクエリ パラメーターがありません。
要求の例
GET https://manage.devcenter.microsoft.com/v2.0/my/storeoffers/user HTTP/1.1
Authorization: Bearer <Microsoft Account token>
[応答]
このメソッドは、次のフィールドを持つオブジェクトの配列を含む JSON 形式の応答本文を返します。 配列内の各オブジェクトは、特定の顧客セグメントの一部として指定されたユーザーが利用できる対象オファーを表します。
| フィールド | タイプ | 説明 |
|---|---|---|
| 提供 | 配列 | 現在のユーザーが利用できる対象オファーに関連付けられているアドオンの製品 ID の配列。 これらの製品 ID は、パートナー センターのアプリの 対象オファー ページで指定されます。 |
| trackingId | ひも | 必要に応じて、独自のコードまたはサービスで対象となるオファーを追跡するために使用できる GUID。 |
例
次の例は、この要求の JSON 応答本文の例を示しています。
[
{
"offers": [
"10x gold coins",
"100x gold coins"
],
"trackingId": "5de5dd29-6dce-4e68-b45e-d8ee6c2cd203"
}
]
関連トピック
- Store サービス を使用して対象オファーを管理する