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:
-
Establece el valor del parámetro
mine
entrue
para recuperar la información del canal de YouTube del usuario autenticado actualmente. Tu solicitud debe estar autorizada con OAuth 2.0.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails,brandingSettings &mine=true
-
Establece el parámetro
forUsername
en un nombre de usuario de YouTube para recuperar la información del canal asociado con ese nombre de usuario. En este ejemplo, se establece el valor del parámetroforUsername
enGoogle
para recuperar la información del canal oficial de YouTube de Google.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &forUsername=Google
-
Establece el parámetro
id
en el ID del canal de YouTube que identifica de forma exclusiva el canal sobre el que deseas recuperar información. En este ejemplo, se establece el parámetroid
enUCK8sQmJBp8GCxrOtXWBpyEA
, que también identifica el canal oficial de YouTube de Google.https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list? part=snippet,contentDetails &id=UCK8sQmJBp8GCxrOtXWBpyEA
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ámetropart
enbrandingSettings
y el valor del parámetromine
entrue
.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
enbrandingSettings
.
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
- Establece la propiedad
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.