ChannelSections

Um recurso channelSection contém informações sobre um conjunto de vídeos que um canal escolheu para destacar. Por exemplo, uma seção pode apresentar a envios mais recentes, envios mais populares ou vídeos de uma ou mais listas de reprodução.

Um canal pode criar, no máximo, 10 seções.

Métodos

A API é compatível com os seguintes métodos para recursos channelSections:

list
Retorna uma lista de recursos channelSection que correspondem aos critérios da solicitação de API. Faça um teste agora.
inserir
Adiciona uma seção de canal ao canal do usuário autenticado. Um canal pode criar no máximo 10 seções. Faça um teste agora.
update
Atualiza uma seção do canal. Faça um teste agora.
delete
Exclui uma seção do canal. Faça um teste agora.

Representação de recurso

A estrutura JSON a seguir mostra o formato de um recurso channelSections:

{
  "kind": "youtube#channelSection",
  "etag": etag,
  "id": string,
  "snippet": {
    "type": string,
    "channelId": string,
    "title": string,
    "position": unsigned integer
  },
  "contentDetails": {
    "playlists": [
      string
    ],
    "channels": [
      string
    ]
  }
}

Propriedades

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

Propriedades
kind string
Identifica o tipo de recurso da API. O valor será youtube#channelSection.
etag etag
A Etag deste recurso.
id string
O ID que o YouTube usa para identificar exclusivamente a seção do canal.
snippet object
O objeto snippet contém detalhes básicos sobre a seção do canal, como tipo e título.
snippet.type string
O tipo da seção do canal.

Os valores válidos para essa propriedade são:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
O ID que o YouTube usa para identificar de forma exclusiva o canal que publicou a seção do canal.
snippet.title string
O título da seção. Só é possível definir o título de uma seção do canal que tenha um valor snippet.type de multiplePlaylists ou multipleChannels. Na verdade, você precisa especificar um título ao inserir ou atualizar qualquer um desses tipos de seções. Se você especificar um título para outros tipos de seções de canais, o valor será ignorado.

O valor desta propriedade tem no máximo 100 caracteres e pode conter todos os caracteres UTF-8 válidos, exceto < e <.
snippet.position unsigned integer
A posição da seção na página do canal. Esta propriedade usa um índice baseado em zero. O valor 0 identifica a primeira seção que aparece no canal, o valor 1 identifica a segunda seção e assim por diante.

Se você não especificar um valor para essa propriedade ao inserir uma seção de canal, o comportamento padrão será mostrar a nova seção por último.
contentDetails object
O objeto contentDetails contém detalhes sobre o conteúdo da seção de canais, como uma lista de playlists ou canais em destaque na seção.
contentDetails.playlists[] list
Uma lista de um ou mais IDs de playlists que estão em destaque em uma seção do canal. Você precisará especificar uma lista de IDs de playlists se a propriedade snippet.type do recurso channelSection for singlePlaylist ou multiplePlaylists e essa propriedade não precisar ser especificada para outros tipos de seções. Se o tipo for singlePlaylist, essa lista precisará especificar exatamente um ID de playlist.
contentDetails.channels[] list
Uma lista de um ou mais IDs de canais que estão em destaque em uma seção do canal. Você precisará especificar uma lista de IDs de canal se a propriedade snippet.type do recurso channelSection for multipleChannels e essa propriedade não precisar ser especificada para outros tipos de seções. Não é possível incluir seu próprio canal na lista.