GET (/media/{marketplaceId}/contentRating)
コンテンツ レーティング トークンを取得します。
これらの URI のドメインは eds.xboxlive.com です。
解説
子供が表示できるコンテンツに保護者による制限を適用するのは複雑な作業です。 メディア項目タイプごとに独自のレーティング システムがあるだけでなく、それらのレーティング システムが国/地域によっても異なる場合があります。 つまり、すべての項目を適切にフィルタリングするためには、さまざまな異なるデータを指定する必要があります。
すべての API 呼び出しですべてのパラメーターを指定する代わりに、この API は、他の API の combinedContentRating パラメーターに渡す値を生成し、その後も同じ情報を伝達します。 この API に渡された各パラメーターは、他の API で再利用可能な 1 つの値に結合されるので、各 API での使用および保守が容易になります。
この API によって返される正確な値は、最終的に変わる可能性がありますが、変わることは非常にまれであるため (Entertainment Discovery Services (EDS) のリリース間など)、長時間のキャッシュが可能です。 combinedContentRating パラメーターを受け入れる API は、渡された値が無効な場合には適切なエラー メッセージを表示します。そのメッセージには、呼び出し元はこの API を再度呼び出して更新後の値を取得するだけでよいことが示されます。 combinedContentRating パラメーターを受け入れる API にこのパラメーターが提供されないときは、保護者による制限に基づくコンテンツのフィルタリングは実行されません。
注:
つまり、"安全な" コンテンツだけが返されるのではなく、過激な描写が含まれる可能性があるコンテンツを含むすべてのコンテンツが返されます。
URI パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| marketplaceId | 文字列 | 必須。 Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId から取得される文字列値。 |
クエリ文字列パラメーター
| パラメーター | 型 | 説明 |
|---|---|---|
| filterExplicit | ブール値 | オプション。 露骨な音楽をフィルタリングします。 |
| filterFamilyOnlyApps | ブール値 | オプション。 家族向けとしてマークされていないアプリをフィルタリングします。 |
| filterUnrated | ブール値 | オプション。 評価されていないコンテンツを応答に含める必要があるかどうかを決定します。 |
| maxGameRating | 32 ビット符号付き整数 | オプション。 ゲームをフィルタリングします。 |
| maxMovieRating | 32 ビット符号付き整数 | オプション。 特定のレベルを超えるムービーをフィルタリングします。 |
| maxTVRating | 32 ビット符号付き整数 | オプション。 テレビをフィルタリングします。 |
関連項目
親
/media/{marketplaceId}/contentRating