Implementación: Canales

Esta página explica cómo utilizar la API de datos de YouTube (v3) para realizar funciones relacionadas con la recuperación y actualización de los datos del canal. Un recurso channel incluye los ID de las listas de reproducción que identifican los videos en los que se subió un video o que le gustaron. 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.

Recuperar información sobre un canal

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

Establecer la información de marca de un canal

Este ejemplo actualiza las opciones de desarrollo de la marca de un canal. El ejemplo tiene dos pasos:

  • Paso 1: recuperar las opciones de 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 puede mostrar la configuración recuperada, lo que permite al usuario modificar la configuración para que se actualice.

  • Paso 2: actualizar las opciones de marca del canal

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

    • Establece la propiedad id con el ID único del canal de YouTube. 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 se muestra a continuación crea un recurso channel con la siguiente configuración de 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 API, debes establecer el valor de la propiedad id en el ID del canal del usuario autenticado. También debes establecer las propiedades de la imagen para que coincidan con tu configuración actual.

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

Administrar 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 aparecen en un canal. Por ejemplo, una sección puede incluir los videos subidos más recientes de un canal, los videos más populares subidos o los videos de una o más listas de reproducción.

En el siguiente ejemplo, se recuperan las secciones del canal para el 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 en true. Ese parámetro indica que estás recuperando secciones del canal para el canal del usuario autenticado actualmente.

Subir y configurar 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. La imagen se muestra durante las reproducciones de los videos del canal especificado. También puedes especificar un canal de destino al cual vinculará la imagen, así como los detalles del tiempo que determinan cuándo aparece la marca de agua y por cuánto tiempo es visible.

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

Lamentablemente, esta consulta no se puede probar con el Explorador de API, ya que este no admite la capacidad de subir archivos multimedia, lo cual es un requisito para este método.