ms-windows-store URI の使用
このトピックでは、ms-windows-store: URI スキーム について説明します。 アプリでは、この URI スキームを使用して、Windows の LaunchUriAsync メソッドを使用して、ストア内の特定のページに Microsoft Store アプリを起動できます。
たとえば、次のコードを使用して[ゲーム] ページにストアを開くことができます。
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
特定のセクションにストアを開く
次のオプションを使用して、特定のページまたはセクションに対してストア アプリを起動できます。
URI スキーム | 説明 | ノート |
---|---|---|
ms-windows-store://home | ストアのホーム ページを起動します。 | |
ms-windows-store://navigatetopage/?Id=[vertical] | ストアのトップレベルの垂直ページを起動します。 | 垂直には、Home 、Gaming 、Entertainment 、Productivity 、および LOB が含まれますが、利用可能な縦線はリージョンによって異なる場合があることに注意してください。 |
ms-windows-store://downloadsandupdates | ダウンロードと更新ページを起動します。 | ストア アプリに対する 2021 年 10 月の更新以降、ライブラリ ページが起動します。 |
ms-windows-store://settings | [ストアの設定] ページを起動します。 |
特定の製品を開く
アプリの製品 ID を使用して、特定の製品の製品詳細ページ (PDP) に直接ストアを起動できます。 Windows 10 および Windows 11 のストア アプリは引き続きパッケージ ファミリ名 (PFN) とアプリ ID をサポートしていますが、これらは非推奨となり、今後サポートされない可能性があります。 これらの値は、パートナー センターの各アプリの [製品管理] セクションの [アプリ ID] ページにあります。
ストア アプリに対する 2021 年 10 月の更新プログラム以降、PDP を表示するために使用できるモードは 2 つあります。 既定では、ストア アプリは製品の詳細ページに表示されます。 また、アプリの重要な詳細とユーザー用の 1 つのアクション ボタンのみを表示する小さな PDP ダイアログを表示するポップアップ エクスペリエンスでストアを起動することもできます。 ポップアップ エクスペリエンスでは、必要に応じて、ダイアログを上の中央に配置する必要があるウィンドウの場所を指定できます。
URI スキーム | 説明 | メモ |
---|---|---|
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL | 製品の完全な製品詳細ページ (PDP) を起動します | これは、特定の製品にリンクするための推奨される方法です。 |
ms-windows-store://pdp/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe | 製品の完全な製品詳細ページ (PDP) を起動します | パッケージ ファミリ名の使用は非推奨です。 |
ms-windows-store://pdp/?AppId=00001111-aaaa-2222-bbbb-3333cccc4444 | 製品の完全な製品詳細ページ (PDP) を起動します | アプリ ID の使用は非推奨です。 |
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini | ポップアップ ストア ダイアログ エクスペリエンスを起動します。 | ポップアップ エクスペリエンスでは、製品 ID のみがサポートされます |
製品の評価とレビュー エクスペリエンスの開始
ユーザーがアプリをレビューできるようにするには、その PDP にリンクし、評価とレビュー ダイアログに直接起動します。 ストア ID は、特定の製品詳細ページにストア アプリを起動するための推奨される方法です。
URI スキーム | 説明 | メモ |
---|---|---|
ms-windows-store://review/?ProductId=9WZDNCRFHVJL | 製品のレビュー エクスペリエンスの書き込みを開始します。 | StoreId の使用をお勧めします |
ms-windows-store://review/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe | 製品のレビュー エクスペリエンスの書き込みを開始します。 | 製品ファミリ名の使用は非推奨です。 |
ms-windows-store://review/?AppId=11112222-bbbb-3333-cccc-4444dddd5555 | 商品のレビューを書く体験を開始します。 | productid の使用は非推奨です |
ストアの検索
ストア コンテンツを検索するためにサポートされているいくつかの方法を使用して、ストア アプリを検索結果に直接起動できます。
URI スキーム | 説明 | ノート |
---|---|---|
ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit、Camera_Capture_App | 1 つ以上のタグに関連付けられている製品の検索を開始します。 | タグはコンマで区切る必要があります。 |
ms-windows-store://search/?query=OneNote | 指定したクエリの検索を開始します。 | クエリ内のスペースは許可されます。 |
ms-windows-store://browse/?type=Apps&cat=健康+%26フィットネス | カテゴリ内の製品の検索を開始します。 | |
ms-windows-store://publisher/?name=Microsoft Corporation | 指定した発行元の製品の検索を開始します。 | 名前にはスペースを使用できます。 |
ms-windows-store://assoc/?FileExt=pdf | ファイル拡張子に関連付けられている製品の検索を開始します。 | |
ms-windows-store://assoc/?Protocol=ms-word | プロトコルに関連付けられている製品の検索を開始します。 |
関連コンテンツ
Windows developer