Usar URIs ms-windows-store

Este tópico descreve o esquema de URI ms-windows-store:. Os aplicativos podem usar esse esquema de URI para iniciar o aplicativo Microsoft Store em páginas específicas na Store ao usar o método LaunchUriAsync no Windows 10 e no Windows 11.

Por exemplo, é possível abrir a Store na página Jogos ao usar o seguinte código:

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

Abrir a Store para seções específicas

É possível iniciar o aplicativo Store para uma página ou para uma seção específica ao usar as opções apresentadas a seguir.

Esquema de URI	Descrição	Observações
ms-windows-store://home	Inicia a home page da Store.
ms-windows-store://navigatetopage/?Id=[vertical]	Inicia uma página vertical de nível superior da Store.	Os verticais incluem: Home, Gaming, Entertainment, Productivity e LOB, mas observe que os verticais disponíveis podem variar de acordo com a região.
ms-windows-store://downloadsandupdates	Inicia a página de downloads e de atualizações.	A partir das atualizações de outubro de 2021 para o aplicativo Store, a página Biblioteca será iniciada.
ms-windows-store://settings	Inicia a página Configurações da Store.

Abrir para um produto específico

É possível iniciar a Store diretamente para a página de detalhes do produto (PDP) de um produto específico usando o ID do produto (product ID) de aplicativos. Embora o aplicativo Store no Windows 10 e no Windows 11 ainda ofereça suporte ao nome da família de pacotes (PFN) e aos IDs dos aplicativos, eles estão preteridos e podem não ter suporte no futuro. Esses valores podem ser encontrados na Central de Parceiros, na página Identidade do aplicativo, na seção Gerenciamento de produtos para cada aplicativo.

A partir das atualizações de outubro de 2021 para o aplicativo Store, existem dois modos disponíveis para exibir a PDP. Por padrão, o aplicativo Store é aberto na página de detalhes do produto. Além disso, é possível iniciar a Store com uma experiência de pop-up que exibe uma caixa de diálogo da PDP menor, mostrando somente os detalhes essenciais para os aplicativos e um único botão de ação para os usuários. Para a experiência de pop-up, opcionalmente, você pode especificar a localização de uma janela em que a caixa de diálogo deve ser centralizada.

Esquema de URI	Descrição	Observações
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL	Inicia a página de detalhes do produto (PDP) na íntegra para um produto.	Esta é a forma recomendada para vinculação a um produto específico.
ms-windows-store://pdp/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	Inicia a página de detalhes do produto (PDP) na íntegra para um produto.	Usar o nome da família de pacotes está preterido.
ms-windows-store://pdp/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	Inicia a página de detalhes do produto (PDP) na íntegra para um produto.	Usar o ID do aplicativo está preterido.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini	Inicia a experiência de diálogo de pop-up da Store.	A experiência de pop-up oferece suporte somente ao ID do produto (product ID).

Iniciar a experiência de classificações e opiniões para um produto

Para habilitar que os usuários realizem uma revisão do aplicativo, você pode vincular essa PDP e iniciá-la diretamente na caixa de diálogo de classificações e opiniões. O ID da Store é o método recomendado para iniciar o aplicativo Store para uma página de detalhes de produtos específica.

Esquema de URI	Descrição	Observações
ms-windows-store://review/?ProductId=9WZDNCRFHVJL	Inicia a experiência de escrever uma revisão para um produto.	Usar o StoreId é recomendado.
ms-windows-store://review/?PFN= Microsoft.Office.OneNote_8wekyb3d8bbwe	Inicia a experiência de escrever uma revisão para um produto.	Usar o nome da família de produtos está preterido.
ms-windows-store://review/?AppId=f022389f-f3a6-417e-ad23-704fbdf57117	Inicia a experiência de escrever uma revisão para um produto.	Usar o productid está preterido.

Pesquisas na Store

É possível iniciar o aplicativo Store diretamente nos resultados da busca ao usar vários métodos com suporte para realizar pesquisas sobre o conteúdo da Store.

Esquema de URI	Descrição	Observações
ms-windows-store://assoc/?Tags=Photos_Rich_Media_Edit, Camera_Capture_App	Inicia uma pesquisa por produtos associados a um ou mais rótulos.	Os rótulos devem ser separados por vírgulas.
ms-windows-store://search/?query=OneNote	Inicia uma pesquisa para a consulta especificada.	Os espaços na consulta são permitidos.
ms-windows-store://browse/?type=Apps&cat=Health+%26+fitness	Inicia uma pesquisa por produtos em uma categoria.
ms-windows-store://publisher/?name=Microsoft Corporation	Inicia uma pesquisa por produtos do fornecedor especificado.	Os espaços no nome são permitidos.
ms-windows-store://assoc/?FileExt=pdf	Inicia uma pesquisa por produtos associados a uma extensão de arquivo.
ms-windows-store://assoc/?Protocol=ms-word	Inicia uma pesquisa por produtos associados a um protocolo.