Skip to main content

GET (/users/xuid())

別のユーザーまたはクライアントのプレゼンスを取得します。 これらの URI のドメインは userpresence.xboxlive.com です。

備考

利用者がオブジェクト全体に関心がない場合は、PresenceRecord の一部を提供するようにレスポンスをフィルタリングできます。
注:
返されるデータは、プライバシーおよびコンテンツ分離のルールによって制限されます。

URI パラメーター

| Parameter| Type| Description| | --- | --- | --- | --- | | xuid| 64-bit unsigned integer| 対象ユーザーの XBOX User ID (XUID)。|

クエリ文字列パラメーター

| Parameter| Type| Description| | --- | --- | --- | --- | --- | --- | --- | | level| string| オプション。
  • user: ユーザー ノードのみを返します。
  • device: ユーザー ノードとデバイス ノードを返します。
  • title: 既定値。アクティビティを除くツリー全体を返します。
  • all: アクティビティ レベルのプレゼンスを含む、ツリー全体を返します。
|

認可

| Type| Required| Description| Response if missing| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | XUID| Yes| 呼び出し元の XBOX User ID (XUID)| 403 Forbidden|

プライバシー設定がリソースに及ぼす影響

このメソッドは常に 200 OK を返しますが、レスポンス本文にコンテンツが含まれない場合があります。 | Requesting User| Target User’s Privacy Setting| Behavior| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | me| -| 200 OK| | 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| Type| Description| | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | Authorization| string| HTTP 認証用の認証資格情報。値の例: “XBL3.0 x=<userhash>;<token>”。| | x-xbl-contract-version| string| リクエストのルーティング先となる XBOX LIVE サービスのビルド名/番号。ヘッダーの有効性、認証トークン内のクレームなどを検証した後にのみ、リクエストはそのサービスにルーティングされます。値の例: 3、vnext。| | Accept| string| 受け入れ可能な Content-Type。Presence がサポートするのは application/json のみですが、ヘッダーで指定する必要があります。| | Accept-Language| string| レスポンスの文字列に対して受け入れ可能なロケール。値の例: en-US。| | Host| string| サーバーのドメイン名。値の例: presencebeta.xboxlive.com。|

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

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

リクエスト本文

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

レスポンス本文

レスポンス例

ユーザーの既存のレコードがない場合、デバイスなしのレコードが返されます。

関連項目

親
/users/xuid()
Last modified on October 19, 2026