> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilitar o desenvolvimento e os testes da XStore

> Configure seu produto XBOX para desenvolvimento e testes da API XStore em uma área restrita, incluindo os requisitos de direito, licenciamento e conta de teste.

Os jogos usam as [APIs XStore](/pt-BR/reference/system/xstore/xstore_members) 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.

<Note>
  Esta página foi substancialmente atualizada em relação às versões anteriores.
</Note>

Desde junho de 2023, a maioria[\*](#exceptions) 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](/pt-BR/publishing/xstore-commerce/xstore-mismatched-accounts) para obter mais informações.

Para testar a maioria[\*](#exceptions) das APIs `XStore`, verifique se a configuração do jogo contém os valores adequados derivados do Partner Center.

<a id="exceptions" />

* **APIs relacionadas a licenciamento, como [XStoreQueryGameLicenseAsync](/pt-BR/reference/system/xstore/xstore_members), exigirão um contexto totalmente licenciado para funcionar corretamente.** Consulte [Habilitar testes de licença](/pt-BR/publishing/xstore-commerce/xstore-licensing-setup) para obter detalhes completos.

## Aplicar IDs do jogo ao MicrosoftGameConfig

Primeiro, publique seu jogo e complementos no [Partner Center](/pt-BR/publishing/xstore-commerce/xstore-initial-configuration).

Em seguida, no arquivo de configuração do jogo, verifique se os valores correspondem ao título configurado:

```xml theme={null}
  <Identity
    Name="41336MicrosoftATG.InGameStoreXS"
    Publisher="CN=A4954634-DF4B-47C7-AB70-D3215D246AF1"
    Version="2023.5.5.0" />
  <StoreId>9NTL0QDWZ4FS</StoreId>
  <MSAAppId>000000004C2690C8</MSAAppId>
  <TitleId>62ab3c24</TitleId>
```

### 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**.

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=f0f690902c8867bbae062a337589d182" alt="Configuração do jogo > Detalhes de identidade com Package/Identity/Name e Publisher circulados" data-og-width="1124" width="1124" data-og-height="427" height="427" data-path="images/xstore/identitydetails_appidentity.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=280&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=8e2ab6246d7c53aa58e9b5198c4a6357 280w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=560&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=73e8f4ac014c15e5ac6a2320c982b4fd 560w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=840&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e8404c21a5aaf6dacb8652172c1664bf 840w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=1100&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=7f782bd5e9e6b087580e58f648e56d01 1100w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=1650&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=2f539bda98499c8d89efca0d31587749 1650w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?w=2500&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=d2a838a12cb667aa59f82014055d4bb1 2500w" />

### StoreID

Também encontrado em **Configuração do jogo > Detalhes de identidade**

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=1902ced5d2643fa8c1de30281ef96723" alt="Configuração do jogo > Detalhes de identidade com StoreId circulado na URL e na página" data-og-width="1146" width="1146" data-og-height="722" height="722" data-path="images/xstore/identitydetails_storeid.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=280&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e1140c4882103ee1552f75fb24e8d816 280w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=560&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=6a2b403d4302b0e1ae8cae6e4992cc91 560w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=840&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=e5eaa6967e59ba7b648a91b25085e111 840w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=1100&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=b38590d54bdb1bb89501e238dbfc8566 1100w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=1650&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=05c68d0fb041e551eb789ee21d7030a6 1650w, https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?w=2500&fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=a3c17b86117be244a0687746e96b7f33 2500w" />

## Documentação de referência da API

* [XStore (conteúdo da API)](/pt-BR/reference/system/xstore/xstore_members)
  * Funções
    * [XStoreQueryGameLicenseAsync](/pt-BR/reference/system/xstore/xstore_members)

## Confira também

[Visão geral de comércio](/pt-BR/publishing/xstore-commerce/xstore-commerce-overview)

[Configuração inicial no Partner Center](/pt-BR/publishing/xstore-commerce/xstore-initial-configuration)

[Habilitar testes de licença](/pt-BR/publishing/xstore-commerce/xstore-licensing-setup)

[Trocar de área restrita corretamente para operações da Store](/pt-BR/publishing/xstore-commerce/xstore-switching-sandbox)

[Referência da API XStore](/pt-BR/reference/system/xstore/xstore_members)


## Related topics

- [Guia passo a passo da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-guide.md)
- [Integração de Parceiro XBOX para acesso e publicação](/pt-BR/home/onboarding.md)
- [Guia de BVT de PC da certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-pc-bvt-guide.md)
- [Glossário de termos e siglas do GDK](/pt-BR/home/glossary.md)
- [Envios opcionais de certificação](/pt-BR/publishing/game-publishing/concepts/certification/certification-optional-submissions.md)
