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

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

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

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

> [!NOTE]
>
> このページは、以前のバージョンから大幅に更新されています。

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

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

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

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

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

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

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

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

```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** と一致する必要があります。

![Package/Identity/Name と Publisher が丸で囲まれた \[ゲームのセットアップ > ID の詳細\]](https://mintcdn.com/microsoft-4404708b/iADzli99B7EWodAv/images/xstore/identitydetails_appidentity.png?fit=max\&auto=format\&n=iADzli99B7EWodAv\&q=85\&s=f0f690902c8867bbae062a337589d182)

### StoreID

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

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

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

* [XStore (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)
  * 関数
    * [XStoreQueryGameLicenseAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)

## 関連項目

[コマースの概要](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-commerce-overview.md)

[パートナー センターでの初期構成](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-initial-configuration.md)

[ライセンス テストの有効化](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-licensing-setup.md)

[Store 操作のためにサンドボックスを適切に切り替える](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-switching-sandbox.md)

[XStore API リファレンス](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)


## Related topics

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