Microsoft Store に要求を送信する

  • [アーティクル]

Windows 10 バージョン 1607 以降、Windows SDK の Windows.Services.Store 名前空間にはストアに関連する操作 (アプリ内購入など) の API が用意されています。 ただし、ストアをサポートするサービスは OS がリリースされるたびに継続的に更新、拡張、強化されていますが、新しい API は通常 OS のメジャー リリース時にのみ Windows SDK に追加されます。

SendRequestAsync メソッドは、新しいバージョンの Windows SDK がリリースされる前にユニバーサル Windows プラットフォーム (UWP) アプリで新しいストアの操作を利用できるようにする柔軟な方法として用意されています。 このメソッドを使うと、最新リリースの Windows SDK に対応する API がまだない新しい操作の要求をストアに送信することができます。

注意

SendRequestAsync メソッドは、Windows 10 バージョン 1607 以降をターゲットとするアプリにのみ使うことができます。 このメソッドでサポートされている要求の一部は、Windows 10 バージョン 1607 より後のリリースでのみサポートされます。

SendRequestAsync は、StoreRequestHelper クラスの静的メソッドです。 このメソッドを呼び出すには、次の情報をメソッドに渡す必要があります。

  • 操作を実行するユーザーに関する情報を提供する StoreContext オブジェクト。 このオブジェクトについて詳しくは、「StoreContext クラスの概要」をご覧ください。
  • ストアに送信する要求を識別する整数。
  • 要求が任意の引数をサポートする場合、要求と共に渡す引数を含む JSON 形式の文字列も渡すことができます。

このメソッドの呼び出し方法を次の例に示します。 この例では、Windows.Services.Store 名前空間と System.Threading.Tasks 名前空間のステートメントを使う必要があります。

public async Task<bool> AddUserToFlightGroup()
{
    StoreSendRequestResult result = await StoreRequestHelper.SendRequestAsync(
        StoreContext.GetDefault(), 8,
        "{ \"type\": \"AddToFlightGroup\", \"parameters\": { \"flightGroupId\": \"your group ID\" } }");

    if (result.ExtendedError == null)
    {
        return true;
    }

    return false;
}

SendRequestAsync メソッドで現在利用可能な要求については、以下のセクションをご覧ください。 この記事は、新しい要求のサポートが追加されると更新されます。

アプリ内での評価とレビューの要求

SendRequestAsync メソッドに要求の整数として 16 を渡すと、アプリを評価してレビューを提出するようにユーザーに求めるダイアログを、アプリ内からプログラムによって起動することができます。 詳しくは、「アプリ内での評価とレビュー ダイアログの表示」をご覧ください。

フライト グループ シナリオの要求

重要

現在のところ、このセクションで説明されているフライト グループ要求はすべて、ほとんどの開発者アカウントで使用できません。 開発者用アカウントが Microsoft によって特にプロビジョニングされない限り、これらの要求は失敗します。

SendRequestAsync メソッドは、フライト グループへのユーザーまたはデバイスの追加など、フライト グループ シナリオの一連の要求をサポートしています。 これらの要求を提出するには、値 7 または 8 を requestKind パラメーターに渡すと同時に、関連する引数と共に提出する要求を示す parametersAsJson パラメーターに JSON 形式文字列を渡します。 これらの requestKind 値は、次の点で異なります。

要求の種類を表す値 説明
7 要求は、現在のデバイスのコンテキストで実行されます。 この値は、Windows 10 バージョン 1703 以降でのみ使用できます。
8 要求は、ストアに現在サインインしているユーザーのコンテキストで実行されます。 この値は、Windows 10 バージョン 1607 以降で使用できます。

現在のところ、次のフライト グループ要求が実装されています。

最も順位の高いフライト グループのリモート変数を取得する

重要

この要求は、現在のところほとんどの開発者アカウントで使用できません。 開発者用アカウントが Microsoft によって特にプロビジョニングされない限り、この要求は失敗します。

この要求は、現在のユーザーまたはデバイスの最も順位の高いフライト グループのリモート変数を取得します。 この要求を送信するには、次の情報を SendRequestAsync メソッドの requestKind パラメーターと parametersAsJson パラメーターに渡します。

パラメーター 説明
requestKind デバイスの最も順位の高いフライト グループを返すには 7 を指定し、現在のユーザーとデバイスの最も順位の高いフライト グループを返すには 8 を指定します。 requestKind パラメーターには値 8 を使うことをお勧めします。この値は、現在のユーザーおよびデバイスの両方のメンバーシップにおいて最も順位の高いフライト グループを返すためです。
parametersAsJson 次の例に示すように、データを含む JSON 形式の文字列を渡します。

次の例は、JSON 形式のデータを parametersAsJson に渡す方法を示しています。 type フィールドは、文字列 GetRemoteVariables に割り当てる必要があります。 パートナー センターでリモート変数を定義したプロジェクトの ID フィールドに projectId フィールドを割り当てます。

{ 
    "type": "GetRemoteVariables", 
    "parameters": "{ \"projectId\": \"your project ID\" }" 
}

この要求を提出すると、StoreSendRequestResult の戻り値の Response プロパティには、次のフィールドを持つ JSON 形式の文字列が含められます。

フィールド 説明
匿名 ブール値。true はユーザーまたはデバイス ID が要求に存在していなかったことを示し、false はユーザーまたはデバイス ID が要求に存在していたことを示します。
name デバイスまたはユーザーが所属する最も順位の高いフライト グループの名前を含む文字列です。
設定 開発者がフライト グループに構成したリモート変数の名前を値を含むキー/値ペアのディクショナリです。

次の例では、この要求の戻り値を示します。

{ 
  "anonymous": false, 
  "name": "Insider Slow",
  "settings":
  {
      "Audience": "Slow"
      ...
  }
}

フライト グループに現在のデバイスまたはユーザーを追加する

重要

この要求は、現在のところほとんどの開発者アカウントで使用できません。 開発者用アカウントが Microsoft によって特にプロビジョニングされない限り、この要求は失敗します。

この要求を送信するには、次の情報を SendRequestAsync メソッドの requestKind パラメーターと parametersAsJson パラメーターに渡します。

パラメーター 説明
requestKind デバイスをフライト グループに追加するには 7 を指定し、現在ストアにサインインしているユーザーをフライト グループに追加するには 8 を指定します。
parametersAsJson 次の例に示すように、データを含む JSON 形式の文字列を渡します。

次の例は、JSON 形式のデータを parametersAsJson に渡す方法を示しています。 type フィールドは、文字列 AddToFlightGroup に割り当てる必要があります。 flightGroupId フィールドを、デバイスまたはユーザーを追加するフライト グループの ID に割り当てます。

{ 
    "type": "AddToFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

要求でエラーが発生した場合、StoreSendRequestResult の戻り値の HttpStatusCode プロパティには応答コードが含められます。

フライト グループから現在のデバイスまたはユーザーを削除する

重要

この要求は、現在のところほとんどの開発者アカウントで使用できません。 開発者用アカウントが Microsoft によって特にプロビジョニングされない限り、この要求は失敗します。

この要求を送信するには、次の情報を SendRequestAsync メソッドの requestKind パラメーターと parametersAsJson パラメーターに渡します。

パラメーター 説明
requestKind デバイスをフライト グループから削除するには 7 を指定し、現在ストアにサインインしているユーザーをフライト グループから削除するには 8 を指定します。
parametersAsJson 次の例に示すように、データを含む JSON 形式の文字列を渡します。

次の例は、JSON 形式のデータを parametersAsJson に渡す方法を示しています。 type フィールドは、文字列 RemoveFromFlightGroup に割り当てる必要があります。 flightGroupId フィールドを、デバイスまたはユーザーを削除するフライト グループの ID に割り当てます。

{ 
    "type": "RemoveFromFlightGroup", 
    "parameters": "{ \"flightGroupId\": \"your group ID\" }" 
}

要求でエラーが発生した場合、StoreSendRequestResult の戻り値の HttpStatusCode プロパティには応答コードが含められます。