ms-windows-store URI の使用
このトピックでは、ms-windows-store: URI スキームについて説明します。 Windows 10 および Windows 11 の LaunchUriAsync メソッドを使うことにより、アプリでこの URI スキームを使用して、Microsoft Store アプリを起動し、Microsoft Store 内の特定のページを表示できます。
たとえば、次のコードを使用して、Microsoft Store のゲーム ページを開くことができます。
bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));
Microsoft Store の特定のセクションを開く
次のオプションを使用すると、Microsoft Store アプリを起動して特定のページまたはセクションを開くことができます。
| URI スキーム | 説明 | メモ |
|---|---|---|
| ms-windows-store://home | ストアのホーム ページを起動します。 | |
| ms-windows-store://navigatetopage/?Id=[vertical] | ストアの最上位レベルの縦型ページを起動します | 縦型には、Home、Gaming、Entertainment、Productivity、LOB が含まれますが、使用可能な縦型は地域によって異なる場合があることに注意してください。 |
| ms-windows-store://downloadsandupdates | ダウンロードおよび更新ページを起動します。 | Microsoft Store アプリの October 2021 Update 以降、ライブラリ ページが起動します。 |
| ms-windows-store://settings | ストアの設定ページを起動します。 |
特定の製品を開く
アプリの製品 ID を使用して、Microsoft Store を起動して特定の製品の製品詳細ページ (PDP) を直接開くことができます。 Windows 10 および Windows 11 の Microsoft Store アプリはパッケージ ファミリ名 (PFN) とアプリ ID を引き続きサポートしていますが、これらは非推奨であり、今後サポートされなくなる可能性があります。 これらの値は、パートナー センターでアプリごとの [製品管理] セクションの [アプリ ID] ページにあります。
Microsoft Store アプリの October 2021 Update 以降、PDP を表示するために使用できる 2 つのモードがあります。 既定では、Microsoft Store アプリから製品詳細ページが開きます。 また、小さな 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 | Microsoft Store のポップアップ ダイアログを起動します | ポップアップ エクスペリエンスでは製品 ID のみがサポートされます |
製品の評価とレビューを起動する
ユーザーがアプリをレビューできるようにするには、その PDP にリンクして、評価とレビューのダイアログを直接起動します。 Store ID は、Microsoft Store アプリを起動して特定の製品詳細ページを開くために推奨される方法です。
| 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-4444ddddd5555 | 製品のレビュー エクスペリエンスの書き込みを開始します。 | productid の使用は非推奨です |
Microsoft Store の検索
Microsoft Store コンテンツを検索するためにサポートされているいくつかの方法を使用して、Microsoft Store アプリを起動して検索結果を直接開くことができます。
| 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=Health+%26+fitness | カテゴリ内の製品の検索を開始します。 | |
| ms-windows-store://publisher/?name=Microsoft Corporation | 指定した発行元の製品の検索を開始します。 | 名前にはスペースを使用できます。 |
| ms-windows-store://assoc/?FileExt=pdf | ファイル拡張子に関連付けられている製品の検索を開始します。 | |
| ms-windows-store://assoc/?Protocol=ms-word | プロトコルに関連付けられている製品の検索を開始します。 |