ChannelSections

Un recurso channelSection contiene información sobre un conjunto de videos que un canal eligió destacar. Por ejemplo, una sección puede mostrar el nombre las cargas más recientes, los videos más populares o los videos de una o varias playlists.

Los canales pueden crear un máximo de 10 bibliotecas.

Métodos

La API admite los siguientes métodos para los recursos channelSections:

list
Muestra una lista de recursos channelSection que coinciden con los criterios de solicitud a la API. Pruébalo ahora.
insertar
Agrega una sección de canal al canal del usuario autenticado. Los canales pueden crear un máximo de 10 bibliotecas. Pruébala ahora.
actualización
Actualiza una sección de un canal. Pruébala ahora.
borrar
Borra una sección de un canal. Pruébala ahora.

Representación de recursos

La siguiente estructura JSON muestra el formato de un recurso channelSections:

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

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Identifica el tipo de recurso de la API. El valor será youtube#channelSection.
etag etag
Etag de este recurso.
id string
ID que YouTube utiliza para identificar de forma exclusiva la sección del canal.
snippet object
El objeto snippet contiene información básica sobre la sección del canal, como su tipo y título.
snippet.type string
El tipo de sección del canal.

Los valores válidos para esta propiedad son los siguientes:
  • allPlaylists
  • completedEvents
  • liveEvents
  • multipleChannels
  • multiplePlaylists
  • popularUploads
  • recentUploads
  • singlePlaylist
  • subscriptions
  • upcomingEvents
snippet.channelId string
ID que YouTube utiliza para identificar de forma exclusiva el canal que publicó la sección del canal.
snippet.title string
Título de la sección. Solo puedes establecer el título de una sección del canal que tenga un valor snippet.type de multiplePlaylists o multipleChannels y, de hecho, debes especificar un título cuando insertes o actualices cualquiera de esos tipos de secciones. Si especificas un título para otros tipos de secciones del canal, se ignorará el valor.

El valor de esta propiedad tiene una longitud máxima de 100 caracteres y puede contener todos los caracteres UTF-8 válidos, excepto < y <.
snippet.position unsigned integer
La posición de la sección en el canal de usuario. Esta propiedad usa un índice con base 0. Un valor de 0 identifica la primera sección que aparece en el canal, un valor de 1 identifica la segunda sección, y así sucesivamente.

Si no especificas un valor para esta propiedad cuando insertas una sección de canal, el comportamiento predeterminado es mostrar la sección nueva al final.
contentDetails object
El objeto contentDetails contiene detalles sobre el contenido de la sección del canal, como una lista de playlists o canales que aparecen en la sección.
contentDetails.playlists[] list
Es una lista de uno o más ID de playlists que aparecen en una sección del canal. Debes especificar una lista de ID de playlists si la propiedad snippet.type del recurso channelSection es singlePlaylist o multiplePlaylists, y no debe especificarse para otros tipos de secciones. Si el tipo es singlePlaylist, esta lista debe especificar exactamente un ID de playlist.
contentDetails.channels[] list
Es una lista de uno o más IDs de canales que se muestran en una sección de canal. Debes especificar una lista de IDs de canal si la propiedad snippet.type del recurso channelSection es multipleChannels, y esta propiedad no debe especificarse para otros tipos de secciones. No puedes incluir tu propio canal en la lista.