Skip to main content

POST (/serviceconfigs//sessiontemplates//batch)

複数の XBOX ユーザー ID に対するバッチ クエリを作成します。
重要:
このメソッドは 2015 Multiplayer で使用され、そのマルチプレイヤー バージョン以降にのみ適用されます。テンプレート コントラクト 104/105 以降での使用を意図しており、すべてのリクエストにヘッダー要素 X-Xbl-Contract-Version: 104/105 以降が必要です。

解説

この HTTP/REST メソッドは、セッション テンプレート レベルで複数の XBOX ユーザー ID に対するバッチ クエリを作成します。このメソッドは Microsoft.Xbox.Services.Multiplayer.MultiplayerService.GetSessionsForUsersFilterAsync によってラップできます。 2015 Multiplayer では、xuid クエリ文字列パラメーターで表される、異なる XBOX ユーザー ID (XUID) を扱う点を除きすべて同じであるクエリを、単一の呼び出しにまとめることができます。通常のクエリとバッチ クエリで、クエリ文字列パラメーターとレスポンスは同じであることに注意してください。 バッチ クエリでは、各 XUID に属するセッションは、リクエストで示された xuid パラメーターと同じ順序でレスポンスに書き込まれます。同じセッションがレスポンス内に複数回、一致した xuid ごとに 1 回ずつ出現する可能性があります。

URI パラメーター

| パラメーター | 型 | 説明 | | --- | --- | --- | --- | | scid| GUID| サービス構成識別子 (SCID)。セッション識別子のパート 1。| | sessionTemplateName| string| セッション テンプレートの現在のインスタンスの名前。セッション識別子のパート 2。|

クエリ文字列パラメーター

クエリは、次の表のクエリ文字列パラメーターを使用して変更できます。 | パラメーター| 型| 説明| | --- | --- | --- | --- | --- | --- | --- | | keyword| string| 取得対象のセッションまたはテンプレートに含まれている必要のあるキーワード (例: “foo”)。 | | xuid| 64-bit unsigned integer| クエリに含めるセッションの XBOX ユーザー ID (例: “123”)。既定では、ユーザーがセッションに含まれるためには、そのセッションでアクティブである必要があります。 | | reservations| boolean| ユーザーが予約プレイヤーとして設定されているがアクティブ プレイヤーとして参加していないセッションを含めるには true。このパラメーターは、自分自身のセッションを問い合わせる場合、または特定のユーザーのセッションをサーバー間で問い合わせる場合にのみ使用されます。 | | inactive| boolean| ユーザーが承諾しているがアクティブにプレイしていないセッションを含めるには true。ユーザーが “ready” だが “active” でないセッションは非アクティブとしてカウントされます。 | | private| boolean| プライベート セッションを含めるには true。このパラメーターは、自分自身のセッションを問い合わせる場合、または特定のユーザーのセッションをサーバー間で問い合わせる場合にのみ使用されます。 | | visibility| string| セッションの可視性の状態。可能な値は MultiplayerSessionVisibility で定義されています。このパラメーターが “open” に設定されている場合、クエリはオープン セッションのみを含める必要があります。“private” に設定されている場合は、private パラメーターを true に設定する必要があります。 | | version| 32-bit signed integer| 含める最大セッション バージョン。たとえば、値 2 は、メジャー セッション バージョンが 2 以下のセッションのみを含めるように指定します。バージョン番号は、リクエストのコントラクト バージョンを 100 で割った剰余以下である必要があります。 | | take| 32-bit signed integer| 取得するセッションの最大数。この数は 0 から 100 の間である必要があります。 | private または reservations のいずれかを true に設定するには、セッションに対するサーバー レベル アクセス権が必要です。あるいは、これらの設定には、呼び出し元の XUID クレームが URI 内の XUID フィルターと一致することが必要です。それ以外の場合、該当するセッションが実際に存在するかどうかにかかわらず、HTTP/403 ステータス コードが返されます。

HTTP ステータス コード

サービスは、MPSD に適用される HTTP ステータス コードを返します。

リクエスト本文

レスポンス本文

このメソッドから返されるのは、一部のセッション データがインラインで含まれる、セッション参照の JSON 配列です。

関連項目

親
/serviceconfigs//sessiontemplates//batch
Last modified on October 19, 2026