> ## 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})/groups/{moniker}/broadcasting/count )

> GET (/users/xuid({xuid})/groups/{moniker}/broadcasting/count )

# GET (/users/xuid({xuid})/groups/{moniker}/broadcasting/count )

擷取由與 URI 中 XUID 相關之群組 moniker 所指定的廣播使用者的計數。
這些 URI 的網域為 `userpresence.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4E5)
* [查詢字串參數](#ID4EJB)
* [授權](#ID4EKC)
* [隱私權設定對資源的影響](#ID4EQD)
* [必要的要求標頭](#ID4EEH)
* [選用的要求標頭](#ID4EMBAC)
* [要求本文](#ID4EMCAC)
* [HTTP 狀態碼](#ID4EXCAC)
* [必要的回應標頭](#ID4E3GAC)
* [選用的回應標頭](#ID4EMJAC)
* [回應本文](#ID4E5KAC)

<a id="ID4EV" />

## 備註

擷取由與 URI 中 XUID 相關之群組 moniker 所指定的廣播使用者的計數。

<a id="ID4E5" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| xuid | 字串 | 與群組中 XUID 相關之使用者的 XBOX 使用者識別碼 (XUID)。 |
| moniker | 字串 | 定義使用者群組的字串。目前唯一接受的 moniker 是 "People"，且 'P' 為大寫。 |

<a id="ID4EJB" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| level| 字串| 依此查詢字串指定的詳細程度傳回。有效選項包括 "user"、"device"、"title" 和 "all"。"user" 層級是不含 DeviceRecord 巢狀物件的 PresenceRecord 物件。"device" 層級是不含 TitleRecord 巢狀物件的 PresenceRecord 和 DeviceRecord 物件。"title" 層級是不含 ActivityRecord 巢狀物件的 PresenceRecord、DeviceRecord 和 TitleRecord 物件。"all" 層級是整個記錄，包括所有巢狀物件。如果未提供此參數，服務會預設為 title 層級 (也就是說，會傳回此使用者的狀態，詳細至遊戲的層級)。|

<a id="ID4EKC" />

## 授權

使用的授權宣告 | 宣告| 類型| 必要？| 範例值|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| <b>Xuid</b>| 64 位元帶正負號的整數| 是| 1234567890|

<a id="ID4EQD" />

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

如果要求本身的格式正確，服務一律會傳回 200 OK。不過，若未通過隱私權檢查，服務會從回應中篩選掉資訊。

隱私權設定對資源的影響 | 提出要求的使用者| 目標使用者的隱私權設定| 行為|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 我| -| 如所述。|
\| 朋友| 所有人| 如所述。|
\| 朋友| 僅限朋友| 如所述。|
\| 朋友| 已封鎖| 如所述 - 服務會篩選掉資料。|
\| 非朋友使用者| 所有人| 如所述。|
\| 非朋友使用者| 僅限朋友| 如所述 - 服務會篩選掉資料。|
\| 非朋友使用者| 已封鎖| 如所述 - 服務會篩選掉資料。|
\| 協力廠商網站| 所有人| 如所述 - 服務會篩選掉資料。|
\| 協力廠商網站| 僅限朋友| 如所述 - 服務會篩選掉資料。|
\| 協力廠商網站| 已封鎖| 如所述 - 服務會篩選掉資料。|

<a id="ID4EEH" />

## 必要的要求標頭

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

<a id="ID4EMBAC" />

## 選用的要求標頭

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

<a id="ID4EMCAC" />

## 要求本文

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

<a id="ID4EXCAC" />

## HTTP 狀態碼

服務會傳回本節中的其中一個狀態碼，以回應使用此方法對此資源提出的要求。如需搭配 XBOX Live 服務使用的標準 HTTP 狀態碼完整清單，請參閱[標準 HTTP 狀態碼](/zh-TW/reference/live/rest/additional/httpstatuscodes)。

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功擷取工作階段。|
\| 400| Bad Request| 服務無法理解格式錯誤的要求。通常是無效的參數。|
\| 401| Unauthorized| 要求需要使用者驗證。|
\| 403| Forbidden| 不允許使用者或服務提出此要求。|
\| 404| Not Found| 找不到指定的資源。|
\| 405| Method Not Allowed| 在不支援的內容類型上使用了 HTTP 方法。|
\| 406| Not Acceptable| 不支援資源版本。|
\| 500| Request Timeout| 服務無法理解格式錯誤的要求。通常是無效的參數。|
\| 503| Request Timeout| 服務無法理解格式錯誤的要求。通常是無效的參數。|

<a id="ID4E3GAC" />

## 必要的回應標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| x-xbl-contract-version| 字串| 此要求應導向之 XBOX LIVE 服務的組建名稱/編號。只有在驗證標頭的有效性、驗證權杖中的宣告等之後，要求才會路由至該服務。範例值：1、vnext。|
\| Content-Type| 字串| 要求本文的 MIME 類型。範例值：<b>application/json</b>。|
\| Cache-Control| 字串| 指定快取行為的禮貌性要求。範例值："no-cache"。|
\| X-XblCorrelationId| 字串| 服務產生的值，用來將伺服器傳回的內容與用戶端收到的內容建立關聯。範例值："4106d0bc-1cb3-47bd-83fd-57d041c6febe"。|
\| X-Content-Type-Option| 字串| 傳回符合 SDL 規範的值。範例值："nosniff"。|
\| Date| 字串| 訊息傳送的日期/時間。範例值："Tue, 17 Nov 2012 10:33:31 GMT"。|

<a id="ID4EMJAC" />

## 選用的回應標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Retry-After| 字串| 在 503 HTTP 錯誤時傳回。讓用戶端知道重試呼叫前要等待多久。範例值："120"。|
\| Content-Length| 字串| 回應本文的長度。範例值："527"。|
\| Content-Encoding| 字串| 回應的編碼類型。範例值："gzip"。|

<a id="ID4E5KAC" />

## 回應本文

此 API 會根據給定的參數傳回目前廣播數目的計數。

<a id="ID4EGLAC" />

### 範例回應

```cpp theme={null}
{
    "count":42
 }

         
```

<a id="ID4EQLAC" />

## 另請參閱

<a id="ID4ESLAC" />

##### 上層

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


## Related topics

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