Videos: getRating

Recupera as classificações que o usuário autorizado deu a uma lista de vídeos especificados. Faça um teste agora.

Solicitação

GET https://www.googleapis.com/youtube/v3/videos/getRating

Esta solicitação requer autorização com pelo menos um dos seguintes escopos (saiba mais sobre autenticação e autorização).

Escopo
`https://www.googleapis.com/auth/youtubepartner`
`https://www.googleapis.com/auth/youtube`

A tabela a seguir lista os parâmetros que esta consulta suporta. Todos os parâmetros listados são os parâmetros de consulta.

Parâmetros
Parâmetros obrigatórios
`id`	`string` O parâmetro `id` especifica uma lista separada por vírgulas dos IDs dos vídeos do YouTube para os recursos para os quais você está recuperando dados de classificação. Em um recurso `video`, a propriedade `id` especifica o ID do vídeo.
Parâmetros opcionais
`onBehalfOfContentOwner`	`string` Este parâmetro só pode ser usado em uma solicitação autorizada adequadamente. Observação: este parâmetro é destinado exclusivamente a parceiros de conteúdo do YouTube. O parâmetro `onBehalfOfContentOwner` indica que as credenciais de autorização da solicitação identificam um usuário do CMS do YouTube que age em nome do proprietário do conteúdo especificado no valor do parâmetro. Este parâmetro destina-se a parceiros de conteúdo do YouTube que possuem e gerenciam vários canais do YouTube diferentes. Ele permite que os proprietários de conteúdo autentiquem uma vez e tenham acesso a todos os dados de seu canal e de seus vídeos sem ter que fornecer credenciais de autenticação para cada canal. A conta do CMS com a qual o usuário autentica deve estar vinculada ao proprietário do conteúdo do YouTube especificado.

Não forneça um corpo de solicitação ao chamar este método.

Se for bem sucedido, este método retorna um corpo de resposta com a seguinte estrutura:

{
  "kind": "youtube#videoGetRatingResponse",
  "etag": etag,
  "items": [
    {
      "videoId": string,
      "rating": string
    }
  ]
}

A tabela a seguir define as propriedades que aparecem neste recurso:

Propriedades
`kind`	`string` O tipo do recurso da API. O valor será `youtube#videoGetRatingResponse`.
`etag`	`etag` A Etag deste recurso.
`items[]`	`list` A lista de classificações que correspondem aos critérios de solicitação.
`items[].videoId`	`string` O ID do vídeo do YouTube.
`items[].rating`	`string` Os valores válidos para esta propriedade são: `dislike` `like` `none` `unspecified`

Use o Explorador de API para chamar este método em dados ativos e ver a solicitação e a resposta da API.