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

获取 fields 令牌。
这些 URI 的域为 `eds.xboxlive.com`。

* [备注](#ID4EV)
* [URI 参数](#ID4EGC)
* [查询字符串参数](#ID4ERC)

## 备注

默认情况下,Entertainment Discovery Services (EDS) API 为每个项返回非常小的最小字段集:

* 媒体项类型
* 媒体组
* Id
* Name

若要获取更多信息,这些 API 接受一个 **fields** 参数,用于指定应返回哪些其他数据。由于可能的字段较多,为每次 API 调用都完整指定其名称会使请求变得非常臃肿。为此,可以将这些名称传入此 API,该 API 将生成一个更小的值,可将其传入其他 API。

对于接受此参数的任何 API,所提供的值必须是所有指定媒体项类型中所有字段的超集。无法为不同的媒体项类型指定不同的字段集。但是,如果某个字段适用于一种媒体项类型而不适用于另一种,那么它将仅出现在存在数据的媒体项类型中(例如,如果 `GET (/media/{marketplaceId}/fields)` 调用中包含 "AvatarBodyType",则只有 AvatarItems 会包含该字段)。

从此 API 返回的值具有高度的可缓存性——事实上,除了在 EDS 部署之间,它们不应发生变化。如果需要缓存,建议缓存时间不超过用户的会话时长。

除了接受实际字段名称之外,此 API 还接受 "all" 作为有效值。这将生成一个包含所有可以指定的字段的值。仅建议出于开发、调试和测试目的使用 "all" 值。

或者,您可以向任何接受 **fields** 令牌的 API 发送 `desired={list of fields separated by a '.'}`。

不能同时传递 **desired** 和 **fields**。

## URI 参数

| 参数 | 类型 | 说明 |
| - | - | - |
| marketplaceId | string | 必需。从 **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId** 获取的字符串值。 |

## 查询字符串参数

| 参数 | 类型 | 说明 |
| - | - | - |
| desired | string | 必需。除最小集之外应返回的字段的 '.' 分隔列表。并不保证针对每个对象都会返回指定的所有字段(某些项可能根本不存在数据),但不会返回未在此处指定且不在最小集内的任何字段。 |

## 另请参阅

##### 父主题

[/media/{marketplaceId}/fields](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/uri-medialocalefields)

##### 更多信息

[EDS 通用标头](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edscommonheaders)

[EDS 参数](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsparameters)

[EDS 查询精简器](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/edsqueryrefiners)

[Marketplace URIs](https://devdocs.xbox.com/zh-CN/reference/live/rest/uri/marketplace/atoc-reference-marketplace)

[其他参考](https://devdocs.xbox.com/zh-CN/reference/live/rest/additional/atoc-xboxlivews-reference-additional)


## Related topics

- [Economy v2 Catalog Content Types, Tags, & Properties](https://devdocs.xbox.com/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](https://devdocs.xbox.com/pt-BR/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 Catalog 콘텐츠 유형, 태그 및 속성](https://devdocs.xbox.com/ko/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 目录内容类型、标签和属性](https://devdocs.xbox.com/zh-CN/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)
- [Economy v2 カタログ コンテンツ タイプ、タグ、プロパティ](https://devdocs.xbox.com/ja-jp/services/playfab/economy-monetization/economy-v2/catalog/content-types-tags-and-properties.md)