Uso degli URI ms-windows-store

In questo argomento viene descritto lo schema ms-windows-store: URI. L'app può usare questo schema URI per avviare l'app di Microsoft Store in pagine specifiche nello Store usando il metodo LaunchUriAsync in Windows 10 e Windows 11.

Ad esempio, è possibile aprire lo Store nella pagina Giochi usando il codice seguente:

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-windows-store://navigatetopage/?Id=Gaming"));

Apertura dello Store in sezioni specifiche

È possibile avviare l'app dello Store in una pagina o una sezione specifica usando le opzioni seguenti.

Schema URI	Descrizione	Note
ms-windows-store://home	Avvia la home page dello Store.
ms-windows-store://navigatetopage/?Id=[vertical]	Avvia una pagina verticale di primo livello del negozio	I verticali includono: Home, Gaming, Entertainment, Productivity e LOB, ma si noti che i verticali disponibili possono variare in base all'area.
ms-windows-store://downloadsandupdates	Avvia la pagina download e aggiornamenti.	A partire dall'aggiornamento di ottobre 2021 all'app dello Store, verrà avviata la pagina Libreria.
ms-windows-store://settings	Avvia la pagina delle impostazioni dello Store.

Apertura a un prodotto specifico

È possibile avviare lo Store direttamente nella pagina dei dettagli del prodotto (PDP) per un prodotto specifico usando l'ID prodotto per un'app. Anche se l'app dello Store in Windows 10 e Windows 11 supporta ancora il nome della famiglia di pacchetti (PFN) e gli ID app, questi sono deprecati e potrebbero non essere supportati in futuro. Questi valori sono disponibili nel Partner Center nella pagina Identità dell'app nella sezione Gestione dei prodotti per ogni app.

A partire dall'aggiornamento di ottobre 2021 all'app dello Store, sono disponibili due modalità per la visualizzazione del PDP. Per impostazione predefinita, l'app dello Store viene aperta alla pagina dei dettagli del prodotto. È possibile anche avviare lo Store in con un'esperienza popup che visualizza una finestra di dialogo PDP più piccola con che visualizza solo i dettagli essenziali per la tua app e un singolo pulsante di azione per gli utenti. Per l'esperienza popup, è possibile specificare facoltativamente la posizione di una finestra che deve essere centrata sopra.

Schema URI	Descrizione	Note
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL	Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto	Questo è il modo consigliato per collegarsi a un prodotto specifico.
ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto	L'uso del nome della famiglia di pacchetti è deprecato.
ms-windows-store://pdp/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	Avvia la pagina completa dei dettagli del prodotto (PDP) per un prodotto	L'uso dell'ID app è deprecato.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini	Avvia l'esperienza della finestra di dialogo dello Store popup	L'esperienza popup supporta solo l'ID prodotto

Avvio della valutazione e dell'esperienza di revisione per un prodotto

Per consentire agli utenti di esaminare l'app, si può collegarla a tale PDP e avviarla direttamente nella finestra di dialogo valutazione e revisione. L'ID dello Store è il metodo consigliato per avviare l'app dello Store in una pagina specifica dei dettagli del prodotto.

Schema URI	Descrizione	Note
ms-windows-store://review/?ProductId=9WZDNCRFHVJL	Avvia l'esperienza di scrittura di una recensione per un prodotto.	È consigliabile usare StoreId
ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	Avvia l'esperienza di scrittura di una recensione per un prodotto.	L'uso del nome della famiglia di prodotti è deprecato.
ms-windows-store://review/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	Avvia l'esperienza di scrittura di una recensione per un prodotto.	L'uso di productid è deprecato

Ricerca nel negozio

È possibile avviare l'app dello Store direttamente nei risultati della ricerca con diversi metodi supportati per la ricerca del contenuto dello Store.

Schema URI	Descrizione	Note
ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App	Avvia una ricerca di prodotti associati a uno o più tag.	I tag devono essere separati da virgole.
ms-windows-store://search/?query=OneNote	Avvia una ricerca per la query specificata.	Sono invece consentiti gli spazi nella query.
ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness	Avvia una ricerca di prodotti in una categoria.
ms-windows-store://publisher/?name=Microsoft Corporation	Avvia una ricerca di prodotti dall'editore specificato.	Sono invece consentiti spazi nel nome.
ms-windows-store://assoc/?FileExt=pdf	Avvia una ricerca di prodotti associati a un'estensione di file.
ms-windows-store://assoc/?Protocol=ms-word	Avvia una ricerca di prodotti associati a un protocollo.