> ## 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 (/media/{marketplaceId}/fields)

> GET (/media/{marketplaceId}/fields)

# GET (/media/{marketplaceId}/fields)

取得欄位權杖。
這些 URI 的網域是 `eds.xboxlive.com`。

* [備註](#ID4EV)
* [URI 參數](#ID4EGC)
* [查詢字串參數](#ID4ERC)

<a id="ID4EV" />

## 備註

根據預設，Entertainment Discovery Services (EDS) API 會針對每個項目傳回一組非常小的最低欄位集合：

* 媒體項目類型
* 媒體群組
* 識別碼
* 名稱

若要取得更多資訊，API 接受 **fields** 參數，以指定應傳回哪些額外資料。由於可能的欄位很多，在每個 API 呼叫中指定其完整名稱會使要求大幅膨脹。因此，您可以將名稱傳入此 API，以產生可傳遞至其他 API 的更小值。

對於任何接受此參數的 API，提供的值必須是所有指定媒體項目類型中所有欄位的超集。無法針對不同的媒體項目類型指定不同的欄位集合。不過，如果某個欄位適用於某一種媒體項目類型而不適用於另一種，則只會出現在有資料的媒體項目類型中 (例如，如果在 `GET (/media/{marketplaceId}/fields)` 呼叫中包含 "AvatarBodyType"，則只有 AvatarItems 會包含該欄位)。

此 API 傳回的值極適合快取；事實上，除了在 EDS 部署之間，這些值應該不會變更。如果需要快取，建議快取的保留時間不要超過使用者的工作階段。

除了接受實際的欄位名稱之外，此 API 也接受 "all" 作為有效值。這會產生包含每個可指定欄位的值。建議只在開發、偵錯和測試時使用 "all" 值。

或者，您可以將 `desired={list of fields separated by a '.'}` 傳送至任何接受 **fields** 權杖的 API。

您無法同時傳入 **desired** 和 **fields**。

<a id="ID4EGC" />

## URI 參數

| 參數 | 類型 | 描述 |
| - | - | - |
| marketplaceId | string | 必要。從 <b>Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId</b> 取得的字串值。 |

<a id="ID4ERC" />

## 查詢字串參數

\| 參數| 類型| 描述|
\| --- | --- | --- | --- | --- | --- |
\| desired| 字串| 必要。除了最低集合之外應傳回的欄位清單，以 '.' 分隔。不保證每個物件都會傳回所有指定的欄位 (某些項目可能根本沒有資料)，但不會傳回最低集合以外、且未在此指定的任何欄位。 |

<a id="ID4EMD" />

## 另請參閱

<a id="ID4EOD" />

##### 上層

[/media/{marketplaceId}/fields](/zh-TW/reference/live/rest/uri/marketplace/uri-medialocalefields)

<a id="ID4EYD" />

##### 進一步資訊

[EDS 通用標頭](/zh-TW/reference/live/rest/additional/edscommonheaders)

[EDS 參數](/zh-TW/reference/live/rest/additional/edsparameters)

[EDS 查詢精簡器](/zh-TW/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URI](/zh-TW/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[其他參考](/zh-TW/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Economy v2 Catalog Content Types, Tags, & Properties](/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Tipos de conteúdo, marcas e propriedades do catálogo do Economy v2](/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)