Usando URIs de ms-windows-store

Este tópico descreve o esquema ms-windows-store: URI. Seu aplicativo pode usar esse esquema de URI para iniciar o aplicativo da Microsoft Store em páginas específicas na loja usando o método LaunchUriAsync no Windows.

Por exemplo, você pode abrir a Loja diretamente na página de Jogos usando o seguinte código:

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

Abrindo a Loja para seções específicas

Você pode iniciar o Aplicativo da Loja em uma página ou seção específica usando as seguintes opções:

Esquema de URI	Description	Anotações
ms-windows-store://home	Lança a página inicial da Loja.
ms-windows-store://navigatetopage/? Id=[vertical]	Inicia uma página vertical principal da loja	As verticais incluem: Home, , Gaming, Entertainmente ProductivityLOB, mas observe que verticais disponíveis podem variar por região.
ms-windows-store://downloadsandupdates	Inicia a página de Downloads e Atualizações.
ms-windows-store://mylibrary	Inicia a página da Biblioteca da Loja.
ms-windows-store://settings	Inicia a página de configurações da Loja.

Abrir um produto específico

Você pode abrir a Loja diretamente na página de detalhes do produto (PDP) para um produto específico usando a ID do Produto para um aplicativo. Embora o aplicativo da Loja no Windows 10 e no Windows 11 ainda dê suporte a PFN (Nome da Família de Pacotes) e IDs de Aplicativo, eles são preteridos e podem não ter suporte no futuro. Esses valores podem ser encontrados no Partner Center na página identidade do aplicativo na seção Gerenciamento de produtos para cada aplicativo.

OBSERVAÇÃO:a partir de fevereiro de 2026, a Microsoft Store não dará mais suporte a ativações feitas por meio do parâmetro mode=mini. As URIs que usam esse parâmetro serão padrão para a ativação padrão da Microsoft Store de página inteira.

Esquema de URI	Description	Anotações
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL	Inicia a PDP (página de detalhes completos do produto) para um produto	Essa é a maneira recomendada de vincular a um produto específico.
ms-windows-store://pdp/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe	Lança a página de detalhes do produto (PDP) completa para um produto	O uso do nome da família de pacotes está obsoleto.
ms-windows-store://pdp/?AppId=00001111-aaaa-2222-bbbb-3333cccc4444	Inicia a PDP (página de detalhes completos do produto) para um produto	O uso da ID do aplicativo foi preterido.
ms-windows-store://pdp/?ProductId=9WZDNCRFHVJL&mode=mini	Inicia a experiência de diálogo popup da loja	A experiência pop-up dá suporte apenas à ID do Produto

Iniciando a experiência de classificação e revisão de um produto

Para permitir que os usuários examinem seu aplicativo, você pode vincular a esse PDP e iniciar diretamente na caixa de diálogo de classificação e revisão. O ID da Loja é o método recomendado para iniciar o aplicativo da Loja em uma página de detalhes de produto específica.

Esquema de URI	Description	Anotações
ms-windows-store://review/? ProductId=9WZDNCRFHVJL	Lança a experiência de escrever uma avaliação para um produto.	É recomendável usar StoreId
ms-windows-store://review/?PFN=Microsoft.Office.OneNote_8wekyb3d8bbwe	Inicia a experiência de escrever uma avaliação para um produto.	O uso do nome da família de produtos foi preterido.
ms-windows-store://review/?AppId=11112222-bbbb-3333-cccc-4444dddd5555	Inicia o processo de escrever uma avaliação para um produto.	O uso de productid foi preterido

Pesquisando na Loja

Você pode abrir o aplicativo da Loja diretamente nos resultados de busca, utilizando vários métodos compatíveis para pesquisar o conteúdo da loja.

Esquema de URI	Description	Anotações
ms-windows-store://assoc/? Tags=Photos_Rich_Media_Edit, Camera_Capture_App	Inicia uma pesquisa por produtos associados a uma ou mais tags.	As marcas devem ser separadas por vírgulas.
ms-windows-store://search/?query=OneNote	Inicia uma pesquisa para a consulta especificada.	Espaços na consulta são permitidos.
ms-windows-store://browse/?type=Apps&cat=Saúde+e+bem-estar	Inicia uma pesquisa por produtos em uma categoria.
ms-windows-store://publisher/?name=Microsoft Corporation	Inicia uma pesquisa por produtos do editor especificado.	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.

Conteúdo relacionado

Iniciando, retomando e tarefas em segundo plano