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

# POST (/users/xuid({xuid})/outbox)

> POST (/users/xuid({xuid})/outbox)

# POST (/users/xuid({xuid})/outbox)

指定されたメッセージを受信者のリストに送信します。
これらの URI のドメインは `msg.xboxlive.com` です。

* [解説](#ID4EV)
* [URI パラメーター](#ID4EAB)
* [認可](#ID4ENB)
* [プライバシー設定がリソースに与える影響](#ID4EYB)
* [要求本文](#ID4E3F)
* [HTTP 状態コード](#ID4ETCAC)
* [応答本文](#ID4E1EAC)

## 解説

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

## URI パラメーター

| パラメーター | 型 | 説明 |
| - | - | - |
| xuid | 符号なし 64 ビット整数 | 要求を行うプレイヤーの XBOX ユーザー ID (XUID)。 |

## 認可

ユーザー メッセージを送信するには、独自のユーザー クレームと有効な Gold サブスクリプションが必要です。

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

プレイヤーがフレンドであるか否かにかかわらず、ユーザー メッセージをそのプレイヤーに正常に送信すると、200 の結果コードが返されます。ただし、自分をブロックしている相手にメッセージを送信した場合、受信者はそのメッセージを受け取らず、送信者側にはメッセージが失敗したことを示す表示は行われません。

また、1 日に送信できるメッセージ数、フレンドおよび非フレンドへの送信数には以下の制限があります。

* メッセージあたり 20 人までの見知らぬユーザー
* 24 時間あたり 200 人までの見知らぬユーザー
* 24 時間あたり合計 250 メッセージ
* 24 時間あたり合計 2500 人までの受信者

\| 要求ユーザー | 対象ユーザーのプライバシー設定 | 動作 |
\| --- | --- | --- | --- | --- | --- |
\| me | - | 説明のとおり。 |
\| friend | everyone | 200 OK |
\| friend | friends only | 200 OK |
\| friend | blocked | 200 OK |
\| non-friend user | everyone | 200 OK |
\| non-friend user | friends only | 200 OK |
\| non-friend user | blocked | 200 OK |
\| third-party site | everyone | 200 OK |
\| third-party site | friends only | 200 OK |
\| third-party site | blocked | 200 OK |

## 要求本文

| プロパティ | 型 | 最大長 | コンシューマー | 解説 |
| - | - | - | - | - |
| header | Header | | すべて | ユーザー メッセージ ヘッダー |
| messageText | string | 250 | Windows 8 を除くすべてのプラットフォーム | ユーザー メッセージ テキスト (UTF-8) |

#### Header

| プロパティ | 型 | 最大長 | コンシューマー | 解説 |
| - | - | - | - | - |
| recipients | User\[] | 20 | すべて | メッセージ受信者のリスト |

#### User

| プロパティ | 型 | 最大長 | コンシューマー | 解説 |
| - | - | - | - | - |
| xuid | ulong | | すべて | 受信者の XUID。gamertag が送信される場合は使用されません。 |
| gamertag | string | 15 | すべて | 受信者のゲーマータグ。XUID が送信される場合は使用されません。 |

#### 要求本文の例

```cpp theme={null}
{
          "header":
          {
            "recipients":
            [{"gamertag":"GoTeamEmily"},
            {"gamertag":"Longstreet360"}]
          },
          "messageText":"random user text"
        }

```

## HTTP 状態コード

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

\| コード | 説明 |
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200 | 成功。 |
\| 400 | 受信者のリストが空か、最大長を超えています。または、gamertag と XUID の両方が指定されました。または、messageText が長すぎます。 |
\| 403 | XUID を変換できません。 |
\| 404 | gamertag が無効か、ユーザーが見つかりません。 |
\| 409 | ユーザーがシステムによって課された 1 日の制限に達しました。 |
\| 500 | 一般的なサーバー側のエラーです。 |

## 応答本文

応答の本文にはオブジェクトは送信されません。

## 関連項目

##### 親

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

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


## Related topics

- [XblSocialSubmitReputationFeedbackAsync](https://devdocs.xbox.com/fr-CA/reference/live/xsapi-c/social_c/functions/xblsocialsubmitreputationfeedbackasync.md)
- [XblAchievementsManagerUpdateAchievement](https://devdocs.xbox.com/es/reference/live/xsapi-c/achievements_manager_c/functions/xblachievementsmanagerupdateachievement.md)