Implementación: Canales

En esta página, se explica cómo usar la API de YouTube Data (v3) para realizar funciones relacionadas con la recuperación y actualización de datos de canales. Un recurso channel incluye los IDs de las playlists que identifican los videos subidos y a los que se les dio Me gusta en un canal. Para recuperar esta información cuando llames al método channels.list, asegúrate de que el valor del parámetro part incluya la parte del recurso contentDetails.

Cómo recuperar información sobre un canal

Llama al método channels.list para recuperar información sobre un canal en particular. Existen varias formas de identificar el canal:

Cómo establecer la información de desarrollo de la marca de un canal

En este ejemplo, se actualizan las opciones de desarrollo de la marca de un canal. El ejemplo tiene dos pasos:

  • Paso 1: Recupera las opciones de desarrollo de la marca del canal

    Llama al método channels.list y establece el valor del parámetro part en brandingSettings y el valor del parámetro mine en true.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true

    Tu aplicación podría mostrar la configuración recuperada, lo que le permite al usuario modificarla para actualizarla.

  • Paso 2: Actualiza las opciones de desarrollo de la marca del canal

    Llama al método channels.list y establece los siguientes valores:

    • Establece la propiedad id en el ID de canal de YouTube único del canal. El ID se puede extraer de la respuesta de la API en el paso 1.
    • Establece el valor del parámetro part en brandingSettings.

    El vínculo al Explorador de API que aparece a continuación crea un recurso channel con la siguiente configuración de desarrollo de la marca:

    {
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}

    Para completar la solicitud en el Explorador de APIs, debes establecer el valor de la propiedad id en el ID del canal del usuario autenticado. También debes configurar las propiedades de la imagen para que coincidan con la configuración actual.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings

Administra las secciones del canal

La API admite los métodos channelSections.list, channelSections.insert, channelSections.update y channelSections.delete para administrar las secciones del canal. Una sección del canal es un conjunto de videos que se muestran en un canal. Por ejemplo, una sección podría incluir las cargas más recientes o más populares de un canal, o bien videos de una o más playlists.

En el siguiente ejemplo, se recuperan las secciones del canal del canal oficial de YouTube de Google. La solicitud llama al método channelSections.list y establece el valor del parámetro channelId en UCK8sQmJBp8GCxrOtXWBpyEA, que es el ID del canal de Google. 

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

Esta solicitud requiere autorización si, en lugar de usar el parámetro channelId, configuras el valor del parámetro mine como true. Ese parámetro indica que estás recuperando secciones del canal del usuario autenticado actualmente.

Sube y configura una imagen de marca de agua para un canal

Puedes llamar al método watermarks.set para subir una imagen de marca de agua y configurarla para un canal. Luego, la imagen se mostrará durante la reproducción de los videos del canal especificado. También puedes especificar un canal de segmentación al que se vinculará la imagen, así como los detalles de los tiempos que determinan cuándo aparece la marca de agua y durante cuánto tiempo es visible.

El método watermarks.unset borra la imagen de la marca de agua de un canal.

Lamentablemente, esta consulta no se puede probar con el Explorador de APIs porque no admite la carga de archivos multimedia, lo cual es un requisito para este método.