対象となるオファーを取得する

このメソッドを使用して、ユーザーが対象オファーの顧客セグメントに含まれているかどうかに基づいて、現在のユーザーが使用できる対象オファーを取得します。 詳細については、「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"
  }
]