Skip to main content

GET (/media//fields)

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

备注

默认情况下,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 参数

查询字符串参数

另请参阅

父主题
/media//fields
更多信息
EDS 通用标头 EDS 参数 EDS 查询精简器 Marketplace URIs 其他参考
Last modified on October 19, 2026