Skip to main content
Os jogos usam as APIs XStore para executar operações nas licenças e nos direitos associados ao seu jogo e aos produtos relacionados (por exemplo, complementos). Muitas das operações da XStore manipulam informações sobre o seu jogo gerenciadas pelos serviços da Microsoft Store.
Esta página foi substancialmente atualizada em relação às versões anteriores.
Desde junho de 2023, a maioria* dos testes da API XStore não exige mais configurar o build para ser licenciável (por exemplo, contentIdOverride) nem que cada conta tenha um direito ao jogo. Ao testar o comércio em áreas restritas de desenvolvimento, todas as compras em uma única conta de teste devem ser feitas na mesma área restrita. Trocar uma conta de teste para outra área restrita e comprar mais itens gera resultados de consulta inesperados para a conta em ambas as áreas restritas. Isso ocorre porque as licenças e as informações de uma compra estão vinculadas à primeira área restrita em que o item foi comprado para uma única conta. Ao testar o comércio em áreas restritas de desenvolvimento no PC, verifique se a conta conectada ao aplicativo Microsoft Store e ao aplicativo XBOX é a mesma. Nas áreas restritas, as credenciais usadas para itens na Microsoft Store estão vinculadas especificamente à conta XBOX. Isso é fundamental para garantir que todas as operações interajam com produtos publicados especificamente na área restrita ativa. Consulte Lidar com cenários de contas da loja incompatíveis no PC para obter mais informações. Para testar a maioria* das APIs XStore, verifique se a configuração do jogo contém os valores adequados derivados do Partner Center.

Aplicar IDs do jogo ao MicrosoftGameConfig

Primeiro, publique seu jogo e complementos no Partner Center. Em seguida, no arquivo de configuração do jogo, verifique se os valores correspondem ao título configurado:

Identity

Localizado no Partner Center em Configuração do jogo > Detalhes de identidade. No PC: é estritamente obrigatório que corresponda ao que está atribuído ao seu jogo no Partner Center. Embora não seja obrigatório para console, deve ser verificado quando um pacote é criado para envio ao Partner Center. Name no nó Identity precisa corresponder a Package/Identity/Name; Publisher no nó Identity precisa corresponder a Package/Identity/Publisher. Configuração do jogo > Detalhes de identidade com Package/Identity/Name e Publisher circulados

StoreID

Também encontrado em Configuração do jogo > Detalhes de identidade Configuração do jogo > Detalhes de identidade com StoreId circulado na URL e na página

Documentação de referência da API

Confira também

Visão geral de comércio Configuração inicial no Partner Center Habilitar testes de licença Trocar de área restrita corretamente para operações da Store Referência da API XStore
Last modified on October 6, 2026