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 del canal. Un recurso channel incluye IDs de playlists que identifican los videos subidos y los videos que le gustan a un canal. Para recuperar esta información cuando llamas al método channels.list, asegúrate de que el valor del parámetro part incluya la parte del recurso contentDetails.

Recupera información sobre un canal

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

Establece 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 permite que el usuario la modifique 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 ú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 APIs 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 establecer 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 destacan en un canal. Por ejemplo, una sección podría incluir las cargas más recientes, las cargas más populares o los videos de una o más playlists.

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

Sube y establece 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 establecerla para un canal. Luego, la imagen se muestra durante las reproducciones de los videos del canal especificado. También puedes especificar un canal de destino al que se vinculará la imagen, así como detalles de sincronización que determinan cuándo aparece la marca de agua y 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 APIs porque no admite la capacidad de subir archivos multimedia, lo que es un requisito para este método.