> ## 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.

# 從服務取得已刪除帳戶清單

> 使用 XSTS 權杖和 deletedaccounts.xboxlive.com REST 端點擷取 XBOX Live 已刪除帳戶清單，以符合 GDPR 規範。

此方法提供已依照一般資料保護規範 (GDPR) 要求移除其 XBOX 服務帳戶和資料之使用者的 userId 清單。
如需有關 GDPR 規範的其他問題，請洽詢貴組織的法規遵循小組。

您也可以透過 Partner Center 入口網站手動擷取已刪除帳戶清單。

不應持續呼叫此 API。發行者每天最多只應使用幾次。
如果呼叫服務的頻率過高，它會傳回 HTTP 429 (Too many requests)，並附上何時可以進行下一次呼叫的資訊。

## 要求

### 必要條件

若要使用此方法，您需要使用信賴憑證者 `https://xboxlive.com/` 的 XBOX 安全性權杖服務 (XSTS) 權杖。

如需詳細資訊，請參閱[遊戲服務對 XBOX 服務的呼叫](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/live-title-service-calls-xbox-live)。

### 要求語法

| 方法 | 要求 URI |
| - | - |
| GET | `https://deletedaccounts.xboxlive.com/ids` |

### 要求標頭

| 標頭 | 類型 | 描述 |
| - | - | - |
| Authorization | string | 必要。服務授權 XSTS 權杖。 |
| Signature | string | 必要。 |
| User-Agent | string | 選擇性，但建議使用。有助於識別您的服務以進行記錄和調查。 |
| Host | string | 必須設定為值 **deletedaccounts.xboxlive.com**。 |
| Content-Type | string | 指定要求和回應類型。目前唯一支援的值是 **application/json**。 |

### 要求 URI 參數

| 參數 | 類型 | 描述 | 必要 |
| - | - | - | - |
| StartDate | string | 指定已刪除帳戶要求之日期範圍的開始 (YYYY-MM-DDTHH:MM:SS) UTC | 否 |
| EndDate | string | 指定已刪除帳戶要求之日期範圍的結束 (YYYY-MM-DDTHH:MM:SS) UTC | 否 |

<Note>
  API 只會將您的 StartDate 和 EndDate 值限定為日期值。小時、分鐘和秒數會被忽略。
</Note>

### 要求範例

```html theme={null}
GET https://deletedaccounts.xboxlive.com/ids?StartDate=2020-02-24T00:00:00&EndDate=2020-02-25T00:00:00 HTTP/1.1
Authorization: XBL3.0 x=2218837447227500391;eyJlbmMiOiJ...
Signature: AAAAAQHVT...
User-Agent: {identifier string of your service}
Content-Type: application/json;
Host: deletedaccounts.xboxlive.com
```

## 回應

```json theme={null}
HTTP/1.1 200 OK
Cache-Control: no-cache, no-store
Content-Length: 78296
Content-Type: application/json
X-Content-Type-Options: nosniff
MS-CV: QLHKwZlzGkqLt4smjd+qqQ.2.5.0
Date: Wed, 26 Feb 2020 00:23:34 GMT

[
    {
        "publisher": {
            "Id": "4dcc8ca0-72cc-4cfb-888c-cfddda8d2ebe",
            "Name": ""
        },
        "Ids": [
            "89E3C2A11A16CB93BD99D756377EA750DD493D95",
            "EB1F2FCEDC0B166084D5111810BA2F1156B416CE",
            ...
            "0ACFB1A45A7E0F49EF96729F036ECF555C0A4D75",
            "7187F79C48F1B6CB9FBA8C764B379C6ADB60D182"
        ]
    }
]
```

### 回應本文

| 參數 | 類型 | 描述 | 必要 |
| - | - | - | - |
| Publisher | PublisherInformation | 與要求授權相關聯之發行者的識別資訊。請參閱下方的 PublisherInformation 物件表格 | 是 |
| Ids | list\<string> | 已要求移除其帳戶和資料之 userId 的陣列。這些識別碼的預設格式是帳戶對於呼叫發行者的 PXUID。如果發行者獲授權在其服務中存取和使用 XUID，則識別碼將以使用者的 XUID 傳回。 | 是 |

`PublisherInformation` 物件包含下列參數。

| 參數 | 類型 | 描述 | 必要 |
| - | - | - | - |
| Id | string | 與用於驗證之商務合作夥伴憑證相符的 PublisherId。您可以在商務合作夥伴憑證之 "Issued to:" 欄位的開頭找到此值 | 是 |
| Name | string | 發行者的字串名稱。通常是空白的。 | 否 |

#### HTTP 錯誤碼

| 代碼 | 錯誤 | 內部錯誤碼 | 描述 |
| - | - | - | - |
| 401 | Unauthorized | Expired Token | XSTS 權杖已到期，需要新的權杖才能完成呼叫。 |
| 403 | Unauthorized | Invalid Token | 使用的權杖未獲授權向此端點進行驗證。權杖可能用於錯誤的沙箱或信賴憑證者。 |
| 429 | Throttled | Too frequent calls | 在指定的呼叫限制內，針對該使用者呼叫服務的次數過多。請參閱回應，以了解您的服務何時可以再次針對此使用者呼叫服務。 |

## 另請參閱

[XBOX 服務 RESTful 參考](/zh-TW/reference/live/rest/atoc-xboxlivews-reference)

[遊戲服務對 XBOX 服務的呼叫](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/live-title-service-calls-xbox-live)


## Related topics

- [遊戲服務對 XBOX 服務的呼叫](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/live-title-service-calls-xbox-live.md)
- [S2S 呼叫模式](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/s2s-call-patterns/index.md)
- [服務對服務呼叫模式](/zh-TW/services/xbox-services/fundamentals/s2s-auth-calls/s2s-calls/s2s-call-patterns/live-s2s-call-patterns-nav.md)
- [市集整合 - Google](/zh-TW/services/playfab/economy-monetization/economy-v2/marketplace/marketplace-integrations/google.md)
- [PlayFab GDPR - 刪除玩家資料](/zh-TW/services/playfab/data-analytics/privacy-compliance/gdpr-deleting-player-data.md)