> ## Documentation Index
> Fetch the complete documentation index at: https://docs.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://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalefields.md)

##### 詳細情報

[EDS 共通ヘッダー](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edscommonheaders.md)

[EDS パラメーター](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edsparameters.md)

[EDS クエリ絞り込み条件](https://docs.xbox.com/ja-jp/reference/live/rest/additional/edsqueryrefiners.md)

[Marketplace URI](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/atoc-reference-marketplace.md)

[追加リファレンス](https://docs.xbox.com/ja-jp/reference/live/rest/additional/atoc-xboxlivews-reference-additional.md)


## Related topics

- [/media/{marketplaceId}/fields](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalefields.md)
- [GET (/media/{marketplaceId}/metadata/mediaItemTypes/{mediaItemType}/fields)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalemetadatamediaitemtypefieldsget.md)
- [GET (media/{marketplaceId}/browse)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalebrowseget.md)
- [/media/{marketplaceId}/metadata/mediaItemTypes/{mediaItemType}/fields](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalemetadatamediaitemtypefields.md)
- [GET (media/{marketplaceId}/singleMediaGroupSearch)](https://docs.xbox.com/ja-jp/reference/live/rest/uri/marketplace/uri-medialocalesinglemediagroupsearchget.md)