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=00001111-aaaa-2222-bbbb-3333cccc4444 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=11112222-bbbb-3333-cccc-4444dddd5555 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.

Confira também

Início, retomada e tarefas em segundo plano