Skip to main content

GET (/users//profile/settings/people/)

People モニカーをサポートして、ユーザーまたは複数のユーザーのプロファイルを取得します。 これらの URI のドメインは profile.xboxlive.com です。

備考

userList と userIds は相互排他的なパラメーターです。両方または一方が指定されると、BadRequest が返されます。userList は、複数の名前付きリストをリクエストすることが有用なシナリオに備えて配列になっています。userIds は、XUID を表す 10 進数の文字列で構成されます (JSON は 64 ビット符号なし整数のシリアル化が不得意なため)。最後に、XBOX One の設定は 64 ビット符号なし整数や XONLINE_PROFILE_ASDF のような不明瞭な定数ではなく、人間が読める通常の名前で命名されます。

URI パラメーター

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

| Parameter| Type| Description| | --- | --- | --- | --- | --- | --- | | settings| string| 設定名のカンマ区切りリスト。|

必須リクエスト ヘッダー

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | | x-xbl-contract-version| 32-bit signed integer| 値 = 2| | content-type| string| 値 = application/json|

リクエスト本文

リクエスト例

レスポンス本文
レスポンスは ReadMultiSettingsResponseV2 オブジェクトです。呼び出し元ユーザーにフレンドが 1 人だけいると仮定した場合:

関連項目

親
/users//profile/settings/people/?settings= Profile (JSON)
Last modified on October 19, 2026