> ## 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/xuid({xuid})/inbox/{messageId})

> GET (/users/xuid({xuid})/inbox/{messageId})

# GET (/users/xuid({xuid})/inbox/{messageId})

特定のユーザー メッセージの詳細なメッセージ テキストを取得し、サービス上で既読としてマークします。
これらの URI のドメインは `msg.xboxlive.com` です。

* [解説](#ID4EV)
* [URI パラメーター](#ID4EEB)
* [認可](#ID4ERB)
* [要求本文](#ID4E3B)
* [プライバシー設定がリソースに与える影響](#ID4EJC)
* [HTTP 状態コード](#ID4EUC)
* [JavaScript Object Notation (JSON) 応答](#ID4EUE)

## 解説

get 操作は、User、System、および FriendRequest のメッセージ タイプでのみ実行できます。

この URI は Xbox.com での更新が必要です。現在、XBOX 360 では、ユーザーがサインアウトして再度サインインするまで、既読/未読の状態は更新されません。

この API がサポートするコンテンツ タイプは "application/json" のみで、各呼び出しの HTTP ヘッダーで必須です。

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | 符号なし 64 ビット整数 | 要求を行うプレイヤーの XBOX ユーザー ID (XUID)。 |
| messageId | string\[50] | 取得または削除されるメッセージの ID。 |

## 認可

ユーザー メッセージを取得するには、独自のユーザー クレームが必要です。

## 要求本文

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

## プライバシー設定がリソースに与える影響

自分のユーザー メッセージを取得できるのは自分だけです。

## HTTP 状態コード

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

\| コード | 説明 |
\| --- | --- | --- | --- | --- |
\| 200 | 成功。 |
\| 400 | XUID を正しく変換できません。 |
\| 403 | XUID を変換できないか、有効な XUID クレームが見つかりません。 |
\| 404 | 有効な XUID が指定されていないか、メッセージ ID が見つからないか、正しく解析されません。 |
\| 500 | 一般的なサーバー側のエラー、またはメッセージ タイプが GET に有効ではありません。 |

## JavaScript Object Notation (JSON) 応答

正常に呼び出された場合、サービスは結果データを JSON 形式で返します。ルート オブジェクトは UserMessageHeader オブジェクトです。

#### UserMessageHeader

| プロパティ | 型 | 最大長 | 解説 |
| - | - | - | - |
| header | Header | | JSON オブジェクト |
| messageText | string | 256 | UTF-8 |

#### Header

| プロパティ | 型 | 最大長 | 解説 |
| - | - | - | - |
| sent | DateTime | | メッセージが送信された日時。(サービスによって提供されます。) |
| expiration | DateTime | | メッセージの有効期限が切れる日時。(すべてのメッセージには最大存続期間があり、将来決定されます。) |
| messageType | string | 13 | メッセージの種類: User、System、FriendRequest。 |
| senderXuid | ulong | | 送信者の XUID。 |
| sender | string | 15 | 送信者のゲーマータグ。 |
| hasAudio | bool | | メッセージにオーディオ (音声) の添付ファイルがあるかどうか。 |
| hasPhoto | bool | | メッセージに写真の添付ファイルがあるかどうか。 |
| hasText | bool | | メッセージにテキストが含まれているかどうか。 |

#### 応答例

```cpp theme={null}
{
          "header":
          {
            "expiration":"2011-10-11T23:59:59.9999999",
            "messageType":"User",
            "senderXuid":"123456789",
            "sender":"Striker",
            "sent":"2011-05-08T17:30:00Z",
            "hasAudio":false,
            "hasPhoto":false,
            "hasText":true
          },
        "messageText":"random user text up to 256 characters"
        }

```

#### エラー応答

エラーの場合、サービスはサービス環境の値を含む可能性がある errorResponse オブジェクトを返すことがあります。

\| プロパティ | 型 | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| errorSource | string | エラーの発生元を示します。 |
\| errorCode | int | エラーに関連付けられた数値コード (null の場合があります)。 |
\| errorMessage | string | 詳細を表示するように構成されている場合のエラーの詳細。 |

## 関連項目

##### 親

[/users/xuid({xuid})/inbox](https://devdocs.xbox.com/ja-jp/reference/live/rest/uri/users/uri-usersxuidinbox)

##### リファレンス  [標準 HTTP 状態コード](https://devdocs.xbox.com/ja-jp/reference/live/rest/additional/httpstatuscodes)


## Related topics

- [XblAchievementsGetAchievementsForTitleIdAsync](https://devdocs.xbox.com/zh-TW/reference/live/xsapi-c/achievements_c/functions/xblachievementsgetachievementsfortitleidasync.md)
- [XblUserStatisticsGetSingleUserStatisticAsync](https://devdocs.xbox.com/ja-jp/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)