> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GDK 商務系統概觀

> 了解 XStore API、Partner Center 和 Microsoft Store REST 服務如何為 XBOX 和 PC 商務、基礎遊戲、DLC 等搭配運作。

**XStore** API 是以 GDK 建置之 XBOX 和 PC 遊戲在 Microsoft Store 商務中的執行階段端。XStore API 搭配 Partner Center (您在此建立產品模型) 和 Microsoft Store 服務對服務 (S2S) REST API (您的後端在此查詢和授與權利)，為您提供完整的商務平台，涵蓋基礎遊戲、DLC、試用版、消耗性產品、訂閱和組合包。

本節對應 Microsoft Learn 上的主題配置，涵蓋為您的遊戲設計、整合、測試和營運商店商務所需的一切。

> [!NOTE]
>
> 在尋找 **Microsoft Store 服務對服務 REST 參考** (collections、purchase、clawback、grant、recurrences) 嗎？它位於 **API** 索引標籤下的 [Microsoft Store REST API](https://docs.xbox.com/zh-TW/reference/microsoft-store-apis/index.md)。

## 本節內容

> [card] [開始使用](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-initial-configuration.md)
>
> 概觀、產品類型、Partner Center 設定、測試、授權和疑難排解。

> [card] [基本概念](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-basic-operations.md)
>
> 基本商店作業、DLC、試用版、消耗性產品、組合包、DWOB 和更新。

> [card] [從您的服務管理](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-authenticating-service.md)
>
> 驗證服務、查詢權利、訂閱、退款和 User Store ID。

> [card] [PC 專屬考量](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-pc.md)
>
> DRM、授權權杖、不相符商店帳戶處理，以及沙箱切換。

> [card] [Microsoft Store REST API](https://docs.xbox.com/zh-TW/reference/microsoft-store-apis/index.md)
>
> v8/v9 collections、purchase、clawback、grant 和 recurrences 端點的參考。完整參考現在位於 **API** 索引標籤下的 [Microsoft Store REST API](https://docs.xbox.com/zh-TW/reference/microsoft-store-apis/index.md)。

> [card] [系列遊戲中心](https://docs.xbox.com/zh-TW/publishing/game-publishing/concepts/game-publisher-insights/game-publisher-insights-faq.md)
>
> 將多個產品歸類在單一商店系列中心之下。

## 全貌：各部分如何連結

* **Partner Center** — 您在此建立產品 (基礎遊戲、附加元件、組合包、季票、訂閱、消耗性產品)、定義定價和供應情況，並指派識別碼 (**StoreId**、**Product ID**、**BigId**、**SKU ID**)。
* **`MicrosoftGame.config`** — 隨附於您的遊戲套件中，並透過 `TitleId`、`StoreId` 和 `MSAAppId` 將執行中的可執行檔繫結至商店產品。
* **XStore 執行階段 API (`XStore*`)** — 從遊戲發出的用戶端呼叫，用於列舉產品、查詢授權和權利、顯示購買 UI，以及回報消耗性產品履行。
* **XPackage API (`XPackage*`)** — 掛接選用套件 (DLC) 並為其授權、安裝區塊，以及觀察套件狀態變更。
* **Microsoft Store S2S REST API** — 您的後端呼叫的伺服器端端點，用於權威性地查詢權利、履行消耗性產品、授與產品、查閱訂閱，以及處理退款/撤銷。
* **User Store ID (UserStoreId)** — 短期金鑰，您的遊戲透過 `XUserGetTokenAndSignatureAsync` (或 `XStoreGetUserCollectionsIdAsync` / `XStoreGetUserPurchaseIdAsync`) 取得並交給您的服務，讓服務能代表該使用者呼叫商店。

## 用戶端與服務

幾乎每個商店案例都同時有**用戶端** (XStore) 和**服務端** (S2S REST) 路徑。使用用戶端提供即時使用者體驗 (顯示購買按鈕、解除鎖定內容、回報消耗性產品花費)；當權威性很重要時則使用服務 (履行必須在遊戲重新安裝後仍保留的虛擬貨幣花費、授與促銷項目、偵測 Game Pass、處理退款)。

可靠的模式：

1. 用戶端偵測到購買或花費，並顯示即時使用者體驗。
2. 用戶端將 UserStoreId 傳送至您的服務。
3. 服務呼叫商店 S2S API 以確認權利或履行消耗性產品，並更新您的記錄資料庫。

## 後續步驟

如果您是 XStore 新手，請從 [GDK 商務系統概觀](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-overview.md)開始，然後閱讀[選擇正確的產品類型](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-choosing-product-type.md)。


## Related topics

- [GDK 商務系統概觀](https://docs.xbox.com/zh-TW/publishing/xstore-commerce/xstore-overview.md)
- [XStoreQueryGameLicenseAsync](https://docs.xbox.com/zh-TW/reference/system/xstore/functions/xstorequerygamelicenseasync.md)
- [XStoreQueryEntitledProductsAsync](https://docs.xbox.com/zh-TW/reference/system/xstore/functions/xstorequeryentitledproductsasync.md)
- [XStoreQueryAssociatedProductsAsync](https://docs.xbox.com/zh-TW/reference/system/xstore/functions/xstorequeryassociatedproductsasync.md)
- [PlayFab 使用者角色](https://docs.xbox.com/zh-TW/services/playfab/identity/dev-identity/permissions/playfab-user-roles.md)