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

# GDK コマース システムの概要

> GDK で利用可能な Microsoft Store のコマース システムの概要 — 購入、エンタイトルメント、消費型、DLC、体験版、サブスクリプション、ライセンス供与 API について。

GDK 内で利用可能なコマース関連の機能とサービスは、複数の収益化モデルと、それらのコマース オプションへのバックエンド サービスの深い統合を可能にします。このドキュメントでは、これらのシステムとオプションの概要を紹介し、GDK ドキュメントのコマース セクションで詳しく説明します。

## クライアント側の機能

GDK では、ゲームは消費型、永続型 (ダウンロード可能コンテンツ)、サブスクリプション、バンドル、体験版など、複数の種類のゲーム内アドオンと製品タイプを実装できます。XStore API セットは、これらの製品をクライアント側から照会、宣伝、管理するために必要な機能を提供します。完全に機能するゲーム内 Store の例については、[GDK In-Game Store サンプル](https://github.com/microsoft/Xbox-GDK-Samples/tree/main/Samples/Live/InGameStore)を参照してください。

基本セクションの以下の記事では、これらの API とシナリオについて説明しています。

* [基本的な Store 操作](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-basic-operations.md) - 販売可能なものとユーザーが所有するものを照会します
* [パッケージなしの永続型の使用方法](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-dwob.md) - 個別のダウンロード パッケージを持たない永続型の使用方法
* [ダウンロード可能なコンテンツ (DLC) の管理とライセンス供与](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-dlc.md) - ダウンロード パッケージ付きの従来型の永続型を使用
* [消費型ベースのエコシステム](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-consumables.md) - ゲーム内で消費型ベースの収益化モデルを設定して構成
* [ゲームの体験版の実装](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-trials.md) - ゲームに組み込まれた体験版を実装
* [バンドルとシーズン パス](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-bundles-season-passes.md) - バンドルとシーズン パスを使用して顧客に価値とエンゲージメントを提供
* [ゲームの製品共有モデル](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-product-sharing.md) - XBOX コンソールと Windows PC の両方における GDK ゲームのライセンス モデルと、ユーザー間の共有の適用方法

## サーバー側の機能

クライアント側 API をサポートしサービス間呼び出しを可能にする Microsoft Store サービスは、以下のサービスに分割されます。

* [Collections](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-query-entitlements.md) - ユーザーが所有するか使用する権利のある製品に関する情報を提供し、消費型製品を履行します。また、承認済みのパートナーで Game Pass サブスクリプション状態を検出するためにも使用できます。
* [Clawback](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-managing-consumables.md) - 既に履行された消費型に対してユーザーに発行された返金をパートナー サービスが検出および管理できるようにします。
* [Purchase](https://docs.xbox.com/ja-jp/reference/microsoft-store-apis/xstore-v8-grant.md) - パートナー サービスがユーザーのアカウントに無料アイテムを追加できるようにします。
* Recurrence - ユーザーのサブスクリプションに関する詳細情報を提供し、パートナー サービスがユーザーの代わりにそれらのサブスクリプションを管理できるようにします。

### Microsoft Store サービスでの認証

Microsoft Store サービスでのサービスの認証方法の詳細については、[サービス間認証用のユーザー Store ID を要求する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-requesting-userstoreid.md)を参照してください。

> [!NOTE]
>
> X-Token 認証に慣れている場合、Collections サービスは X-Token をサポートしています。

ただし、他の Microsoft Store サービスはサポートしていません。他のサービスで提供される価値ある機能のため、現在はパートナーがサーバー間認証フローを Microsoft Entra ID と UserStoreId フローに移行することをお勧めしています。

認証フローと Microsoft Store サービスへの呼び出しを効率化するために、GitHub 上の Microsoft.StoreServices プロジェクトとサンプルを確認してください。Microsoft.StoreServices ライブラリは、認証キーの管理を支援し、製品を管理するために Microsoft Store サービスを呼び出すラッパー API を提供します。サンプル プロジェクトでは、サービスが Microsoft.StoreServices ライブラリを使用する方法、消費型製品の管理、返金された購入の照合、期限切れの資格情報の更新などの例のロジックを紹介しています。PC 上または Azure を通じてサンプル サービスを設定するためのステップバイステップの構成ガイドがサンプルに含まれています。

* [Microsoft.StoreServices ライブラリ (GitHub)](https://github.com/microsoft/Microsoft-Store-Services)
* [Microsoft.StoreServices Sample (GitHub)](https://github.com/microsoft/Microsoft-Store-Services-Sample)

## XDK を使用した開発者向けの重要情報

XDK のコマース システムに慣れている場合、次の定義は同等の GDK サービスの名前を把握するのに役立ちます。

* **Inventory Service** - XDK の Inventory サービスの機能 (所有権の照会、消費型の履行など) は、現在 Collections Service によって処理されます。これには、所有権と消費型数量を検証するためのすべてのサーバー間シナリオが含まれます。Inventory 用の X-Token は Collections の呼び出しに機能しますが、Microsoft Store サービスの拡張機能を使用するために、パートナーは Microsoft Entra ID とユーザー Store ID トークンの認証フローに移行することをお勧めします。\
  例: [https://collections.mp.microsoft.com/v8.0/collections/b2bLicensePreview](https://docs.xbox.com/ja-jp/reference/microsoft-store-apis/xstore-v8-query-for-products.md)
* **Inventory Client API** - アイテムの所有権照会に関連するクライアント側機能はすべて、現在は XStore API を通じて処理されます。\
  例: [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md) は、その時点で現在のユーザーが使用する権利のあるアイテムを返します。
* **Catalog Browse API** - ゲーム内で購入可能な製品の照会に関連するクライアント側機能はすべて、現在は XStore API を通じて処理されます。タイトル内で販売する製品を照会するためのサーバー間オプションはありません。\
  例: [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md) は、ゲーム内 Store の一部として販売できる製品を返します。
* **体験版とライセンス** - 体験版ライセンスに関連するクライアント側機能はすべて、現在 XStore API の一部です。例: [XStoreQueryGameLicenseAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md) は、体験版ライセンス情報を含む現在のゲームのライセンス情報を返します。独自のサービス上でクライアント側ライセンスを検証する機能については、[ライセンス トークンを使用してサービスでライセンスを検証する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-license-tokens.md)を参照してください。

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

* [XStore (API の内容)](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)
  * 関数
    * [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/xstore_members.md)
    * [XStoreQueryAssociatedProductsAsync](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-initial-configuration.md)

[基本的な Store 操作](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-basic-operations.md)

[サービスから製品を管理する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)

[PC 固有の考慮事項](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-pc.md)

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


## Related topics

- [GDK コマース システムの概要](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-commerce-overview.md)
- [XStoreQueryGameLicenseAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstorequerygamelicenseasync.md)
- [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstorequeryentitledproductsasync.md)
- [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/ja-jp/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)
- [消費型ベースのエコシステム](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-consumables.md)