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

## 설명

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 매개변수

| 매개변수 | 형식 | 설명 |
| - | - | - |
| marketplaceId | string | 필수. **Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId**에서 얻은 문자열 값입니다. |

## 쿼리 문자열 매개변수

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

## 참고 항목

##### 상위 항목

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

##### 추가 정보

[EDS Common Headers](https://devdocs.xbox.com/ko/reference/live/rest/additional/edscommonheaders)

[EDS Parameters](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsparameters)

[EDS Query Refiners](https://devdocs.xbox.com/ko/reference/live/rest/additional/edsqueryrefiners)

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

[추가 참조](https://devdocs.xbox.com/ko/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)