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:
|
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. |