Channels

La API ahora admite la capacidad de marcar tu canal o tus videos como “creados para niños”. Además, los recursos channel y video ahora también contienen una propiedad que identifica el estado de "creado para niños" de ese canal o video. Las Condiciones del Servicio de los Servicios de APIs de YouTube y las Políticas para Desarrolladores también se actualizaron el 10 de enero de 2020. Para obtener más información, consulta los historiales de revisión del Servicio de la API de YouTube Data y las Condiciones del Servicio de las APIs de YouTube.

Un recurso channel contiene información sobre un canal de YouTube.

Métodos

La API admite los siguientes métodos para los recursos channels:

list
Devuelve una colección de cero o más recursos channel que coinciden con los criterios de la solicitud. Pruébalo ahora.
update
Actualiza los metadatos de un canal. Ten en cuenta que, por el momento, este método solo admite actualizaciones de los objetos brandingSettings y invideoPromotion del recurso channel y sus propiedades secundarias. Pruébalo ahora.

Representación de recursos

En la siguiente estructura JSON, se muestra el formato de un recurso channels:

{
  "kind": "youtube#channel",
  "etag": etag,
  "id": string,
  "snippet": {
    "title": string,
    "description": string,
    "customUrl": string,
    "publishedAt": datetime,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "country": string
  },
  "contentDetails": {
    "relatedPlaylists": {
      "likes": string,
      "favorites": string,
      "uploads": string
    }
  },
  "statistics": {
    "viewCount": unsigned long,
    "subscriberCount": unsigned long,  // this value is rounded to three significant figures
    "hiddenSubscriberCount": boolean,
    "videoCount": unsigned long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "status": {
    "privacyStatus": string,
    "isLinked": boolean,
    "longUploadsStatus": string,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean
  },
  "brandingSettings": {
    "channel": {
      "title": string,
      "description": string,
      "keywords": string,
      "trackingAnalyticsAccountId": string,
      "unsubscribedTrailer": string,
      "defaultLanguage": string,
      "country": string
    },
    "watch": {
      "textColor": string,
      "backgroundColor": string,
      "featuredPlaylistId": string
    }
  },
  "auditDetails": {
    "overallGoodStanding": boolean,
    "communityGuidelinesGoodStanding": boolean,
    "copyrightStrikesGoodStanding": boolean,
    "contentIdClaimsGoodStanding": boolean
  },
  "contentOwnerDetails": {
    "contentOwner": string,
    "timeLinked": datetime
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

Propiedades

La siguiente tabla define las propiedades que aparecen en este recurso:

Propiedades
kind string
Identifica el tipo de recurso de la API. El valor será youtube#channel.
etag etag
La Etag de este recurso.
id string
Es el ID que YouTube usa para identificar el canal de forma inequívoca.
snippet object
El objeto snippet contiene detalles básicos sobre el canal, como su título, descripción y las imágenes en miniatura.
snippet.title string
Es el título del canal.
snippet.description string
Es la descripción del canal. La longitud máxima del valor de la propiedad es de 1,000 caracteres.
snippet.customUrl string
Es la URL personalizada del canal. En el Centro de ayuda de YouTube, se explican los requisitos de elegibilidad para obtener una URL personalizada y cómo configurarla.
snippet.publishedAt datetime
Fecha y hora en que se creó el canal. El valor se especifica en formato ISO 8601.
snippet.thumbnails object
Es un mapa de imágenes en miniatura asociadas con el canal. Para cada objeto del mapa, la clave es el nombre de la imagen en miniatura y el valor es un objeto que contiene otra información sobre la miniatura.

Cuando muestres miniaturas en tu aplicación, asegúrate de que tu código use las URLs de las imágenes exactamente como se devuelven en las respuestas de la API. Por ejemplo, tu aplicación no debe usar el dominio http en lugar del dominio https en una URL que se muestra en una respuesta de la API.

Las URLs de las miniaturas de los canales solo están disponibles en el dominio https, que es como aparecen las URLs en las respuestas de la API. Es posible que veas imágenes dañadas en tu aplicación si intenta cargar imágenes de YouTube desde el dominio http. Es posible que las imágenes en miniatura estén vacías en los canales recién creados y que tarden hasta un día en aparecer.
snippet.thumbnails.(key) object
Los valores de clave válidos son los siguientes:
  • default: Es la imagen en miniatura predeterminada. La miniatura predeterminada de un video (o un recurso que hace referencia a un video, como un elemento de una playlist o un resultado de la búsqueda) tiene 120 px de ancho y 90 px de alto. La viñeta predeterminada para un canal es de 88 píxeles de ancho y 88 píxeles de alto.
  • medium: Es una versión de mayor resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 320 píxeles de ancho y 180 píxeles de alto. Para un canal, esta imagen es de 240 píxeles de ancho y 240 píxeles de alto.
  • high: Es una versión en alta resolución de la imagen en miniatura. Para un video (o un recurso que hace referencia a un video), esta imagen es de 480 píxeles de ancho y 360 píxeles de alto. Para un canal, esta imagen es de 800 píxeles de ancho y 800 píxeles de alto.
snippet.thumbnails.(key).url string
Es la URL de la imagen. Para obtener más lineamientos sobre el uso de URLs de miniaturas en tu aplicación, consulta la definición de la propiedad snippet.thumbnails.
snippet.thumbnails.(key).width unsigned integer
Ancho de la imagen.
snippet.thumbnails.(key).height unsigned integer
Es la altura de la imagen.
snippet.defaultLanguage string
Idioma del texto en las propiedades snippet.title y snippet.description del recurso channel.
snippet.localized object
El objeto snippet.localized contiene un título y una descripción localizados para el canal, o bien contiene el título y la descripción del canal en el idioma predeterminado para los metadatos del canal.
  • El texto localizado se devuelve en el fragmento del recurso si la solicitud channels.list usó el parámetro hl para especificar un idioma para el que se debe devolver el texto localizado, el valor del parámetro hl identifica un idioma de la aplicación de YouTube y el texto localizado está disponible en ese idioma.
  • Los metadatos del idioma predeterminado se muestran si no se especifica un valor del parámetro hl o si se especifica un valor, pero no hay metadatos localizados disponibles para el idioma especificado.
La propiedad contiene un valor de solo lectura. Usa el objeto localizations para agregar, actualizar o borrar metadatos localizados.
snippet.localized.title string
Es el título del canal localizado.
snippet.localized.description string
Es la descripción localizada del canal.
snippet.country string
Es el país con el que se asocia el canal. Para establecer el valor de esta propiedad, actualiza el valor de la propiedad brandingSettings.channel.country.
contentDetails object
El objeto contentDetails encapsula información sobre el contenido del canal.
contentDetails.relatedPlaylists object
El objeto relatedPlaylists es un mapa que identifica las playlists asociadas con el canal, como los videos subidos o los videos que le gustan al canal. Puedes recuperar cualquiera de estas playlists con el método playlists.list.
contentDetails.relatedPlaylists.likes string
Es el ID de la playlist que contiene los videos que le gustaron al canal. Usa los métodos playlistItems.insert y playlistItems.delete para agregar o quitar elementos de esa lista.
contentDetails.relatedPlaylists.favorites string
Esta propiedad dejó de estar disponible.

Es el ID de la playlist que contiene los videos favoritos del canal. Usa los métodos playlistItems.insert y playlistItems.delete para agregar o quitar elementos de esa lista.

Ten en cuenta que YouTube dejó de usar la función de videos favoritos. Por ejemplo, la propiedad statistics.favoriteCount del recurso video quedó obsoleta el 28 de agosto de 2015. Como resultado, por motivos históricos, es posible que este valor de propiedad contenga un ID de la playlist que haga referencia a una playlist vacía y, por lo tanto, no se pueda recuperar.
contentDetails.relatedPlaylists.uploads string
Es el ID de la lista de reproducción que contiene los videos subidos del canal. Usa el método videos.insert para subir videos nuevos y el método videos.delete para borrar los videos subidos anteriormente.
statistics object
El objeto statistics encapsula las estadísticas del canal.
statistics.viewCount unsigned long

Es la suma de la cantidad de veces que se vieron todos los videos en todos los formatos de un canal.

A partir del 24 de agosto de 2026, para todos los formatos de video (formato largo, transmisiones en vivo y Shorts) de un canal, se actualizará viewCount para que las vistas se registren en cuanto se empiece a reproducir un video (incluye la reproducción automática, mantener el puntero sobre el video y hacer clic o presionar para reproducir).
statistics.commentCount unsigned long
Esta propiedad dejó de estar disponible.

Es la cantidad de comentarios del canal.
statistics.subscriberCount unsigned long
Es la cantidad de suscriptores que tiene el canal. Este valor se redondea hacia abajo a tres cifras significativas. Para obtener más detalles sobre cómo se redondean los recuentos de suscriptores, consulta el Historial de revisiones o el Centro de ayuda de YouTube.
statistics.hiddenSubscriberCount boolean
Indica si el recuento de suscriptores del canal es visible públicamente.
statistics.videoCount unsigned long
Es la cantidad de videos públicos que se subieron al canal. Ten en cuenta que el valor refleja el recuento de los videos públicos del canal únicamente, incluso para los propietarios. Este comportamiento es coherente con los recuentos que se muestran en el sitio web de YouTube.
topicDetails object
El objeto topicDetails encapsula información sobre los temas asociados con el canal.

Importante: Para obtener más detalles sobre los cambios relacionados con los IDs de temas, consulta la definición de la propiedad topicDetails.topicIds[] y el historial de revisiones.
topicDetails.topicIds[] list
Es una lista de IDs de temas asociados con el canal.

Esta propiedad dejó de estar disponible el 10 de noviembre de 2016. Se admitirá hasta el 10 de noviembre de 2017.

Importante: Debido a la baja de Freebase y la API de Freebase, los IDs de tema comenzaron a funcionar de manera diferente a partir del 27 de febrero de 2017. En ese momento, YouTube comenzó a mostrar un pequeño conjunto de IDs de temas seleccionados.
topicDetails.topicCategories[] list
Es una lista de URLs de Wikipedia que describen el contenido del canal.
status object
El objeto status encapsula información sobre el estado de privacidad del canal.
status.privacyStatus string
Es el estado de privacidad del canal.

Los valores válidos para esta propiedad son los siguientes:
  • private
  • public
  • unlisted
status.isLinked boolean
Indica si los datos del canal identifican a un usuario que ya está vinculado a un nombre de usuario de YouTube o a una cuenta de Google+. Un usuario que tenga uno de estos vínculos ya cuenta con una identidad pública de YouTube, que es un requisito para varias acciones, como subir videos.
status.longUploadsStatus string
Indica si el canal es apto para subir videos de más de 15 minutos. Esta propiedad solo se devuelve si el propietario del canal autorizó la solicitud a la API. Para obtener más información sobre esta función, consulta el Centro de ayuda de YouTube.

Los valores válidos para esta propiedad son los siguientes:
  • allowed: Este canal puede subir videos de más de 15 minutos.
  • disallowed: Este canal no puede subir videos de más de 15 minutos. Un canal solo es apto para subir videos de formato largo si se encuentra en regla según los Lineamientos de la Comunidad de YouTube y no tiene bloqueos de Content ID en todo el mundo para su contenido.

    Después de que el propietario del canal resuelva los problemas que impiden que el canal suba videos más largos, el canal volverá al estado allowed o eligible.
  • eligible: Este canal cumple con los requisitos para subir videos de más de 15 minutos. Sin embargo, el propietario del canal primero debe habilitar la opción para subir videos más largos a través de la verificación telefónica. Para obtener más detalles sobre esta función, consulta el Centro de ayuda de YouTube.
status.madeForKids boolean
Este valor indica si el canal está designado como apto para niños y contiene el estado actual de “creado para niños” del canal. Por ejemplo, el estado se puede determinar en función del valor de la propiedad selfDeclaredMadeForKids. Para obtener más información sobre cómo configurar el público de tu canal, tus videos o tus transmisiones, consulta el Centro de ayuda de YouTube .
status.selfDeclaredMadeForKids boolean
En una solicitud de channels.update, esta propiedad permite que el propietario del canal designe el canal como dirigido a niños. El valor de la propiedad solo se devuelve si el propietario del canal autorizó la solicitud a la API.
brandingSettings object
El objeto brandingSettings encapsula información sobre el desarrollo de la marca del canal.
brandingSettings.channel object
El objeto channel encapsula las propiedades de desarrollo de la marca de la página del canal.
brandingSettings.channel.title string
Es el título del canal. El título tiene una longitud máxima de 30 caracteres.
brandingSettings.channel.description string
La descripción del canal, que aparece en el cuadro de información del canal en tu canal de usuario. La longitud máxima del valor de la propiedad es de 1,000 caracteres.
brandingSettings.channel.keywords string
Son las palabras clave asociadas a tu canal. El valor es una lista de cadenas separadas por espacios. Es posible que las palabras clave del canal se trunquen si superan la longitud máxima permitida de 500 caracteres o si contienen comillas sin escape ("). Ten en cuenta que el límite de 500 caracteres no es por palabra clave, sino que es un límite para la longitud total de todas las palabras clave.
brandingSettings.channel.trackingAnalyticsAccountId string
Es el ID de una cuenta de Google Analytics que deseas usar para hacer un seguimiento del tráfico a tu canal y medirlo.
brandingSettings.channel.unsubscribedTrailer string
Es el video que se debe reproducir en el módulo de video destacado en la vista de exploración del canal de usuario para los usuarios que no se suscribieron. Los usuarios suscritos pueden ver un video diferente que destaque la actividad más reciente del canal.

Si se especifica, el valor de la propiedad debe ser el ID de video de YouTube de un video público o no listado que sea propiedad del propietario del canal.
brandingSettings.channel.defaultLanguage string
Idioma del texto en las propiedades snippet.title y snippet.description del recurso channel.
brandingSettings.channel.country string
Es el país con el que se asocia el canal. Actualiza esta propiedad para establecer el valor de la propiedad snippet.country.
brandingSettings.watch object
Nota: Este objeto y todas sus propiedades secundarias dejaron de estar disponibles.

El objeto watch encapsula las propiedades de desarrollo de la marca de las páginas de reproducción de los videos del canal.
brandingSettings.watch.textColor string
Nota: Esta propiedad dejó de estar disponible.

Es el color del texto del área de desarrollo de la marca de la página de reproducción del video.
brandingSettings.watch.backgroundColor string
Nota: Esta propiedad dejó de estar disponible.

Es el color de fondo del área de desarrollo de la marca de la página de reproducción del video.
brandingSettings.watch.featuredPlaylistId string
Nota: Esta propiedad dejó de estar disponible. La API devuelve un error si intentas establecer su valor.
brandingSettings.image object
Esta propiedad y todas sus propiedades secundarias dejaron de estar disponibles.

El objeto image encapsula información sobre las imágenes que se muestran en el canal de usuario o en las páginas de reproducción de videos.
brandingSettings.image.bannerImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de la imagen del banner que se muestra en el canal de usuario del sitio web de YouTube. La imagen es de 1060 píxeles por 175 píxeles.
brandingSettings.image.bannerMobileImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de la imagen del banner que se muestra en la página del canal en las aplicaciones para dispositivos móviles. La imagen es de 640 píxeles por 175 píxeles.
brandingSettings.image.watchIconImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de la imagen que aparece sobre el reproductor de video. Esta es una imagen de 25 píxeles de altura con un ancho flexible que no puede exceder los 170 píxeles. Si no proporcionas esta imagen, aparecerá el nombre del canal en lugar de una imagen.
brandingSettings.image.trackingImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de un píxel de seguimiento de 1 px por 1 px que se puede usar para recopilar estadísticas de las vistas de las páginas de canales o videos.
brandingSettings.image.bannerTabletLowImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de baja resolución que se muestra en la página del canal en las aplicaciones para tablets. El tamaño máximo de la imagen es de 1,138 px por 188 px.
brandingSettings.image.bannerTabletImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen del banner que se muestra en el canal de usuario en las aplicaciones para tablets. La imagen es de 1707 píxeles por 283 píxeles.
brandingSettings.image.bannerTabletHdImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de alta resolución que se muestra en la página del canal en las aplicaciones para tablets. El tamaño máximo de la imagen es de 2,276 px × 377 px.
brandingSettings.image.bannerTabletExtraHdImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de resolución extraalta que se muestra en la página del canal en las aplicaciones para tablets. El tamaño máximo de la imagen es de 2,560 px por 424 px.
brandingSettings.image.bannerMobileLowImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen del banner de baja resolución que se muestra en el canal de usuario en las aplicaciones para dispositivos móviles. El tamaño máximo de la imagen es de 320 px por 88 px.
brandingSettings.image.bannerMobileMediumHdImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen del banner de resolución media que se muestra en el canal de usuario en las aplicaciones para dispositivos móviles. El tamaño máximo de la imagen es de 960 px por 263 px.
brandingSettings.image.bannerMobileHdImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de alta resolución que se muestra en la página del canal en las aplicaciones para dispositivos móviles. El tamaño máximo de la imagen es de 1,280 px por 360 px.
brandingSettings.image.bannerMobileExtraHdImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de muy alta resolución que se muestra en la página del canal en las aplicaciones para dispositivos móviles. El tamaño máximo de la imagen es de 1,440 px por 395 px.
brandingSettings.image.bannerTvImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de resolución extra alta que se muestra en la página del canal en las aplicaciones para televisores. El tamaño máximo de la imagen es de 2120 px por 1192 px.
brandingSettings.image.bannerTvLowImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen del banner de baja resolución que se muestra en la página del canal en las aplicaciones para televisión. El tamaño máximo de la imagen es de 854 px por 480 px.
brandingSettings.image.bannerTvMediumImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen de banner de resolución media que se muestra en la página del canal en las aplicaciones para televisión. El tamaño máximo de la imagen es de 1280 px × 720 px.
brandingSettings.image.bannerTvHighImageUrl string
Esta propiedad dejó de estar disponible.

Es la URL de una imagen del banner de alta resolución que se muestra en la página del canal en las aplicaciones para televisión. El tamaño máximo de la imagen es de 1920 px por 1080 px.
brandingSettings.image.bannerExternalUrl string
Esta propiedad especifica la ubicación de la imagen del banner que YouTube usa para generar los distintos tamaños de imagen del banner de un canal.
brandingSettings.hints[] list
Esta propiedad y todas sus propiedades secundarias dejaron de estar disponibles.

El objeto hints encapsula propiedades de desarrollo de la marca adicionales.
brandingSettings.hints[].property string
Esta propiedad dejó de estar disponible.

Una propiedad.
brandingSettings.hints[].value string
Esta propiedad dejó de estar disponible.

Valor de la propiedad.
auditDetails object
El objeto auditDetails encapsula los datos del canal que una red multicanal (MCN) evaluaría para determinar si acepta o rechaza un canal en particular. Ten en cuenta que cualquier solicitud a la API que recupere esta parte del recurso debe proporcionar un token de autorización que contenga el permiso https://www.googleapis.com/auth/youtubepartner-channel-audit. Además, cualquier token que use ese permiso se debe revocar cuando la MCN decida aceptar o rechazar el canal, o bien en un plazo de dos semanas a partir de la fecha en que se emitió el token.
auditDetails.overallGoodStanding boolean
Este campo indica si hay algún problema con el canal. Actualmente, este campo representa el resultado de la operación lógica AND en las propiedades communityGuidelinesGoodStanding, copyrightStrikesGoodStanding y contentIdClaimsGoodStanding, lo que significa que esta propiedad tiene un valor de true si todas esas otras propiedades también tienen un valor de true. Sin embargo, esta propiedad tendrá un valor de false si alguna de esas propiedades tiene un valor de false. Sin embargo, ten en cuenta que la metodología que se usa para establecer el valor de esta propiedad está sujeta a cambios.
auditDetails.communityGuidelinesGoodStanding boolean
Indica si el canal respeta los Lineamientos de la Comunidad de YouTube.
auditDetails.copyrightStrikesGoodStanding boolean
Indica si el canal tiene faltas por infracción de derechos de autor.
auditDetails.contentIdClaimsGoodStanding boolean
Indica si el canal tiene reclamos sin resolver.
contentOwnerDetails object
El objeto contentOwnerDetails encapsula los datos del canal que solo son visibles para el socio de YouTube que vinculó el canal a su Administrador de contenido.
contentOwnerDetails.contentOwner string
Es el ID del propietario del contenido vinculado al canal.
contentOwnerDetails.timeLinked datetime
Fecha y hora en que se vinculó el canal al propietario del contenido. El valor se especifica en formato ISO 8601.
localizations object
El objeto localizations encapsula las traducciones de los metadatos del canal.
localizations.(key) object
Es el idioma de los metadatos localizados asociados con el valor de la clave. El valor es una cadena que contiene un código de idioma BCP-47.
localizations.(key).title string
Es el título del canal localizado.
localizations.(key).description string
Es la descripción localizada del canal.