> ## 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.

# セッション ディレクトリ URI

> Session Directory URIs

# Session Directory URIs

このセクションでは、Multiplayer Session Directory (MPSD) に関する XBOX Live Services の Universal Resource Identifier (URI) アドレスと、関連する Hypertext Transport Protocol (HTTP) メソッドについて詳しく説明します。

> **注:**\
> セッション ディレクトリ URI を使用できるのは、XBOX 360、Windows Phone デバイス、または Xbox.com で動作するゲームのタイトルのみです。

* [ドメイン](#ID4EUB)
* [サービス バージョン](#ID4EZB)
* [システム オブジェクトとプロパティ](#ID4EAC)
* [ハンドル](#ID4EBE)

## ドメイン

sessiondirectory.xboxlive.com

## サービス バージョン

これらの REST URI の呼び出し元は、Entertainment Discovery Services (EDS) のサービス バージョンを指定する HTTP ヘッダー X-Xbl-Contract-Version に、104/105 以降の値を渡す必要があります。

## システム オブジェクトとプロパティ

セッションとテンプレートの構成において、MPSD は、ディレクトリが強制および解釈する固定スキーマに準拠する多数のセッション JSON オブジェクトを使用します。さまざまなセッション ディレクトリ URI でサポートされているメソッドを呼び出す際に、これらのオブジェクトはサポートされているスキーマに基づいて検証およびマージされます。マルチプレイヤー構成に関連する主な JSON オブジェクトは次のとおりです:

* [MultiplayerActivityDetails (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-multiplayeractivitydetails)
* [MultiplayerSession (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-multiplayersession)
* [MultiplayerSessionReference (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-multiplayersessionreference)
* [MultiplayerSessionRequest (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-multiplayersessionrequest)

特にゲームに関連する JSON オブジェクトは次のとおりです:

* [GameMessage (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-gamemessage)
* [GameResult (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-gameresult)
* [GameSession (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-gamesession)
* [GameSessionSummary (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-gamesessionsummary)

## ハンドル

2015 Multiplayer に限り、セッションはセッション ハンドルを介してアクセスできます。ハンドルをサポートする機能を提供するために、いくつかの URI が追加されました。

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

[/handles](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handles)

  XBOX One のダッシュボード ユーザー エクスペリエンスに表示するユーザーの現在のアクティビティのセッションを設定し、必要に応じてセッション メンバーを招待する POST 操作をサポートします。

[/handles/{handleId}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleid)

  識別子で指定されたセッション ハンドルに対する DELETE および GET 操作をサポートします。

[/handles/{handleId}/session](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handleshandleidsession)

  ハンドルの逆参照を使用したセッションの PUT および GET 操作をサポートします。

[/handles/query](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-handlesquery)

  セッション ハンドルのクエリを作成する POST 操作をサポートします。

[/serviceconfigs/{scid}/batch](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidbatch)

  サービス構成識別子レベルでのバッチ クエリのための POST 操作をサポートします。

[/serviceconfigs/{scid}/sessions](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessions)

  一連のセッション ドキュメントを取得する GET 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplates)

  一連の MPSD セッション テンプレートを取得する GET 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatename)

  一連のセッション テンプレート名を取得する GET 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/batch](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigscidsessiontemplatessessiontemplatenamebatch)

  セッション テンプレート レベルでのバッチ クエリを作成する POST 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessions)

  指定されたテンプレート名を持つ一連のセッション テンプレートを取得する GET 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionname)

  セッションを作成および取得する PUT および GET 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/members/me](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionssessionnamemembersme)

  セッション メンバーを削除する DELETE 操作をサポートします。

[/serviceconfigs/{scid}/sessiontemplates/{sessionTemplateName}/sessions/{sessionName}/servers/{server-name}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/sessiondirectory/uri-serviceconfigsscidsessiontemplatessessiontemplatenamesessionnamemembersservername)

  セッションの指定されたサーバーを削除する DELETE 操作をサポートします。

## 関連項目

[Matchmaking URIs](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/matchtickets/atoc-reference-matchtickets)

##### 親

[Universal Resource Identifier (URI) リファレンス](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/atoc-xboxlivews-reference-uris)


## Related topics

- [NDA トピック ディレクトリ - Microsoft Learn 公開版へのリンク](https://devdocs.xbox.com/ja-jp/nda/nda-topic-directory.md)
- [Multiplayer Session Directory の概要](https://devdocs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/live-mpsd-overview.md)
- [概念](https://devdocs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/concepts/index.md)
- [Make package (makepkg.exe)](https://devdocs.xbox.com/ja-jp/build/core-features/common/packaging/deployment/makepkg.md)
- [ハウツー](https://devdocs.xbox.com/ja-jp/services/xbox-services/multiplayer/mpsd/how-to/index.md)
