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

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

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

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

呼び出し元の people コレクションからターゲット ID で個人を取得します。
これらの URI のドメインは `social.xboxlive.com` です。

* [備考](#ID4EV)
* [URI パラメーター](#ID4E5)
* [認可](#ID4EJB)
* [必須リクエスト ヘッダー](#ID4ERC)
* [オプションのリクエスト ヘッダー](#ID4EQD)
* [リクエスト本文](#ID4EWE)
* [HTTP ステータス コード](#ID4EBF)
* [必須レスポンス ヘッダー](#ID4EDH)
* [レスポンス本文](#ID4EQAAC)

## 備考

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

## URI パラメーター

| Parameter | Type | Description |
| - | - | - |
| ownerId | string | アクセス対象のリソースを持つユーザーの識別子。認証済みのユーザーと一致する必要があります。指定可能な値は "me"、xuid({xuid})、または gt({gamertag}) です。 |
| targetid | string | オーナーの People リストからデータを取得する対象ユーザーの識別子。XBOX User ID (XUID) またはゲーマータグです。値の例: xuid(2603643534573581)、gt(SomeGamertag)。 |

## 認可

\| 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://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes)」を参照してください。

\| Code| Reason phrase| Description|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 成功。|
\| 400| Bad Request| ユーザー ID の形式が正しくありませんでした。|
\| 403| Forbidden| 認証ヘッダーから XUID クレームを解析できませんでした。|
\| 404| Not Found| 対象ユーザーがオーナーの People リストに見つかりませんでした。|

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

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

## レスポンス本文

呼び出しが成功すると、サービスは対象の person を返します。「[Person (JSON)](https://devdocs.xbox.com/ja-jp/reference/live/rest/json/json-person)」を参照してください。

### レスポンス例

```cpp theme={null}
{
    "xuid": "2603643534573581",
    "isFavorite": false,
    "isFollowingCaller": false,
    "socialNetworks": ["LegacyXboxLive"]
}
         
```

## 関連項目

##### 親

[/users/{ownerId}/people/{targetid}](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/people/uri-usersowneridpeopletargetid)


## Related topics

- [Displaying people from the People System](https://devdocs.xbox.com/services/xbox-services/community/people-system/concepts/live-pplsys-displaying-people.md)
- [XblPresenceGetPresenceForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/presence_c/functions/xblpresencegetpresenceforsocialgroupasync.md)
- [Privacy and permissions overview](https://devdocs.xbox.com/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [XblMultiplayerGetActivitiesWithPropertiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitieswithpropertiesforsocialgroupasync.md)
- [XblMultiplayerGetActivitiesForSocialGroupAsync](https://devdocs.xbox.com/reference/live/xsapi-c/multiplayer_c/functions/xblmultiplayergetactivitiesforsocialgroupasync.md)