> ## 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/{ownerId}/people/avoid)

> GET (/users/{ownerId}/people/avoid)

# GET (/users/{ownerId}/people/avoid)

取得使用者的迴避清單。

* [備註](#ID4EQ)
* [URI 參數](#ID4EZ)
* [授權](#ID4EEB)
* [必要的要求標頭](#ID4EJC)
* [HTTP 狀態碼](#ID4EYD)
* [必要的回應標頭](#ID4E1F)
* [回應本文](#ID4ESH)

<a id="ID4EQ" />

## 備註

如果指定了目標，當該使用者在封鎖清單上時，只會傳回該使用者；如果不在清單上，則傳回空白。

<a id="ID4EZ" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| ownerId | 字串 | 必要。正在存取其資源之使用者的識別碼。可能的值為 <code>xuid({xuid})</code>。必須是已驗證的使用者。範例值：<code>xuid(2603643534573581)</code>。大小上限：無。 |

<a id="ID4EEB" />

## 授權

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

<a id="ID4EJC" />

## 必要的要求標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Authorization | 字串| HTTP 驗證的驗證認證。範例值：<code>Xauth=\<authtoken></code>。大小上限：無。|
\| Accept| 字串| 可接受的 Content-Type。範例值：<code>application/json</code>。大小上限：無。|

<a id="ID4EYD" />

## HTTP 狀態碼

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

\| 代碼| 原因片語| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| 200| OK| 已成功擷取工作階段。|
\| 400| Bad Request| URI 中指定的目標識別碼無效。|
\| 403| Forbidden| URI 中指定的擁有者不是已驗證的使用者。|
\| 404| Not Found| URI 中指定的擁有者不存在。|

<a id="ID4E1F" />

## 必要的回應標頭

\| 標頭| 類型| 描述|
\| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
\| Content-Type| 字串| 要求本文的 MIME 類型。範例值：<code>application/json</code>。大小上限：無。|
\| Content-Length| 字串| 回應中傳送的位元組數目。範例值：34。大小上限：無。|
\| Cache-Control| 字串| 伺服器指定快取行為的禮貌性要求。範例值：<code>application/json</code>。大小上限：無。|

<a id="ID4ESH" />

## 回應本文

<a id="ID4EYH" />

### 範例回應

```cpp theme={null}
{
    "users":
    [
        { "xuid":"12345" },
        { "xuid":"23456" }
    ]
}

```

<a id="ID4EDAAC" />

## 另請參閱

<a id="ID4EFAAC" />

##### 上層

[/users/{ownerId}/people/avoid](/zh-TW/reference/live/rest/uri/privacy/uri-privacyusersxuidpeopleavoid)


## Related topics

- [Privacy and permissions overview](/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Vue d'ensemble de la confidentialité et des autorisations](/fr/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Visão geral de privacidade e permissões](/pt-BR/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [Información general sobre privacidad y permisos](/es/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)
- [개인정보 및 권한 개요](/ko/services/xbox-services/fundamentals/identity/privacy/live-privacy-overview.md)