サービスから製品を管理する
タイトルでは、ゲーム内のコマース エクスペリエンスを実装して、クライアント アプリから管理できますが、ゲームの Web サービスから Microsoft Store API を直接呼び出すというシナリオもあり、それによる利点があります。 たとえば、サービス間の直接通信は、ユーザーのネットワークとクライアントによって制御されるトラフィックよりも信頼性と安定性が高くなります。 こうした API は、クロスプラットフォーム サービスでサポートされるアドオン カタログで開発者が使用するように設計された REST HTTPS エンドポイントで構成されています。 該当する API には、次のサービスと機能が含まれています。
Microsoft Store コレクション サービス:
- ゲーム共有ではない製品の直接の所有権を検証します。
- 実行中のタイトルだけでなく、発行元カタログ全体からユーザーが所有する製品を表示します。
- 消費型アイテム製品のフルフィルメントに関する信頼性のある多重の保護手段。
- ユーザーの Xbox Game Pass サブスクリプションの状態を表示します (Microsoft からの許可が必要です)。
Microsoft Store 購入サービス:
- ユーザーのアカウントに無料の製品を直接付与します。
Microsoft Clawback サービス:
- フルフィルメントが完了した消費型アイテム製品についてユーザーに発行された返金を検出します。
Microsoft Recurrence サービス:
- ユーザーのサブスクリプションを表示、管理、またはキャンセルします (カスタマー サポート チームとゲーム内のユーザーに役立ちます)。
次の記事では、こうした機能の使用方法と、独自サービスへの統合方法について説明しています。
このセクションの内容
Microsoft Store API によるサービスの認証
代理認証トークンまたはユーザー Store ID を取得して使用し、Microsoft Store サービスで認証する方法を説明します。
サービスからユーザーの資格をクエリする
自分のサービスからユーザーが資格を得ているデジタル コンテンツをクエリする方法について説明します。
サービスから Xbox Game Pass サブスクリプションのアクセスを検出する
ユーザーの Xbox Game Pass サブスクリプションのステータスを検出する方法について説明します。
サービスからのサブスクリプション製品の管理
Recurrence サービスを使用してサブスクリプション製品のクエリと管理を行い、ユーザーのさまざまなサブスクリプションの状態を処理する方法について説明します。
サービスから消費型アイテムの製品を管理する
消費されたアイテムのユーザー返金の管理など、ゲーム サービス上の消耗品を管理する堅牢なシステムを構築する方法について説明します。
サービスからの払い戻しとチャージバックの管理
Clawback イベント キューを構成して使用して、消費型およびストアで管理されるサブスクリプション製品の種類の払い戻し、返品、チャージバックを検出する方法について説明します。
サービス間認証にユーザー Store ID を要求する
Microsoft Store サービス API でサービス間認証用のユーザー Store ID を取得するために必要な構成と手順について説明します。
XSTS トークンまたは OAuth 2.0 を使用してサービスからユーザー Store IDを要求する
OAuth 2.0 と X トークンを使用して、クライアントにアクセス トークンを交換したり、クライアント アプリで API を呼び出したりすることなく、サービスでユーザー Store ID を生成する方法について説明します。
ユーザー Store ID キーを更新する
ユーザー Store ID キーを更新する方法を説明します。