Skip to main content

​
POST (/users/xuid()/devices/current/titles/current)

ユーザーのプレゼンスでタイトルを更新します。 これらの URI のドメインは userpresence.xboxlive.com です。

​
備考

この URI は、コンソール以外のプラットフォーム上のすべてのタイトルで、タイトルのプレゼンス、リッチ プレゼンス、およびメディア プレゼンス データを追加および更新するために使用できます。 SandboxId は XToken 内のクレームから取得され、強制されるようになりました。SandboxId が存在しない場合、Entertainment Discovery Services (EDS) は 400 Bad request エラーをスローします。

​
URI パラメーター

​
認可

| Type| Required| Description| Response if missing| | --- | --- | --- | --- | --- | --- | --- | | XUID| Yes| 呼び出し元の XBOX User ID (XUID)| 403 Forbidden| | titleId| Yes| タイトルの titleId| 403 Forbidden| | deviceId| Windows および Web を除くすべてで必須| 呼び出し元の deviceId| 403 Forbidden| | deviceType| Web を除くすべてで必須| 呼び出し元の deviceType| 403 Forbidden| | sandboxId| からの呼び出しの場合は必須| 呼び出し元のサンドボックス| 403 Forbidden|

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

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 認証用の認証資格情報。値の例: “XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 3、vnext。| | Content-Type| string| リクエスト本文の MIME タイプ。値の例: application/json。| | Content-Length| string| リクエスト本文の長さ。値の例: 312。| | Host| string| サーバーのドメイン名。値の例: presencebeta.xboxlive.com。|

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

| Header| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | X-RequestedServiceVersion| | リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。既定値: 1。|

​
リクエスト本文

リクエスト オブジェクトは TitleRequest です。本文に実際に存在するプロパティのみが更新されます。本文に含まれていないがサーバー上に存在するプロパティは変更されません。

​
リクエスト例

​
レスポンス本文

成功した場合、必要に応じて HTTP ステータス コード 200 または 201 Created が返されます。 エラーが発生した場合 (HTTP 4xx または 5xx)、適切なエラー情報がレスポンス本文で返されます。

​
関連項目

親
/users/xuid()/devices/current/titles/current
詳細情報
Marketplace URIs 追加リファレンス
Last modified on October 19, 2026