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