> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET (/users/{ownerId}/people)

> GET (/users/\{ownerId}/people)

# GET (/users/\{ownerId}/people)

呼び出し元の people コレクションを取得します。
これらの URI のドメインは `social.xboxlive.com` です。

* [備考](#ID4EV)
* [URI パラメーター](#ID4E5)
* [クエリ文字列パラメーター](#ID4EJB)
* [認可](#ID4ERD)
* [必須リクエスト ヘッダー](#ID4EZE)
* [オプションのリクエスト ヘッダー](#ID4EYF)
* [リクエスト本文](#ID4E5G)
* [HTTP ステータス コード](#ID4EJH)
* [必須レスポンス ヘッダー](#ID4EBBAC)
* [レスポンス本文](#ID4ENCAC)

## 備考

GET 操作はリソースを変更しないため、1 回実行しても複数回実行しても同じ結果が得られます。

## URI パラメーター

| Parameter | Type | Description |
| - | - | - |
| ownerId | string | アクセス対象のリソースを持つユーザーの識別子。認証済みのユーザーと一致する必要があります。指定可能な値は "me"、xuid(\{xuid})、または gt(\{gamertag}) です。 |

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

| Parameter | Type | Description |
| - | - | - |
| view | string | ビューに関連付けられた People を返します。既定値は "all" です。指定可能な値は次のとおりです: **All** - ユーザーの People リストにあるすべての People を返します。これが既定値です。 **Favorite** - ユーザーの People リストにある People のうち、Favorite 属性を持つすべての People を返します。 **LegacyXboxLiveFriends** - ユーザーの People リストにある People のうち、レガシ XBOX Live のフレンドでもあるすべての People を返します。 **注:** 呼び出し元のユーザーがオーナー ユーザーと異なる場合、**All** 値のみがサポートされます。 |
| startIndex | 32-bit unsigned integer | 指定したインデックスから始まるアイテムを返します。 |
| maxItems | 32-bit unsigned integer | 開始インデックスから始めて、コレクションから返す People の最大数。**maxItems** が指定されていない場合、サービスは既定値を使用することがあり、また (結果の最後のページがまだ返されていない場合でも) **maxItems** より少ない数を返すことがあります。 |

## 認可

| Type | Required | Description | Response if missing |
| - | - | - | - |
| XUID | yes | 呼び出し元はユーザーの XBOX User ID (XUID) を持っています。 | 401 Unauthorized |

## 必須リクエスト ヘッダー

| Header | Description |
| - | - |
| Authorization | String。XBOX Live の認証データ。通常は暗号化された XSTS トークンです。値の例: **XBL3.0 x=\<userhash>;\<token>**。 |

## オプションのリクエスト ヘッダー

| Header | Description |
| - | - |
| X-RequestedServiceVersion | リクエストのルーティング先となる XBOX Live サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。既定値: 1。 |
| Accept | String。呼び出し元がレスポンスで受け入れる Content-Type。すべてのレスポンスは **application/json** です。 |

## リクエスト本文

このリクエストの本文にはオブジェクトは送信されません。

## HTTP ステータス コード

このリソースに対して、このメソッドで行われたリクエストに応じて、サービスはこのセクションのステータス コードのいずれかを返します。XBOX Live Services で使用される標準の HTTP ステータス コードの完全な一覧については、「[標準 HTTP ステータス コード](https://docs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes.md)」を参照してください。

| Code | Reason phrase | Description |
| - | - | - |
| 200 | OK | 成功。 |
| 400 | Bad Request | クエリ パラメーターまたはユーザー ID の形式が正しくありませんでした。 |
| 403 | Forbidden | 認証ヘッダーから XUID クレームを解析できませんでした。 |

## 必須レスポンス ヘッダー

| Header | Type | Description |
| - | - | - |
| Content-Length | 32-bit unsigned integer | レスポンス本文のバイト単位の長さ。値の例: 22。 |
| Content-Type | string | レスポンス本文の MIME タイプ。常に **application/json** です。 |

## レスポンス本文

呼び出しが成功すると、サービスは呼び出し元の people コレクション内の People の総数と、呼び出し元の people コレクションを含む配列を返します。「[PeopleList (JSON)](https://docs.xbox.com/ja-jp/reference/live/rest/json/json-peoplelist.md)」を参照してください。

### レスポンス例

```json theme={null}
{
    "people": [
        {
            "xuid": "2603643534573573",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573572",
            "isFavorite": true,
            "isFollowingCaller": false,
            "socialNetworks": ["LegacyXboxLive"]
        },
        {
            "xuid": "2603643534573577",
            "isFollowingCaller": false,
            "isFavorite": false
        },
    ],
    "totalCount": 3
}

```

## 関連項目

##### 親

[/users/\{ownerId}/people](https://docs.xbox.com/ja-jp/reference/live/rest/uri/people/uri-usersowneridpeople.md)


## Related topics

- [GET (/users/{ownerId}/people/mute)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/privacy/uri-privacyusersowneridpeoplemuteget.md)
- [GET (/users/{ownerId}/people/avoid)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoidget.md)
- [GET (/users/{ownerId}/people/{targetid})](https://docs.xbox.com/ja-jp/reference/live/rest/uri/people/uri-usersowneridpeopletargetidget.md)
- [XblSocialGetSocialRelationshipsAsync](https://docs.xbox.com/ja-jp/reference/live/xsapi-c/social_c/functions/xblsocialgetsocialrelationshipsasync.md)
- [/users/{ownerId}/people](https://docs.xbox.com/ja-jp/reference/live/rest/uri/people/uri-usersowneridpeople.md)
