Microsoft Store のサービス間 REST リファレンス (collections、purchase、clawback、grant、recurrences) をお探しですか? これは API タブの Microsoft Store REST API にあります。
このセクションの内容
はじめに
概要、製品タイプ、パートナー センターのセットアップ、テスト、ライセンス、トラブルシューティング。
基本
基本的な Store 操作、DLC、体験版、消費型、バンドル、DWOB、更新プログラム。
サービスからの管理
サービスの認証、エンタイトルメント、サブスクリプション、返金、ユーザー Store ID の照会。
PC 固有の考慮事項
DRM、ライセンス トークン、Store アカウントの不一致処理、およびサンドボックスの切り替え。
Microsoft Store REST API
v8/v9 の collections、purchase、clawback、grant、および recurrences エンドポイントのリファレンス。完全なリファレンスは API タブの Microsoft Store REST API にあります。
フランチャイズ ゲーム ハブ
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 の検出、返金の処理) にはサービスを使用します。 信頼できるパターン:- クライアントは購入または使用を検出し、即時 UX を表示します。
- クライアントはサービスに UserStoreId を送信します。
- サービスは Store S2S API を呼び出して、エンタイトルメントを確認するか、消費型を履行し、正規のデータベースを更新します。