> ## 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}))

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

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

探索其他使用者或用戶端的狀態。
這些 URI 的網域為 `userpresence.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4EDB)
* [查詢字串參數](#ID4EOB)
* [授權](#ID4E4C)
* [隱私權設定對資源的影響](#ID4EAE)
* [必要的要求標頭](#ID4EVH)
* [選用的要求標頭](#ID4E1BAC)
* [要求本文](#ID4E1CAC)
* [回應本文](#ID4EFDAC)

<a id="ID4EV" />

## 備註

如果取用者對整個物件不感興趣，可以篩選回應，只提供 [PresenceRecord](/zh-TW/reference/live/rest/json/json-presencerecord) 的一部分。

> **注意：**\
> 傳回的資料受到隱私權和內容隔離規則的限制。

<a id="ID4EDB" />

## URI 參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- |
\| xuid| 64 位元不帶正負號的整數| 目標使用者的 XBOX 使用者識別碼 (XUID)。|

<a id="ID4EOB" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- |
\| level| 字串| 選用。<ul><li><b>user</b>：僅傳回使用者節點。</li><li><b>device</b>：傳回使用者節點和裝置節點。</li><li><b>title</b>：預設值。傳回活動以外的整個樹狀結構。</li><li><b>all</b>：傳回整個樹狀結構，包括活動層級的狀態。</li></ul> |

<a id="ID4E4C" />

## 授權

\| 類型| 必要| 描述| 遺漏時的回應|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| XUID| 是| 呼叫者的 XBOX 使用者識別碼 (XUID)| 403 Forbidden|

<a id="ID4EAE" />

## 隱私權設定對資源的影響

此方法一律傳回 200 OK，但回應本文中可能不會傳回內容。

\| 提出要求的使用者| 目標使用者的隱私權設定| 行為|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 我| -| 200 OK|
\| 朋友| 所有人| 200 OK|
\| 朋友| 僅限朋友| 200 OK|
\| 朋友| 已封鎖| 200 OK|
\| 非朋友使用者| 所有人| 200 OK|
\| 非朋友使用者| 僅限朋友| 200 OK|
\| 非朋友使用者| 已封鎖| 200 OK|
\| 協力廠商網站| 所有人| 200 OK|
\| 協力廠商網站| 僅限朋友| 200 OK|
\| 協力廠商網站| 已封鎖| 200 OK|

<a id="ID4EVH" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization| 字串| HTTP 驗證的驗證認證。範例值："XBL3.0 x=\<userhash>;\<token>"。|
\| x-xbl-contract-version| 字串| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。範例值：3、vnext。|
\| Accept| 字串| 可接受的 Content-Type。Presence 唯一支援的是 application/json，但必須在標頭中指定。|
\| Accept-Language| 字串| 回應中字串可接受的地區設定。範例值：en-US。|
\| Host| 字串| 伺服器的網域名稱。範例值：presencebeta.xboxlive.com。|

<a id="ID4E1BAC" />

## 選用的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| X-RequestedServiceVersion|  | 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。預設值：1。|

<a id="ID4E1CAC" />

## 要求本文

此要求的本文中不會傳送任何物件。

<a id="ID4EFDAC" />

## 回應本文

<a id="ID4ELDAC" />

### 範例回應

如果使用者沒有現有的記錄，則會傳回沒有裝置的記錄。

```json theme={null}
{
  xuid:"0123456789",
  state:"online",
  devices:
  [{
    type:"D",
    titles:
    [{
      id:"12341234",
      name:"Contoso 5",
      state:"active",
      placement:"fill",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Team Deathmatch on Nirvana"
      }
    },
    {
      id:"12341235",
      name:"Contoso Waypoint",
      timestamp:"2012-09-17T07:15:23.4930000",
      placement:"snapped",
      state:"active",
      activity:
      {
        richPresence:"Using radar"
      }
    }]
  },
  {
    type:W8,
    titles:
    [{
      id:"23452345",
      name:"Contoso Gamehelp",
      state:"active",
      placement:"full",
      timestamp:"2012-09-17T07:15:23.4930000",
      activity:
      {
        richPresence:"Nirvana page",
      }
    }]
  }]
}

```

<a id="ID4EXDAC" />

## 另請參閱

<a id="ID4EZDAC" />

##### 上層

[/users/xuid({xuid})](/zh-TW/reference/live/rest/uri/presence/uri-usersxuid)


## Related topics

- [XblUserStatisticsGetSingleUserStatisticAsync](/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticasync.md)
- [XblUserStatisticsGetSingleUserStatisticsAsync](/ko/reference/live/xsapi-c/user_statistics_c/functions/xbluserstatisticsgetsingleuserstatisticsasync.md)