Skip to main content

​
GET (/media//fields)

필드 토큰을 가져옵니다. 이 URI의 도메인은 eds.xboxlive.com입니다.

​
설명

Entertainment Discovery Services(EDS) API는 기본적으로 각 항목에 대해 매우 작은 최소 필드 집합을 반환합니다.
  • 미디어 항목 유형
  • 미디어 그룹
  • Id
  • Name
더 많은 정보를 얻으려면 API가 반환해야 하는 추가 데이터를 지정하는 fields 매개변수를 허용합니다. 가능한 필드가 많으므로 각 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 매개변수

​
쿼리 문자열 매개변수

| 매개변수| 형식| 설명| | --- | --- | --- | --- | --- | --- | | desired| string| 필수. 최소 집합 외에 반환되어야 하는 필드의 ’.’으로 구분된 목록입니다. 지정된 모든 필드가 각 개체에 대해 반환되는 것이 보장되지는 않으며(특정 항목에 대해 데이터가 존재하지 않을 수 있음), 여기 지정되지 않은 최소 집합 외의 필드는 반환되지 않습니다. |

​
참고 항목

상위 항목
/media//fields
추가 정보
EDS Common Headers EDS Parameters EDS Query Refiners Marketplace URIs 추가 참조
Last modified on October 19, 2026