ms-windows-store URI の使用

[アーティクル]
01/17/2024

このトピックでは、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=f022389f-f3a6-417e-ad23-704fbdf57117	製品の詳細な製品詳細ページ (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=f022389f-f3a6-417e-ad23-704fbdf57117	製品のレビューエクスペリエンスの書き込みを開始します。	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	プロトコルに関連付けられている製品の検索を開始します。