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

# XStore 開発とテストの有効化

> エンタイトルメント、ライセンス供与、およびテスト アカウントの要件を含め、サンドボックスでの XStore API 開発とテスト用に XBOX 製品を設定します。

ゲームは [XStore API](/reference/system/xstore/xstore_members) を使用して、ゲームおよびその関連製品 (アドオンなど) に関連付けられているライセンスとエンタイトルメントに対する操作を実行します。多くの `XStore` 操作は、Microsoft Store サービスによって管理されるゲームに関する情報を操作します。

<Note>
  このページは、以前のバージョンから大幅に更新されています。
</Note>

2023 年 6 月以降、ほとんどの[\*](#exceptions) `XStore` API のテストでは、ビルドをライセンス供与可能に設定 (contentIdOverride など) したり、各アカウントがゲームへのエンタイトルメントを持つ必要はなくなりました。

開発サンドボックスでコマースをテストする場合、1 つのテスト アカウントでのすべての購入は同じサンドボックスで行う必要があります。テスト アカウントを別のサンドボックスに切り替えて、さらにアイテムを購入すると、両方のサンドボックスのアカウントに対して予期しないクエリ結果が発生します。これは、購入のライセンスと情報が、1 つのアカウントでアイテムを最初に購入したサンドボックスに紐付けられるためです。

PC の開発サンドボックスでコマースをテストする場合、Microsoft Store アプリと XBOX アプリにサインインしているアカウントが同じであることを確認してください。サンドボックスでは、Microsoft Store のアイテムに使用される資格情報は XBOX アカウントに特に紐付けられます。これは、すべての操作がアクティブなサンドボックスに特に公開された製品と対話することを保証するために重要です。詳細については、[PC 上での Store アカウントが一致しないシナリオの処理](/publishing/xstore-commerce/xstore-mismatched-accounts)を参照してください。

ほとんどの[\*](#exceptions) `XStore` API をテストするには、ゲーム構成にパートナー センターから派生した適切な値が含まれていることを確認してください。

<a id="exceptions" />

* **[XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members) など、ライセンス供与に関連する API は、適切に機能するために完全にライセンス供与されたコンテキストを必要とします。** 詳細については、[ライセンス テストの有効化](/publishing/xstore-commerce/xstore-licensing-setup)を参照してください。

## MicrosoftGameConfig にゲーム ID を適用する

まず、[パートナー センター](/publishing/xstore-commerce/xstore-initial-configuration)でゲームとアドオンを公開してください。

次に、ゲームの構成ファイルで値が構成されたタイトルと一致することを確認します。

```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

パートナー センターの **\[ゲームのセットアップ > ID の詳細]** にあります。

PC の場合: パートナー センターでゲームに割り当てられているものと厳密に一致する必要があります。

コンソールでは必要ありませんが、パートナー センターへの送信用にパッケージが作成されるときにチェックする必要があります。

`Identity` ノードの `Name` は **Package/Identity/Name** と一致する必要があります。`Identity` ノードの `Publisher` は **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="Package/Identity/Name と Publisher が丸で囲まれた [ゲームのセットアップ > ID の詳細]" 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

**\[ゲームのセットアップ > ID の詳細]** にもあります。

<img src="https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_storeid.png?fit=max&auto=format&n=iADzli99B7EWodAv&q=85&s=1902ced5d2643fa8c1de30281ef96723" alt="URL とページ上の StoreId が丸で囲まれた [ゲームのセットアップ > ID の詳細]" 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" />

## リファレンス API ドキュメント

* [XStore (API の内容)](/reference/system/xstore/xstore_members)
  * 関数
    * [XStoreQueryGameLicenseAsync](/reference/system/xstore/xstore_members)

## 関連項目

[コマースの概要](/publishing/xstore-commerce/xstore-commerce-overview)

[パートナー センターでの初期構成](/publishing/xstore-commerce/xstore-initial-configuration)

[ライセンス テストの有効化](/publishing/xstore-commerce/xstore-licensing-setup)

[Store 操作のためにサンドボックスを適切に切り替える](/publishing/xstore-commerce/xstore-switching-sandbox)

[XStore API リファレンス](/reference/system/xstore/xstore_members)


## Related topics

- [ライセンス供与テストの有効化](/ja-jp/publishing/xstore-commerce/xstore-licensing-setup.md)
- [ゲームの体験版の実装](/ja-jp/publishing/xstore-commerce/xstore-trials.md)
- [XStore 開発のトラブルシューティング](/ja-jp/publishing/xstore-commerce/xstore-troubleshooting.md)
- [基本的な Store 操作](/ja-jp/publishing/xstore-commerce/xstore-basic-operations.md)
- [Store 操作のためにサンドボックスを適切に切り替える](/ja-jp/publishing/xstore-commerce/xstore-switching-sandbox.md)
