POST (/users/xuid({xuid})/devices/current/titles/current)
ユーザーのプレゼンスでタイトルを更新します。
これらの URI のドメインは userpresence.xboxlive.com です。
解説
本体以外のプラットフォーム上のすべてのタイトルでこの URI を使用して、タイトルのプレゼンス、リッチ プレゼンス、およびメディア プレゼンスのデータを追加および更新できます。
SandboxId は XToken のクレームから取得されて適用されます。 SandboxId が存在しない場合は、Entertainment Discovery Services (EDS) が 400 Bad Request エラーをスローします。
URI パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| xuid | 64 ビット符号なし整数 | ターゲット ユーザーの Xbox ユーザー ID (XUID)。 |
Authorization
| 種類 | 必須かどうか | 説明 | 存在しない場合の応答 |
|---|---|---|---|
| XUID | ○ | 呼び出し元の Xbox ユーザー ID (XUID) | 403 Forbidden |
| titleId | ○ | タイトルのタイトル ID です。 | 403 Forbidden |
| deviceId | はい (Windows および Web を除く) | 呼び出し元のデバイス ID です。 | 403 Forbidden |
| deviceType | はい (Web を除く) | 呼び出し元のデバイス タイプです。 | 403 Forbidden |
| sandboxId | はい ( からの呼び出しの場合) | 呼び出し元のサンドボックスです。 | 403 Forbidden |
必須の要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| Authorization | 文字列 | HTTP 認証用の認証資格情報。 例の値: "XBL3.0 x=<userhash>;<token>"。 |
| x-xbl-contract-version | 文字列 | この要求の送信先である Xbox LIVE サービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 値の例: 3, vnext。 |
| Content-Type | 文字列 | 要求本文の MIME タイプ。値の例: application/json。 |
| Content-Length | 文字列 | 要求本文の長さ。 値の例: 312。 |
| Host | 文字列 | サーバーのドメイン名。 値の例: presencebeta.xboxlive.com。 |
省略可能な要求ヘッダー
| ヘッダー | 型 | 説明 |
|---|---|---|
| X-RequestedServiceVersion | この要求の送信先である Xbox LIVE サービスのビルド名/番号。 要求は、ヘッダー、認証トークン内のクレームなどの有効性が確認された後でのみ、そのサービスにルーティングされます。 既定値: 1。 |
リクエストの本文
要求オブジェクトは TitleRequest です。 本文に実際に存在するプロパティだけが更新されます。 サーバーには存在しても本文には含まれないプロパティは、変更されません。
サンプル要求
{
id:"12341234",
placement:"snapped",
state:"active"
}
応答の本文
成功した場合は、HTTP ステータス コードの 200 または 201 Created が返されます。
エラー (HTTP 4xx または 5xx) の場合は、適切なエラー情報が応答本文で返されます。
関連項目
親
/users/xuid({xuid})/devices/current/titles/current