Playlists

Um recurso de playlist representa uma 'playlist' do YouTube. Uma playlist é um conjunto de vídeos que podem ser visualizados em sequência e compartilhados com outros usuários. Uma playlist pode conter até 200 vídeos e o YouTube não limita o número de playlists que cada usuário cria. Por padrão, as playlists ficam visíveis publicamente a outros usuários, mas elas podem ser públicas ou privadas.

O YouTube também usa playlists para identificar conjuntos especiais de vídeos para um canal, tais como:

vídeos enviados
vídeos favoritos
vídeos avaliados positivamente (gostei)
histórico de visualização
assistir mais tarde

Para ser mais específico, essas listas estão associadas a um canal, que é um conjunto de vídeos de uma pessoa, grupo ou empresa, playlists, e outras informações do YouTube. Você pode recuperar o IDs das playlists para cada uma dessas listas do channel resource para um determinado canal.

Em seguida, você pode usar o método playlistItems.list para recuperar qualquer uma dessas listas. Você também pode adicionar ou remover itens dessas listas chamando os métodos playlistItems.insert e playlistItems.delete.

Métodos

A API suporta os seguintes métodos para recursos playlists:

list: Retorna um conjunto de playlists que correspondem aos parâmetros da solicitação de API. Por exemplo, você pode recuperar todas as playlists que o usuário autenticado possui ou recuperar uma ou mais playlists por seus IDs únicos. Faça um teste agora.
insert: Cria uma playlist. Faça um teste agora.
update: Modifica uma playlist. Por exemplo, você pode alterar o título, a descrição ou o status de privacidade de uma playlist. Faça um teste agora.
delete: Exclui uma playlist. Faça um teste agora.

Representação de recurso

A estrutura JSON abaixo mostra o formato de um recurso playlists:

{
  "kind": "youtube#playlist",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ]
  },
  "status": {
    "privacyStatus": string
  },
  "contentDetails": {
    "itemCount": unsigned integer
  },
  "player": {
    "embedHtml": string
  }
}

Propriedades

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

Propriedades
`kind`	`string` O tipo do recurso da API. O valor será `youtube#playlist`.
`etag`	`etag` A Etag deste recurso.
`id`	`string` O ID que o YouTube usa para identificar a playlist de forma exclusiva.
`snippet`	`object` O objeto `snippet` contém detalhes básicos sobre a playlist, como seu título e sua descrição.
`snippet.publishedAt`	`datetime` A data e a hora em que a playlist foi criada. O valor é especificado no formato ISO 8601 (`YYYY-MM-DDThh:mm:ss.sZ`).
`snippet.channelId`	`string` O ID que o YouTube usa para identificar de forma exclusiva o canal que publicou a playlist.
`snippet.title`	`string` O título da playlist.
`snippet.description`	`string` A descrição da playlist.
`snippet.thumbnails`	`object` Um mapa de imagens em miniatura associadas à playlist. Para cada objeto no mapa, a chave é o nome da imagem em miniatura, e o valor é um objeto que contém outras informações sobre a miniatura.
`snippet.thumbnails.(key)`	`object` Os valores de chave válidos são: `default` – A imagem em miniatura padrão. A miniatura padrão para um vídeo ou um recurso que se refere a um vídeo, como um item da playlist ou o resultado da pesquisa, tem 120 px de largura e 90px de altura. A miniatura padrão de um canal tem 88 px de largura e 88 px de altura. `medium` – Uma versão de resolução mais alta da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 320 px de largura e 180 px de altura. Para um canal, esta imagem tem 240 px de largura e 240 px de altura. `high` – Uma versão de alta resolução da imagem em miniatura. Para um vídeo (ou um recurso que se refira a um vídeo), esta imagem tem 480 px de largura e 360 px de altura. Para um canal, esta imagem tem 800 px de largura e 800 px de altura.
`snippet.thumbnails.(key).url`	`string` O URL da imagem.
`snippet.thumbnails.(key).width`	`unsigned integer` A largura da imagem.
`snippet.thumbnails.(key).height`	`unsigned integer` A altura da imagem.
`snippet.channelTitle`	`string` O título do canal ao qual a inscrição pertence.
`snippet.tags[]`	`list` Tags de palavras-chave associadas à playlist.
`status`	`object` O objeto `status` contém informações de `status` para a playlist.
`status.privacyStatus`	`string` O status de privacidade da playlist. Os valores válidos para esta propriedade são: `private` `public` `unlisted`
`contentDetails`	`object` O objeto `contentDetails` contém informações sobre o conteúdo da playlist, incluindo seu número de vídeos.
`contentDetails.itemCount`	`unsigned integer` O número de vídeos na playlist.
`player`	`object` O objeto `player` contém informações que você usaria para reproduzir a playlist em um `player` integrado.
`player.embedHtml`	`string` Uma tag `<iframe>` que integra um player que reproduzirá a playlist.