Skip to main content

GET (/media//contentRating)

Obtém o token de classificação de conteúdo. O domínio desses URIs é eds.xboxlive.com.

Comentários

Impor controles dos pais sobre o conteúdo que as crianças podem ver é uma tarefa complicada. Não apenas cada tipo de item de mídia tem seu próprio sistema de classificação, como esses sistemas de classificação podem variar de um país/região para outro. Isso significa que há vários dados diferentes que precisam ser especificados para filtrar corretamente todos os itens. Em vez de especificar todos os parâmetros em todas as chamadas à API, esta API gera um valor para ser passado aos parâmetros combinedContentRating de outras APIs, comunicando as mesmas informações. Isso foi projetado para tornar as APIs mais fáceis de usar e manter, pois os vários parâmetros passados para esta API são condensados em um único valor reutilizável para as outras APIs. Embora os valores exatos retornados por esta API possam eventualmente mudar, eles devem mudar com pouquíssima frequência (por exemplo, entre versões do Entertainment Discovery Services (EDS)) e, portanto, podem ser armazenados em cache por longos períodos. Qualquer API que aceite um parâmetro combinedContentRating fornecerá uma mensagem de erro significativa se o valor passado for inválido, o que indica que o chamador só precisa chamar esta API novamente para obter um valor atualizado. Se uma API aceitar um parâmetro combinedContentRating, mas nenhum for fornecido, nenhuma filtragem de conteúdo ocorrerá com base nos controles dos pais.
Observação:
Isso não significa que apenas conteúdo “seguro” será retornado; significa que todo o conteúdo será retornado, incluindo conteúdo potencialmente explícito.

Parâmetros de URI

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | | marketplaceId| string| Obrigatório. Valor de cadeia de caracteres obtido de Windows.Xbox.ApplicationModel.Store.Configuration.MarketplaceId.|

Parâmetros da cadeia de consulta

| Parâmetro| Tipo| Descrição| | --- | --- | --- | --- | --- | --- | --- | | filterExplicit| Valor booliano| Opcional. Filtra músicas explícitas.| | filterFamilyOnlyApps| Valor booliano| Opcional. Filtra aplicativos não marcados como adequados para a família.| | filterUnrated| Valor booliano| Opcional. Determina se o conteúdo sem classificação deve ser incluído na resposta ou não.| | maxGameRating| Inteiro com sinal de 32 bits| Opcional. Filtra jogos.| | maxMovieRating| Inteiro com sinal de 32 bits| Opcional. Filtra filmes acima de um nível específico.| | maxTVRating| Inteiro com sinal de 32 bits| Opcional. Filtra TV.|

Confira também

Pai
/media//contentRating
Mais informações
Cabeçalhos comuns do EDS Parâmetros do EDS Refinadores de consulta do EDS URIs do Marketplace Referência adicional
Last modified on October 6, 2026