Skip to main content

GET (/media//fields)

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

備註

根據預設,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。

URI 參數

查詢字串參數

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

另請參閱

上層
/media//fields
進一步資訊
EDS 通用標頭 EDS 參數 EDS 查詢精簡器 Marketplace URI 其他參考
Last modified on October 6, 2026