ChannelSections

Un recurso channelSection contiene información sobre un conjunto de videos que el canal eligió destacar. Por ejemplo, una sección puede presentar los videos más recientes de un canal, los videos más populares o los videos de una o más listas de reproducción.

Un canal puede crear un máximo de 10 biblioteca.

Métodos

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

list
Muestra una lista de recursos channelSection que coinciden con los criterios de la solicitud a la API. Pruébelo ahora.
insertar
Agrega una sección al canal del usuario autenticado. Un canal puede crear un máximo de 10 bibliotecas. Pruébala ahora.
actualizar
Actualiza una sección del canal. Pruébala ahora.
borrar
Borra una sección del 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 API. El valor será youtube#channelSection.
etag etag
Es la Etag de este recurso.
id string
ID que usa YouTube para identificar de forma exclusiva la sección del canal.
snippet object
El objeto snippet contiene detalles básicos sobre la sección del canal, como el tipo y el 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 usa YouTube para identificar de forma exclusiva el canal que publicó la sección de canales.
snippet.title string
Título de la sección. Solo puedes establecer el título de una sección de 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 de 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
Posición de la sección en el canal de usuario. Esta propiedad usa un índice basado en 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 del canal, el comportamiento predeterminado es mostrar la nueva sección al final.
contentDetails object
El objeto contentDetails contiene detalles sobre el contenido de la sección del canal, como una lista de las listas de reproducción o los canales que aparecen en la sección.
contentDetails.playlists[] list
Lista de uno o más ID de listas de reproducción que se muestran en la sección de un canal. Debes especificar una lista de ID de listas de reproducción si la propiedad snippet.type del recurso channelSection es singlePlaylist o multiplePlaylists, y esta propiedad no se debe especificar para otros tipos de secciones. Si el tipo es singlePlaylist, esta lista debe especificar exactamente un ID de lista de reproducción.
contentDetails.channels[] list
Lista con uno o más ID de canales destacados en una sección de canal. Debes especificar una lista de ID de canales si la propiedad snippet.type del recurso channelSection es multipleChannels, y esta propiedad no se debe especificar para otros tipos de secciones. No puedes incluir tu propio canal en la lista.