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

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

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

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

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

<CardGroup cols={2}>
  <Card title="はじめに" icon="rocket" href="/publishing/xstore-commerce/xstore-initial-configuration">
    概要、製品タイプ、パートナー センターのセットアップ、テスト、ライセンス、トラブルシューティング。
  </Card>

  <Card title="基本" icon="cube" href="/publishing/xstore-commerce/xstore-basic-operations">
    基本的な Store 操作、DLC、体験版、消費型、バンドル、DWOB、更新プログラム。
  </Card>

  <Card title="サービスからの管理" icon="network-wired" href="/publishing/xstore-commerce/xstore-authenticating-service">
    サービスの認証、エンタイトルメント、サブスクリプション、返金、ユーザー Store ID の照会。
  </Card>

  <Card title="PC 固有の考慮事項" icon="windows" href="/publishing/xstore-commerce/xstore-pc">
    DRM、ライセンス トークン、Store アカウントの不一致処理、およびサンドボックスの切り替え。
  </Card>

  <Card title="Microsoft Store REST API" icon="code" href="/reference/microsoft-store-apis/index">
    v8/v9 の collections、purchase、clawback、grant、および recurrences エンドポイントのリファレンス。完全なリファレンスは **API** タブの [Microsoft Store REST API](/reference/microsoft-store-apis/index) にあります。
  </Card>

  <Card title="フランチャイズ ゲーム ハブ" icon="sitemap" href="/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq">
    1 つの Store フランチャイズ ハブの下に複数の製品をグループ化します。
  </Card>
</CardGroup>

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

* **パートナー センター** — 製品 (ベース ゲーム、アドオン、バンドル、シーズン パス、サブスクリプション、消費型) を作成し、価格と使用可能状況を定義し、識別子 (**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 コマース システムの概要](/publishing/xstore-commerce/xstore-overview)から始めて、次に[適切な製品タイプを選択する](/publishing/xstore-commerce/xstore-choosing-product-type)に進んでください。


## Related topics

- [GDK コマース システムの概要](/ja-jp/publishing/xstore-commerce/xstore-overview.md)
- [XStore](/ja-jp/reference/system/xstore/xstore_members.md)
- [基本的な DRM とライセンス チェック](/ja-jp/publishing/xstore-commerce/xstore-basic-drm.md)
- [XStore 開発のトラブルシューティング](/ja-jp/publishing/xstore-commerce/xstore-troubleshooting.md)
- [基本的な Store 操作](/ja-jp/publishing/xstore-commerce/xstore-basic-operations.md)