ChannelSections

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

Cada canal puede crear 10 bibliotecas como máximo.

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. Cada canal puede crear hasta 10 bibliotecas. Pruébala ahora.
actualizar
Actualiza una sección de un canal. Pruébala ahora.
borrar
Borra la sección de un canal. Pruébala ahora.

Representación de recursos

En la siguiente estructura JSON, se 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
La Etag de este recurso.
id string
El ID que YouTube utiliza para identificar de manera inequívoca 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
El ID que YouTube utiliza para identificar de forma exclusiva el canal que publicó su sección.
snippet.title string
El título de la sección. Solo puedes configurar 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
La 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 de canal, el comportamiento predeterminado es mostrar la nueva sección en último lugar.
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 ella.
contentDetails.playlists[] list
Lista de uno o más IDs de playlists que aparecen 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 playlist.
contentDetails.channels[] list
Una lista de uno o más IDs de canales que aparecen en una sección de un canal. Debes especificar una lista de IDs de canales si la propiedad snippet.type del recurso channelSection es multipleChannels y no se debe especificar para otros tipos de secciones. No puedes incluir tu propio canal en la lista.