> ## 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 コマース システムの概要

> XStore API、パートナー センター、および Microsoft Store REST サービスが XBOX と PC のコマース、ベース ゲーム、DLC などにどのように連携するかを学びます。

**XStore** API は、GDK 上に構築された XBOX および PC タイトル向けの Microsoft Store コマースの実行時側です。パートナー センター (製品をモデル化する場所) と Microsoft Store のサービス間 (S2S) REST API (バックエンドがエンタイトルメントを照会および付与する場所) と組み合わせることで、ベース ゲーム、DLC、体験版、消費型、サブスクリプション、およびバンドル向けの完全なコマース プラットフォームを提供します。

このセクションは Microsoft Learn のトピック レイアウトを反映しており、タイトル向けの Store コマースを設計、統合、テスト、運用するために必要なすべてをカバーしています。

> [!NOTE]
>
> **Microsoft Store のサービス間 REST リファレンス** (collections、purchase、clawback、grant、recurrences) をお探しですか? これは **API** タブの [Microsoft Store REST API](https://docs.xbox.com/ja-jp/reference/microsoft-store-apis/index.md) にあります。

## このセクションの内容

> [card] [はじめに](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-initial-configuration.md)
>
> 概要、製品タイプ、パートナー センターのセットアップ、テスト、ライセンス、トラブルシューティング。

> [card] [基本](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-basic-operations.md)
>
> 基本的な Store 操作、DLC、体験版、消費型、バンドル、DWOB、更新プログラム。

> [card] [サービスからの管理](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-authenticating-service.md)
>
> サービスの認証、エンタイトルメント、サブスクリプション、返金、ユーザー Store ID の照会。

> [card] [PC 固有の考慮事項](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-pc.md)
>
> DRM、ライセンス トークン、Store アカウントの不一致処理、およびサンドボックスの切り替え。

> [card] [Microsoft Store REST API](https://docs.xbox.com/ja-jp/reference/microsoft-store-apis/index.md)
>
> v8/v9 の collections、purchase、clawback、grant、および recurrences エンドポイントのリファレンス。完全なリファレンスは **API** タブの [Microsoft Store REST API](https://docs.xbox.com/ja-jp/reference/microsoft-store-apis/index.md) にあります。

> [card] [フランチャイズ ゲーム ハブ](https://docs.xbox.com/ja-jp/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq.md)
>
> 1 つの Store フランチャイズ ハブの下に複数の製品をグループ化します。

## 全体像: 各要素の連携

* **パートナー センター** — 製品 (ベース ゲーム、アドオン、バンドル、シーズン パス、サブスクリプション、消費型) を作成し、価格と使用可能状況を定義し、識別子 (**StoreId**、**Product ID**、**BigId**、**SKU ID**) を割り当てる場所です。
* **`MicrosoftGame.config`** — タイトル パッケージ内に含まれ、`TitleId`、`StoreId`、および `MSAAppId` を介して実行中の実行可能ファイルを Store 製品にバインドします。
* **XStore ランタイム API (`XStore*`)** — ゲームから製品を列挙する、ライセンスやエンタイトルメントを照会する、購入 UI を表示する、消費型の履行を報告するために行うクライアント側の呼び出し。
* **XPackage API (`XPackage*`)** — オプション パッケージ (DLC) をマウントおよびライセンス供与し、チャンクをインストールし、パッケージの状態変化を観察します。
* **Microsoft Store S2S REST API** — バックエンドが呼び出し、エンタイトルメントを正式に照会し、消費型を履行し、製品を付与し、サブスクリプションを検索し、返金/クローバックを処理するサーバー側エンドポイント。
* **ユーザー Store ID (UserStoreId)** — タイトルが `XUserGetTokenAndSignatureAsync` (または `XStoreGetUserCollectionsIdAsync` / `XStoreGetUserPurchaseIdAsync`) を通じて取得する短命キー。サービスに渡すことで、サービスがそのユーザーの代わりに Store を呼び出せるようになります。

## クライアント対サービス

ほとんどすべての Store シナリオには、**クライアント側** (XStore) と **サービス側** (S2S REST) の両方の経路があります。リアルタイム UX (購入ボタンの表示、コンテンツのアンロック、消費型の使用の報告) にはクライアントを使用します。権威性が重要な場合 (タイトルの再インストール後も維持される必要のある仮想通貨の使用の履行、プロモーション アイテムの付与、Game Pass の検出、返金の処理) にはサービスを使用します。

信頼できるパターン:

1. クライアントは購入または使用を検出し、即時 UX を表示します。
2. クライアントはサービスに UserStoreId を送信します。
3. サービスは Store S2S API を呼び出して、エンタイトルメントを確認するか、消費型を履行し、正規のデータベースを更新します。

## 次に進む場所

XStore を初めて使用する場合は、[GDK コマース システムの概要](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-overview.md)から始めて、次に[適切な製品タイプを選択する](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-choosing-product-type.md)に進んでください。


## Related topics

- [GDK コマース システムの概要](https://docs.xbox.com/ja-jp/publishing/xstore-commerce/xstore-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)