Historial de revisión

En esta página se enumeran los cambios (versión 3) de la API de datos de YouTube y las actualizaciones de la documentación. Suscríbete a este registro de cambios.

30 de abril de 2024

Nota: Este es un anuncio de baja.

Esta actualización incluye los siguientes cambios:

La API ya no admite la capacidad de insertar o recuperar debates de canales. Este cambio es coherente con la funcionalidad admitida en el sitio web de YouTube, que no permite publicar comentarios en canales.

13 de marzo de 2024

Nota: Este es un anuncio de baja.

Esta actualización incluye los siguientes cambios:

El parámetro sync para el captions.insert y captions.update métodos quedó obsoleto. YouTube dejará de admitir los a partir del 12 de abril de 2024.

Como resultado de este cambio, los desarrolladores deben incluir información de tiempo cuando inserten o actualizar pistas de subtítulos o la carga fallará.

12 de marzo de 2024

Esta actualización incluye los siguientes cambios:

Se actualizó la documentación del recurso captions a fin de indicar que la longitud máxima permitida para el recurso snippet.name es de 150 caracteres. La API muestra un nameTooLong si el nombre de la pista es más largo.

7 de marzo de 2024

Nota: Este es un anuncio de baja.

La propiedad del recurso channel brandingSettings.channel.moderateComments dejó de estar disponible. YouTube se detendrá compatibles con el parámetro a partir del 7 de marzo de 2024.

31 de enero de 2024

Esta actualización incluye los siguientes cambios:

El nuevo forHandle del método channels.list te permite recuperar información sobre un canal especificando su identificador de YouTube.

9 de noviembre de 2023

Todas las referencias al recurso videoId en Comments se quitaron, ya que el recurso videoId no se muestra con una llamada a la API.

12 de septiembre de 2023

Nota: Este es un anuncio de baja.

El método comments.markAsSpam ha dejado de estar disponible desde hace varios años. Este método ya no se admite en YouTube y no es que ya no son compatibles con la API.

Se agregó un aviso de baja a todos los documentos que hacen referencia al comments.markAsSpam.

22 de agosto de 2023

El método search.list ahora admite lo siguiente: videoPaidProductPlacement parámetro. Este parámetro te permite filtrar los resultados de la búsqueda para incluir solo los videos que el creador indicó que tiene una promoción pagada.

18 de agosto de 2023

La definición del recurso video liveStreamingDetails.concurrentViewers se actualizó para indicar que el recuento de usuarios simultáneos que muestra la API de datos de YouTube difieren de los recuentos de usuarios simultáneos procesados y sin spam disponibles a través de YouTube Análisis. El Centro de ayuda de YouTube proporciona más información sobre las métricas de las transmisiones en vivo.

7 de agosto de 2023

Como se anunció el 12 de junio de 2023, el Método search.list El parámetro relatedToVideoId dejó de estar disponible. Ese parámetro ya no es y las referencias al parámetro se quitaron de la documentación de la API.

28 de junio de 2023

El método thumbnails.set ahora admite el elemento uploadRateLimitExceeded, que indica que el canal subió demasiados videos. miniaturas durante las últimas 24 horas y deberías volver a intentarlo más tarde.

12 de junio de 2023

Nota: Este es un anuncio de baja.

La carpeta search.list del método El parámetro relatedToVideoId dejó de estar disponible. YouTube dejará de admitir los a partir del 7 de agosto de 2023.

Por el momento, se agregó un aviso de baja al método search.list en la documentación de Google Cloud. Este parámetro se quitará por completo de la documentación de search.list a partir del 7 de agosto de 2023.

Además, se incluye un ejemplo que muestra cómo recuperar videos relacionados de la guía de implementación de la API.

22 de agosto de 2022

Se corrigieron las anotaciones de tipos de video.statistics. campos a una cadena de una cadena larga sin firma.

5 de agosto de 2022

YouTube cambió la forma de generar los IDs de subtítulos y, como parte de ese cambio, asignar nuevos IDs de subtítulos a todas las pistas de subtítulos. Es posible que este cambio sea incompatible para las aplicaciones que almacenan Valores caption_id, aunque no afectan las aplicaciones que no almacenan caption_id valores.

Entre hoy y el 1 de diciembre de 2022, captions.list, captions.update, captions.download y y los métodos captions.delete admitir tanto el ID de la pista de subtítulos anterior como la nueva. Sin embargo, a partir del 1 de diciembre de 2022, YouTube dejará de admitir los IDs de pista de subtítulos antiguos. En ese momento, llamar a cualquiera de esos métodos de la API con un ID de pista de subtítulos antiguo generará una captionNotFound error.

Para prepararte para este cambio, deberás reemplazar por completo todos los datos de las pistas de subtítulos almacenados entre hoy y el 1 de diciembre de 2022. Esto significa que cualquier video en el que se almacene una pista de subtítulos tienes que borrar los que están almacenados actualmente y, luego, llamar captions.list para recuperar las conjunto actual de pistas de subtítulos para el video y almacenar los datos en la respuesta de la API como lo harías normalmente.

12 de julio de 2022

Se actualizaron las Condiciones del Servicio de los servicios de la API de YouTube. Por favor, consulta las Condiciones del Servicio de los servicios de la API de YouTube: revisión Historial para obtener más información.

27 de abril de 2022

Se actualizó la descripción del método videos.insert para indicar que el tamaño máximo de los archivos para los videos subidos aumentó de 128 GB a 256 GB.

8 de abril de 2022

La propiedad del método subscriptions.list myRecentSubscribers y las definiciones de los parámetros mySubscribers se actualizaron para indicar que la cantidad máxima de suscriptores que muestra la API podría ser limitada. Este cambio representa una corrección de documentación y no un cambio en el comportamiento de la API.

15 de diciembre de 2021

Tal como se anunció el 18 de noviembre de 2021, en conjunto con cambios para marcar “no me gusta” en un video recuentos privados en toda la plataforma de YouTube, el video del recurso statistics.dislikeCount la propiedad ahora es privada.

Obtén más información sobre este cambio en el blog oficial de YouTube.

18 de noviembre de 2021

Además de los cambios en haz que los recuentos de “no me gusta” de videos sean privados en toda la plataforma de YouTube, el video del recurso statistics.dislikeCount propiedad se marcará como privada a partir del 13 de diciembre de 2021. Esto significa que la propiedad solo en una respuesta de la API desde el extremo videos.list si la solicitud a la API autenticados por el propietario del video.

El extremo videos.rate no se ve afectado debido a este cambio.

Los desarrolladores que no muestran los recuentos de “no me gusta” públicamente y aún necesitan el recuento de “no me gusta” en sus El cliente de API puede enviar una solicitud para que se incluya en una lista de entidades permitidas a fin de obtener una exención. Para solicitar una exención, debe completar este formulario de solicitud.

Obtén más información sobre este cambio en el blog oficial de YouTube.

2 de julio de 2021

Nota: Este es un anuncio de baja.

El extremo commentThreads.update dejó de estar disponible y ya no es compatible. Este extremo duplicó la funcionalidad disponible a través de otros extremos de la API. En cambio, puedes llamar a comments.update

método y, si tu código requiere un recurso commentThreads, realiza una llamada secundaria al commentThreads.list.

1 de julio de 2021

Todos los desarrolladores que usen los servicios de la API de YouTube deben completar una auditoría de cumplimiento de las APIs para que se les conceda más que la asignación de cuota predeterminada de 10,000 unidades. Hasta la fecha, tanto el proceso de auditoría de cumplimiento como las solicitudes de asignación de unidades de cuota adicionales han sido llevadas a cabo por los desarrolladores que completan y envían el formulario de extensión de cuota y auditoría de los servicios de la API de YouTube.

Para aclarar estos procesos y satisfacer mejor las necesidades de los desarrolladores que usan nuestros servicios de API, agregamos tres formularios nuevos y una guía para completarlos:

• Formulario de solicitudes de desarrolladores auditadas: Los desarrolladores que ya aprobaron una auditoría de cumplimiento de la API pueden completar y enviar este formulario más breve para solicitar una extensión de cuota asignada.
• Formulario de apelación: Los desarrolladores cuyos proyectos de API no hayan aprobado una auditoría de cumplimiento (o se les haya denegado un aumento de la unidad de cuota) pueden completar y enviar este formulario.
• Formulario de cambio de control: Los desarrolladores o cualquier otra parte que opere un cliente de API en nombre de un desarrollador que experimente un cambio de control (por ejemplo, a través de una compra o venta de acciones, una fusión o alguna otra forma de transacción corporativa) asociados con un proyecto de API deben completar y enviar este formulario. Esto le permite al equipo de API de YouTube actualizar nuestros registros, auditar el cumplimiento de los casos de uso del proyecto de API nuevo y validar la asignación de cuota actual del desarrollador.

Cada formulario nuevo nos informará sobre tu uso previsto de la API de YouTube y nos permitirá brindarte una mejor asistencia.

Obtén más detalles en nuestra nueva guía sobre auditorías de cumplimiento de las APIs.

12 de mayo de 2021

Nota: Este es un anuncio de baja.

Esta actualización abarca los siguientes cambios en la API:

• El recurso channel contentDetails.relatedPlaylists.favorites quedó obsoleta. La función de videos favoritos ya no está disponible durante varios años, como se indicó en la revisión del 28 de abril de 2016 entrada del historial.

  Antes de esta actualización, la API creaba una playlist nueva si un cliente de la API intentara agregar un video a una playlist de favoritos que no existe. En el futuro, la playlist no creado en este caso y la API devolverá un error. Intentos de modificar playlists favoritas al agregar, modificar o borrar elementos ya no están disponibles por anuncios previos, pueden comenzar a mostrar errores en cualquier momento.

• El siguiente recurso channel propiedades dejaron de estar disponibles. Estas propiedades ya no son compatibles con la IU de YouTube Studio. y en YouTube. Como resultado, ya no son compatibles a través de la API.

  • brandingSettings.channel.defaultTab
  • brandingSettings.channel.featuredChannelsTitle
  • brandingSettings.channel.featuredChannelsUrls[]
  • brandingSettings.channel.profileColor
  • brandingSettings.channel.showBrowseView
  • brandingSettings.channel.showRelatedChannels

  Se quitaron todas las propiedades del channel la representación de recursos y sus definiciones se quitaron del directorio lista de propiedades. Además, los errores asociadas con estas propiedades se quitaron de la documentación específica del método.

• El siguiente recurso channelSection propiedades dejaron de estar disponibles. Estas propiedades ya no son compatibles con la IU de YouTube Studio. y en YouTube. Como resultado, ya no son compatibles a través de la API.

  • snippet.style
  • snippet.defaultLanguage
  • snippet.localized.title
  • localizations
  • localizations.(key)
  • localizations.(key).title
  • targeting
  • targeting.languages[]
  • targeting.regions[]
  • targeting.countries[]

  Junto con este cambio, el método channelSection.list El parámetro hl también tiene dejó de estar disponible porque no se admiten las funciones que admite.

  Se quitaron todas las propiedades del channelSection la representación de recursos y sus definiciones se quitaron del directorio lista de propiedades. Además, los errores asociadas con estas propiedades se quitaron de la documentación específica del método.

• Para el recurso channelSection propiedad snippet.type, los siguientes valores dejaron de estar disponibles. Estos valores ya no se admiten en YouTube canales de usuario y, por consiguiente, ya no se admiten a través de la API.

  • likedPlaylists
  • likes
  • postedPlaylists
  • postedVideos
  • recentActivity
  • recentPosts

• El recurso playlist La propiedad snippet.tags[] dejó de estar disponible. Ya no se admite esta propiedad en YouTube y, por consiguiente, ya no es compatible a través de la API.

9 de febrero de 2021

El recurso playlistItem admite dos propiedades nuevas:

• El snippet.videoOwnerChannelId propiedad identifica el ID del canal que subió el video de la playlist.
• El snippet.videoOwnerChannelTitle propiedad identifica el nombre del canal que subió el video de la playlist.

28 de enero de 2021

Esta actualización incluye los siguientes cambios:

• El elemento playlistItems.delete playlistItems.insert, playlistItems.list, playlistItems.update, playlists.delete, playlists.list y Todos los métodos playlists.update son compatibles un nuevo error playlistOperationUnsupported El error se produce cuando una solicitud intenta realizar una operación que no está permitida para una playlist en particular; Por ejemplo, un usuario no puede eliminar un video de la playlist de videos que subió o borrar la playlist en sí

  En todos los casos, este error muestra un código de respuesta HTTP 400 (solicitud incorrecta).

• La propiedad del método playlistItems.list Los errores watchHistoryNotAccessible y watchLaterNotAccessible se modificaron que se quitaron de la documentación. Si bien la visibilidad el historial de reproducciones y las listas para ver más tarde no se puede acceder a través de la API, la API no devuelve estos errores específicos.

15 de octubre de 2020

Se agregaron dos secciones nuevas a la página Políticas:

• En el nuevo Artículo III.E.4.i, se estipula información adicional sobre los datos recopilados y enviados a través del reproductor incorporado de YouTube. Tú será responsable de los datos del usuario que nos envíe a través de cualquier reproductor insertado de YouTube antes del El usuario interactuó con el reproductor para indicar la intención de reproducción. Puedes limitar los datos compartidos con YouTube antes de que un usuario interactúe con el reproductor si se establece la Reproducción automática como falsa.
• El nuevo Artículo III.E.4.j se refiere a verificar el estado del contenido creado para niños (MFK) antes de incorporarlo en tus sitios de Google Chat. Eres responsable de saber cuándo se realizarán los videos que incorporas en tu cliente de API. para niños y tratar los datos recopilados desde el reproductor incorporado según corresponda. Por lo tanto, debes verificar el estado del contenido con el Servicio de la API de datos de YouTube antes de incorporarlo en tu API Cliente a través de cualquier reproductor incorporado de YouTube

La nueva sección Cómo encontrar el estado de MadeForKids en un video se explica cómo buscar el estado de contenido creado para niños de un video con la Servicio de la API de datos de YouTube.

Junto con estos cambios, se agregó un recordatorio al Documentación de parámetros del reproductor incorporado para explicar lo siguiente: Si habilitas la Reproducción automática, se reproducirá sin que el usuario interactúe con el reproductor. reproducción La recopilación y el uso compartido de datos tendrá lugar, por lo tanto, cuando se cargue la página.

8 de octubre de 2020

Esta actualización abarca tres pequeños cambios relacionados con la Recurso channel:

• El snippet.thumbnails que identifica las imágenes en miniatura de un canal, podría estar vacío para las imágenes y es posible que demore hasta un día en propagarse.
• El statistics.videoCount propiedad refleja el recuento de videos públicos del canal solo, incluso para los propietarios. Este comportamiento sea coherente con la cantidad que se muestra en el sitio web de YouTube.
• Las palabras clave del canal, que se identifican en el brandingSettings.channel.keywords propiedad, podrían truncarse si exceden la longitud máxima permitida de 500 caracteres o si contenían comillas sin escapar ("). Ten en cuenta que el código de 500 caracteres no es un límite por palabra clave, sino un límite en la longitud total de todas las palabras clave. Este comportamiento es coherente con el del sitio web de YouTube.

9 de septiembre de 2020

Nota: Este es un anuncio de baja.

Esta actualización abarca los siguientes cambios en la API. Todos los cambios se aplicarán a partir del El 9 de septiembre de 2020, fecha de este anuncio. Con esto en mente, los desarrolladores ya no deberían confían en cualquiera de las funciones de API que se indican a continuación.

• Los siguientes recursos, métodos, parámetros y propiedades de recursos de la API dejaron de estar disponibles de inmediato y dejará de funcionar a partir de la fecha de este anuncio:
  • El siguiente recurso channel propiedades:
    • La propiedad statistics.commentCount
    • El objeto brandingSettings.image y todas sus propiedades secundarias
    • La lista brandingSettings.hints y todas sus propiedades secundarias
  • La propiedad del método channels.list Parámetro de filtro categoryId
  • El recurso guideCategories y guideCategories.list método
• Las respuestas de la API para No. del método channels.list contienen el prevPageToken si la solicitud a la API establece la Parámetro managedByMe a true. Este cambio no afecta la propiedad prevPageToken para otras solicitudes channels.list y no afecta la nextPageToken para cualquier solicitud.
• El contentDetails.relatedPlaylists.watchLater del recurso channel y contentDetails.relatedPlaylists.watchHistory se anunciaron que dejó de estar disponible el 11 de agosto de 2016. El Compatibilidad con los métodos playlistItems.insert y playlistItems.delete de estas playlists también dejaron de estar disponibles por completo y se quitaron las dos propiedades de la documentación.
• El parámetro mySubscribers del método channels.list, que se anunció que dejó de estar disponible el 30 de julio de 2013, se de la documentación. Usa el Método subscriptions.list y el parámetro mySubscribers para recuperar una lista de los suscriptores al de un usuario autenticado.
• El objeto invideoPromotion del recurso channel y todos sus elementos secundarios que se anunciaron como obsoletas el 27 de noviembre de 2017, se quitaron de la documentación.

29 de julio de 2020

Simplificamos nuestro proceso de cobro de la cuota para las solicitudes a la API mediante la eliminación de las costo asociado con el parámetro part. Con vigencia inmediata, solo cobraremos el costo base del método al que se llama. Puedes encontrar más información sobre la implementación cuota aquí.

El efecto de este cambio es que la mayoría de las llamadas a la API tendrán un costo de cuota apenas menor, mientras que algunas llamadas a la API seguirán teniendo el mismo costo. Este cambio no aumenta el costo de ninguna API llamadas. En general, el impacto probable es que tu cuota asignada, que se puede ver en el Google Cloud Console, iremos un poco más allá.

Recomendamos que todos los desarrolladores completen un auditoría de cumplimiento para sus para garantizar el acceso continuo a los servicios de la API de YouTube.

Esta entrada del historial de revisión se publicó originalmente el 20 de julio de 2020.

28 de julio de 2020

Todos los videos subidos mediante videos.insert de los proyectos de API sin verificar creados después del 28 de julio de 2020 se restringirán a modo de visualización privada. Para quitar esta restricción, cada proyecto debe realizar una auditoría para verificar el cumplimiento del Condiciones del Servicio.

Los creadores que usen un cliente de API no verificado para subir videos recibirán un correo electrónico en el que se explicará lo siguiente: su video se bloquea y marca como privado, y pueden evitar la restricción usando un o auditado.

Los proyectos de API creados antes del 28 de julio de 2020 tienen las siguientes características: no se ven afectadas actualmente por este cambio. Sin embargo, recomendamos que todos los desarrolladores completar una auditoría de cumplimiento para sus proyectos a fin de garantizar el acceso continuo a los servicios de la API de YouTube.

21 de julio de 2020

(Actualizado el 28 de julio de 2020). La actualización de la documentación a la que se hace referencia en esta revisión el historial de entrada se volvió a publicar el 28 de julio de 2020.

Ayer, publicamos una actualización de la documentación relacionada con nuestro proceso para la cuota de cargos. Sin embargo, debido a circunstancias imprevistas, el cambio de cuota aún no entró en vigencia. Como resultado, el documentación se revirtió para garantizar la precisión. Para evitar confusiones, la revisión se quitó la entrada del historial que explica el cambio y se volverá a publicar próximamente.

7 de julio de 2020

Nota: Este es un anuncio de baja.

La propiedad del método videos.insert Los parámetros autoLevels y stabilize dejaron de estar disponibles parámetros se han quitado de la documentación. Sus valores se ignoran y no afectan la se procesan los videos subidos recientemente.

15 de junio de 2020

El nuevo Cumplimiento de las normas de YouTube para desarrolladores La guía de políticas proporciona orientación y ejemplos para ayudarte a garantizar que tus clientes de APIs cumplan a partes específicas de los servicios de la API de YouTube Las Condiciones y Políticas (Condiciones del Servicio de la API).

Esta guía ofrece información sobre cómo YouTube aplica ciertos aspectos de las Condiciones del Servicio de la API, pero no reemplacen ningún documento existente. La guía aborda algunas de las preguntas más comunes que que hacen los desarrolladores durante las auditorías de cumplimiento de las APIs. Esperamos que esto simplifique ayudándote a comprender cómo interpretamos y aplicamos nuestras políticas.

4 de junio de 2020

Nota: Esta es una actualización de un anuncio de baja anterior.

La función de boletín de canal ya no está disponible. Este cambio se anunció inicialmente el 17 de abril de 2020 y entró en vigencia. Como resultado, el El método activities.insert es "no" que ya no son compatibles activities.list ya no muestra boletines de canal. Para obtener más información, consulta la Centro de ayuda de YouTube.

17 de abril de 2020

Nota: Este es un anuncio de baja.

YouTube dará de baja la función de boletín de canal. Como resultado, el Se usará el método activities.insert obsoleta, y la función activities.list método dejará de mostrar los boletines de canal. Estos cambios entrarán en vigencia en la API el después del 18 de mayo de 2020. Para obtener más información, consulta la Centro de ayuda de YouTube.

31 de marzo de 2020

Esta actualización incluye los siguientes cambios:

• Nuevos recursos y métodos

  • El nuevo recurso member representa un miembro de un canal de YouTube. Un miembro proporciona asistencia monetaria recurrente a un creador de contenido y recibe beneficios especiales. Por ejemplo, los miembros pueden chatear cuando el creador activa el modo exclusivo para miembros en el chat.

    Este recurso reemplaza a sponsor. que se documenta como parte de la API de transmisión en vivo de YouTube. El El recurso sponsor dejó de estar disponible y los clientes de API deben actualizar las llamadas a el método sponsors.list para usar members.list en su lugar.

  • El nuevo membershipsLevel “resource” identifica un nivel de precios administrado por el creador que autorizó la solicitud a la API. El membershipsLevels.list recupera una lista de todos los niveles de membresía del creador.

10 de enero de 2020

La API ahora permite identificar contenido dirigido a niños que YouTube llama “creado para niños”. Obtén más información sobre “creado para niños” contenido en el Centro de ayuda de YouTube.

Los operadores channel y Los recursos video admiten dos propiedades nuevas para Permiten que los creadores y usuarios identifiquen contenido creado para niños:

• La propiedad selfDeclaredMadeForKids permite que los creadores de contenido especifiquen si un channel o video está creado para niños.
  
  Para los canales, esta propiedad se puede configurar cuando se llama al channels.update. En el caso de los videos, esta propiedad se puede configurar cuando se llama al videos.insert o videos.update.
  
  Ten en cuenta que esta propiedad solo se incluye en las respuestas de la API que contienen channel o video si el propietario del canal autorizó la solicitud a la API.
• La propiedad madeForKids permite que cualquier usuario recupere el contenido “creado para niños” estado de un canal o video. Por ejemplo, el estado podría ser se determina según el valor de la propiedad selfDeclaredMadeForKids. Consulta la Centro de ayuda de YouTube para obtener más información información sobre cómo configurar el público de tu canal, videos o transmisiones.

También actualizamos las Condiciones del Servicio de los Servicios de la API de YouTube y las Políticas para Desarrolladores. Por favor, consulta las Condiciones del Servicio de los servicios de la API de YouTube: revisión Historial para obtener más información. Los cambios en las Condiciones del Servicio de los servicios de la API de YouTube y Las Políticas para Desarrolladores entrarán en vigencia el 10 de enero de 2020 (hora del Pacífico).

10 de septiembre de 2019

La documentación de referencia de la API se actualizó para reflejar un cambio en la forma en que los recuentos se informan en YouTube y, por consiguiente, en las respuestas de la API. Como resultado del cambio, el recuento de suscriptores que devuelve el Servicio de la API de datos de YouTube se redondea a tres cifras de recuentos de suscriptores superiores a 1,000. Este cambio afecta la channel recurso statistics.subscriberCount propiedad.

Nota: Este cambio afecta el valor de esta propiedad incluso en los casos en que un usuario envía una solicitud autorizada de datos sobre su propio canal. Los propietarios de canales aún pueden ver información el recuento de suscriptores en YouTube Studio.

Por ejemplo, si un canal tiene 123,456 suscriptores, el La propiedad statistics.subscriberCount contendrá el valor 123000. La siguiente tabla muestra ejemplos de cómo se redondean los recuentos de suscriptores en las respuestas de la API y abreviado en otras interfaces de usuario públicamente visibles de YouTube:

Ejemplo de recuento de suscriptores	API de YouTube Data	IU de YouTube visibles públicamente
1.234	1230	1,230
12,345	12300	12,300
123.456	123000	123,000
1.234.567	1230000	1.23 M
12.345.678	12300000	12.3 M
123,456,789	123000000	123 M

4 de abril de 2019

Esta actualización incluye los siguientes cambios:

• La documentación de referencia de la API se actualizó para explicar mejor los casos de uso comunes de cada método y proporcionar muestras de código dinámicas y de alta calidad a través del widget del Explorador de APIs. Consulta la documentación del método channels.list para ver un ejemplo. Ahora hay dos elementos nuevos en las páginas que describen los métodos de la API:

  • El widget del Explorador de APIs te permite seleccionar alcances de autorización, ingresar valores de parámetros y propiedades de muestra y, luego, enviar solicitudes a la API reales y ver las respuestas reales de la API. El widget también ofrece una vista de pantalla completa en la que se muestran muestras de código completas, que se actualizan de forma dinámica para usar los alcances y los valores que ingresaste.

  • En la sección Casos de uso comunes, se describen uno o más casos de uso habituales para el método que se explica en la página. Por ejemplo, puedes llamar al método channels.list para recuperar datos sobre un canal específico o sobre el canal del usuario actual.

    Puedes utilizar los vínculos de esa sección para completar el Explorador de APIs con valores de muestra para tu caso de uso o para abrir el Explorador de APIs en pantalla completa con esos valores ya completados. El objetivo de estos cambios es facilitarte la visualización de muestras de código que se aplican directamente al caso de uso que intentas implementar en tu propia aplicación.

  Actualmente, las muestras de código son compatibles con Java, JavaScript, PHP, Python y curl.

• La herramienta de muestras de código también se actualizó con una nueva IU que ofrece las mismas funciones descritas anteriormente. Con esa herramienta, puedes explorar casos de uso para diferentes métodos, cargar valores en el Explorador de APIs y abrir el Explorador de APIs en pantalla completa para obtener muestras de código en Java, JavaScript, PHP y Python.

  Junto con este cambio, se eliminaron las páginas que anteriormente enumeraban las muestras de código disponibles para Java, JavaScript, PHP y Python.

• Se actualizaron las guías de inicio rápido para Java, JavaScript, PHP y Python. En las guías revisadas, se explica cómo ejecutar una muestra con una clave de API y otra con un ID de cliente de OAuth 2.0 mediante muestras de código del Explorador de APIs.

Ten en cuenta que los cambios descritos anteriormente reemplazan una herramienta interactiva que se agregó a la documentación de la API en 2017.

9 de julio de 2018

Esta actualización incluye los siguientes cambios:

• Se actualizó la definición de la propiedad snippet.thumbnails del recurso channel para indicar que, cuando se muestran miniaturas en tu aplicación, tu código debe usar las URLs de las imágenes exactamente como se muestran 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 muestre en una respuesta de la API.

  A partir de julio de 2018, las URLs de las miniaturas del canal solo estarán disponibles en el dominio https, que es la forma en que aparecen las URLs en las respuestas de la API. Luego de ese tiempo, es posible que veas imágenes dañadas en tu aplicación si intenta cargar imágenes de YouTube desde el dominio http.

• Nota: Este es un anuncio de baja.

  La propiedad recordingDetails.location.altitude del recurso video dejó de estar disponible. No hay garantía de que los videos muestren valores para esta propiedad. Del mismo modo, incluso si las solicitudes a la API intentan establecer un valor para esa propiedad, es posible que los datos entrantes no se almacenen.

22 de junio de 2018

La Guía de implementación, antes conocida como el de implementación y migración, se actualizó para quitar las instrucciones para migrar del de la API v2 a la v3. Además, se quitaron las instrucciones para las funciones que tienen dejó de estar disponible en la API v3, como los videos favoritos.

27 de noviembre de 2017

Esta actualización incluye los siguientes cambios:

• Nota: Este es un anuncio de baja.

  YouTube quitará la compatibilidad con las funciones Video destacado y Sitio web destacado, que son compatibles con la API mediante el objeto invideoPromotion del recurso channel. Como resultado, ese objeto y todas sus propiedades secundarias dejarán de estar disponibles.

  Puedes recuperar y configurar los datos de invideoPromotion hasta el 14 de diciembre de 2017. Después de esa fecha, ocurrirá lo siguiente:

  • Los intentos de recuperar la parte invideoPromotion cuando se llama a channels.list mostrarán un invideoPromotion vacío o no mostrarán ningún dato de invideoPromotion.
  • Los intentos de actualizar los datos de invideoPromotion cuando se llama a channels.update mostrarán una respuesta correcta hasta al menos el 27 de mayo de 2018, pero se considerarán no-ops, lo que significa que no realizarán una actualización.

  Después del 27 de mayo de 2018, es posible que estas solicitudes muestren mensajes de error para indicar, por ejemplo, que invalidPromotion no es una parte válida.

16 de noviembre de 2017

Esta actualización incluye los siguientes cambios:

• La herramienta de fragmento de código interactivo ahora es compatible con muestras de código de Node.js. Las muestras también se pueden ver en la documentación de casi todos los métodos de API, como el método channels.list.

  Las muestras personalizables están diseñadas para ofrecerte un punto de partida específico de un caso de uso para una aplicación de Node.js. La funcionalidad es similar al código de la guía de inicio rápido de Node.js. Sin embargo, los ejemplos contienen algunas funciones de utilidad que no aparecen en la guía de inicio rápido:

  • La función removeEmptyParameters toma una lista de pares clave-valor correspondientes a los parámetros de solicitud a la API y quita los parámetros que no tienen valores.
  • La función createResource toma una lista de pares clave-valor correspondientes a las propiedades en un recurso de API. Luego, convierte las propiedades en un objeto JSON que se puede usar en las operaciones insert y update. En el siguiente ejemplo, se muestra un conjunto de nombres y valores de propiedades, y el objeto JSON que el código crearía para ellos:

    # Key-value pairs:
    {'id': 'ABC123',
     'snippet.title': 'Resource title',
     'snippet.description': 'Resource description',
     'status.privacyStatus': 'private'}
    
    # JSON object:
    {
     'id': 'ABC123',
     'snippet': {
       'title': 'Resource title',
       'description': 'Resource description',
     },
     'status': {
       'privacyStatus': 'private'
     }
    }

  Todas estas muestras están diseñadas para descargarse y ejecutarse de forma local. Si deseas obtener más información, consulta los requisitos previos para ejecutar muestras de código completas de forma local en las instrucciones de la herramienta de fragmento de código.

25 de octubre de 2017

Esta actualización incluye los siguientes cambios:

• Se actualizaron las muestras de código de Python en la herramienta de fragmento de código interactivo para usar las bibliotecas google-auth y google-auth-oauthlib en lugar de la biblioteca oauth2client, que dejó de estar disponible.

  Además de ese cambio, la herramienta ahora proporciona muestras de código completas para aplicaciones instaladas de Python y aplicaciones de servidor web de Python, que usan flujos de autorización ligeramente diferentes. Para ver los ejemplos completos (y este cambio), haz lo siguiente:

  1. Ve a la herramienta de fragmento de código interactivo o a la documentación de cualquier método de API, como el método channels.list.
  2. Haz clic en la pestaña Python arriba de las muestras de código.
  3. Haz clic en el botón de activación ubicado arriba de las pestañas para pasar de ver un fragmento a una muestra completa.
     
  4. La pestaña ahora debería mostrar una muestra de código completa que usa el flujo de autorización InstalledAppFlow. En la descripción anterior del ejemplo se explica esto y se incluye un vínculo a un ejemplo para una aplicación de servidor web.
  5. Haz clic en el vínculo para cambiar al ejemplo del servidor web. En esa muestra, se usa el framework de aplicación web Flask y un flujo de autorización diferente.

  Todas estas muestras están diseñadas para descargarse y ejecutarse de forma local. Si deseas ejecutar las muestras, consulta las instrucciones para ejecutar muestras de código completas de forma local en las instrucciones de la herramienta de fragmento de código.

29 de agosto de 2017

Esta actualización incluye los siguientes cambios:

• Se actualizó la definición del parámetro forContentOwner del método search.list para indicar que, si el parámetro se establece en true, el parámetro type debe establecerse en video.
• Se actualizó la definición del parámetro regionCode del método search.list para aclarar que el parámetro restringe los resultados de la búsqueda a los videos que se pueden ver en la región especificada.
• YouTube actualizó los íconos y logotipos de desarrollo de la marca. Nuevo "desarrollado con YouTube" Los logotipos se pueden descargar de la página de lineamientos de desarrollo de la marca. En esa página, también se mostrarán otros íconos y logotipos nuevos de YouTube, que se pueden descargar desde el sitio de la marca de YouTube.

24 de julio de 2017

Esta actualización incluye los siguientes cambios:

• Hay una nueva guía de inicio rápido de la API de YouTube Data disponible para iOS. La guía explica cómo utilizar la API de datos de YouTube en una aplicación simple para iOS escrita en Objective-C o Swift.
• La herramienta de fragmento de código interactivo para la API de datos de YouTube ahora incluye documentación que explica algunas de las funciones de la herramienta:
  • Ejecutar solicitudes a la API
  • Activar o desactivar fragmentos de código y muestras de código completas
  • Uso de funciones estándar
  • Cómo cargar recursos existentes (para métodos de actualización)

  Nota: La herramienta también está incorporada en la documentación de referencia de la API para los métodos de la API (ejemplo).

1 de junio de 2017

Esta actualización incluye los siguientes cambios:

• Nota: Este es un anuncio de baja.

  Las siguientes propiedades del recurso video dejarán de estar disponibles. Si bien se admitirán las propiedades hasta el 1 de diciembre de 2017, no hay garantía de que los videos sigan mostrando valores para esas propiedades hasta ese momento. Del mismo modo, las solicitudes videos.insert y videos.update que establecen esos valores de propiedad no generarán errores antes de esa fecha, pero es posible que no se almacenen los datos entrantes.

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude

17 de mayo de 2017

Esta actualización incluye los siguientes cambios:

• Se actualizó la documentación de referencia de la API para que los fragmentos de código sean más interactivos y omnipresentes. Las páginas en las que se explican los métodos de API, como channels.list o videos.rate, ahora incluyen una herramienta interactiva que te permite ver y personalizar fragmentos de código en Java, JavaScript, PHP, Python, Ruby, Apps Script y Go.

  Para cualquier método determinado, la herramienta muestra fragmentos de código correspondientes a uno o más casos de uso, y cada caso de uso describe una forma común de llamar al método. Por ejemplo, puedes llamar al método channels.list para recuperar datos sobre un canal específico o sobre el canal del usuario actual.

  También puedes interactuar con las muestras de código:

  • Modifica los valores de los parámetros y las propiedades, y los fragmentos de código se actualizan de forma dinámica para reflejar los valores que proporcionas.

  • Alterna entre fragmentos de código y muestras completas. Un fragmento de código muestra la parte del código que llama al método de la API. Una muestra completa contiene ese fragmento y código estándar para autorizar y enviar solicitudes. Las muestras completas se pueden copiar y ejecutar desde la línea de comandos o un servidor web local.

  • Para ejecutar solicitudes, haz clic en un botón. (Para ejecutar solicitudes, debes autorizar a la herramienta a llamar a la API en tu nombre).

  Ten en cuenta que esta herramienta reemplazó al Explorador de APIs en las páginas en las que está disponible. (Cada página muestra un vínculo para que también tengas la opción de cargar en el Explorador de APIs la solicitud en la que estás trabajando).

• La herramienta Fragmentos de código de la API de datos también se actualizó con una nueva IU que ofrece las mismas funciones descritas anteriormente. Las principales funciones nuevas disponibles en esta página son las siguientes:

  • Compatibilidad con solicitudes a la API que escriben datos.
  • Compatibilidad con muestras de Java.
  • Código estándar más flexible y completo para autorizar usuarios y crear solicitudes a la API.

27 de abril de 2017

Esta actualización incluye los siguientes cambios:

• Las nuevas guías de inicio rápido explican cómo configurar una aplicación simple que realiza solicitudes a la API de YouTube Data. Actualmente, hay guías disponibles para Android, Apps Script, Go, Java, JavaScript, Node.js, PHP, Python y Ruby.

30 de marzo de 2017

Esta actualización incluye los siguientes cambios:

• La nueva propiedad topicDetails.topicCategories[] del recurso channel incluye una lista de URLs de Wikipedia que describen el contenido del canal. Las URLs corresponden a los IDs de tema que se muestran en la propiedad topicDetails.topicIds[] del recurso.
• La nueva propiedad contentDetails.videoPublishedAt del recurso playlistItem identifica la hora en que el video se publicó en YouTube. El recurso ya contiene la propiedad snippet.publishedAt, que identifica el momento en que el elemento se agregó a la playlist.
• Al igual que el recurso channel, el recurso video ahora muestra la propiedad topicDetails.topicCategories[], que contiene una lista de URLs de Wikipedia que describen el contenido del video. Para los recursos video, las URLs corresponden a los IDs de temas que se muestran en la propiedad topicDetails.relevantTopicIds[] del recurso.
• La nueva propiedad contentDetails.contentRating.mpaatRating del recurso video identifica la calificación que la Asociación Cinematográfica de Estados Unidos otorgó a la vista previa o el avance de una película.

27 de febrero de 2017

Tal como se anunció originalmente el 11 de agosto de 2016, YouTube cambió la lista admitida de ID de temas por una lista seleccionada. La lista completa de IDs de temas admitidos se incluye en las propiedades topicDetails para los recursos channel y video, así como en el parámetro topicId del método search.list.

Ten en cuenta que hay varios cambios en la lista seleccionada:

• Se agregaron los siguientes temas como subtemas de Society:

  Nombre	ID del tema
  Empresa	/m/09s1f
  Salud	/m/0kt51
  Militar	/m/01h6rj
  Política	/m/05qt0
  Religión	/m/06bvp

• Se quitó el tema Animated cartoon, que anteriormente era un elemento secundario de Entertainment.
• Se quitó el tema Children's music, que anteriormente era un elemento secundario de Music.

Como resultado de este cambio, los temas relacionados con un video ahora se muestran siempre en el valor de propiedad topicDetails.relevantTopicIds[] del recurso video.

29 de noviembre de 2016

Esta actualización incluye los siguientes cambios:

• Existen tres pequeños cambios en la lista de IDs de temas que se admitirán a partir del 10 de febrero de 2017:

  • La categoría Professional wrestling, que antes era secundaria de la categoría Sports, ahora es un elemento secundario de Entertainment.
  • La categoría TV shows, que es un elemento secundario de Entertainment, es nueva.
  • Se quitó la categoría Health, que anteriormente era un elemento secundario de Lifestyle.

  Además, ten en cuenta que hay algunas categorías principales (Entertainment, Gaming, Lifestyle, Music y Sports). Cualquier video asociado a una categoría secundaria, como Tennis, también se asociará con la categoría superior (Sports).

10 de noviembre de 2016

Esta actualización incluye los siguientes cambios:

• Como se anunció por primera vez el 11 de agosto de 2016, la baja de Freebase y de la API de Freebase requiere realizar varios cambios en relación con los ID de tema. Los IDs de tema identifican los temas asociados con los recursos channel y video, y también puedes usar el parámetro de búsqueda topicId para buscar canales o videos relacionados con un tema específico.

  A partir del 10 de febrero de 2017, YouTube comenzará a mostrar un pequeño conjunto de ID de temas en lugar del conjunto mucho más detallado de ID que se mostró hasta ahora. Además, ten en cuenta que no se garantiza que los canales y videos estén asociados con ningún tema, lo que concuerda con el comportamiento actual de la API.

  Para que puedas preparar los clientes de la API para esos cambios, se actualizaron las definiciones de los siguientes parámetros y propiedades de la API a fin de enumerar los IDs de tema que se admitirán después de ese momento. Ten en cuenta que la lista de categorías es la misma para todas las propiedades.

  • La propiedad topicDetails.topicIds[] del recurso channel
  • La propiedad topicDetails.relevantTopicIds[] del recurso video
  • El parámetro topicId del método search.list

• Nota: Este es un anuncio de baja.

  Las siguientes propiedades dejarán de estar disponibles:

  • La propiedad topicDetails.topicIds[] del recurso channel Esta propiedad se admitirá hasta el 10 de noviembre de 2017.
  • La propiedad topicDetails.relevantTopicIds[] del recurso video Esta propiedad se admitirá hasta el 10 de noviembre de 2017.
  • La propiedad topicDetails.topicIds[] del recurso video Esta propiedad no contendrá valores después del 10 de febrero de 2017. (Después de esa fecha, el valor de la propiedad topicDetails.relevantTopicIds[] identificará todos los temas asociados con un video).

• Dado que Freebase ya no está disponible, la guía Cómo buscar con temas de Freebase se eliminó de la documentación. Esa guía proporcionó muestras de código para demostrar cómo funcionaría una aplicación con la API de Freebase.

  Además, se quitaron varias muestras de código relacionadas con los IDs de tema de la documentación del método search.list.

2 de noviembre de 2016

Esta actualización incluye los siguientes cambios:

• Propiedades y parámetros nuevos

  • El recurso video contiene varias propiedades nuevas:

    • La propiedad player.embedHtml contiene una etiqueta <iframe> que puedes usar para incorporar un reproductor que reproduzca el video. Las nuevas propiedades player.embedHeight y player.embedWidth identifican las dimensiones del reproductor incorporado. Estas propiedades solo se muestran si la solicitud a la API especifica un valor para al menos uno de los parámetros maxHeight o maxWidth. Esos dos parámetros nuevos se explican más adelante en esta entrada del historial de revisión.

    • La nueva propiedad hasCustomThumbnail indica si quien subió el video proporcionó una imagen en miniatura personalizada para el video. Ten en cuenta que esta propiedad solo es visible para quien sube el video.

    • El nuevo fpbRatingReasons[] identifica los motivos por los que el video recibió la clasificación FPB (Sudáfrica).

    • El nuevo mcstRating identifica la clasificación que recibió el video en Vietnam.

  • El método videos.list admite dos parámetros nuevos, maxHeight y maxWidth. Puedes usar cualquiera de los parámetros o ambos cuando recuperas la parte player en los recursos video.

    De forma predeterminada, la altura del <iframe> que se muestra en la propiedad player.embedHtml es de 360 px. El ancho se ajusta para coincidir con la relación de aspecto del video, lo que garantiza que el reproductor insertado no tenga barras negras que encuadren el video. Por ejemplo, si la relación de aspecto de un video es 16:9, el ancho del reproductor será de 640 px.

    Con los nuevos parámetros, puedes especificar que, en lugar de las dimensiones predeterminadas, el código de incorporación utilice una altura o un ancho adecuados para el diseño de tu aplicación. El servidor de la API ajusta las dimensiones del reproductor según corresponda para garantizar que el reproductor incorporado no tenga barras negras que encuadren el video. Ten en cuenta que ambos parámetros especifican las dimensiones máximas del reproductor incorporado. Por lo tanto, si se especifican ambos parámetros, una dimensión podría ser inferior a la cantidad máxima permitida para esa dimensión.

    Por ejemplo, supongamos que un video tiene una relación de aspecto de 16:9. Por lo tanto, la etiqueta player.embedHtml contendría un reproductor de 640 × 360 si no se establecen los parámetros maxHeight o maxWidth.

    • Si el parámetro maxHeight se establece en 720 y no se establece el parámetro maxWidth, la API mostrará un reproductor de 1280 × 720.
    • Si el parámetro maxWidth se establece en 960 y no se establece el parámetro maxHeight, la API mostrará un reproductor de 960 × 540.
    • Si el parámetro maxWidth se establece en 960 y el parámetro maxHeight en 450, la API mostrará un reproductor de 800 × 450.

    Las nuevas propiedades player.embedHeight y player.embedWidth, que se describieron anteriormente, identifican las dimensiones del reproductor.

• Actualizaciones de métodos, propiedades y parámetros existentes

  • Se actualizó la descripción del recurso channelSection para indicar que un canal puede crear un máximo de 10 bibliotecas sin establecer datos de segmentación y puede crear un máximo de 100 bibliotecas con datos de segmentación.

    Además, se actualizó la propiedad targeting del recurso channelSection para reflejar el hecho de que las opciones de segmentación solo se pueden configurar con la API. Las opciones de segmentación se borran si se modifica la sección del canal mediante la interfaz de usuario del sitio web de YouTube.

  • Se corrigió la definición de la propiedad snippet.name del recurso i18nLanguage para reflejar que el valor representa el nombre de un idioma tal como está escrito en el idioma especificado en el parámetro hl del método i18nLanguage.list.

  • Se actualizó la propiedad contentDetails.note del recurso playlistItem para indicar que la longitud máxima del valor de propiedad es de 280 caracteres.

  • Las propiedades contentDetails.startAt y contentDetails.endAt del recurso playlistItem dejaron de estar disponibles. Estos campos se ignoran si se configuran en solicitudes playlistItems.insert o playlistItems.update.

  • Los métodos playlistItems.delete y playlistItems.update ahora admiten el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos. Las solicitudes que usan ese método también deben autorizarse con un token que proporcione acceso al permiso https://www.googleapis.com/auth/youtubepartner.

  • Se actualizaron los parámetros publishedBefore y publishedAfter del método search.list para indicar que los valores del parámetro son inclusivos. Entonces, por ejemplo, si se configura el parámetro publishedBefore, la API muestra recursos creados antes o en el momento especificado.

  • La propiedad contentDetails.contentRating.grfilmRating del recurso video admite tres valores adicionales: grfilmK12, grfilmK15 y grfilmK18.

  • Se actualizó la descripción del método videos.insert para indicar que el tamaño máximo de los archivos para los videos subidos aumentó de 64 GB a 128 GB.

• Errores nuevos y actualizados

  • La API admite los siguientes errores nuevos:

    Tipo de error	Detalle del error	Descripción
    forbidden (403)	homeParameterDeprecated	El método activities.list muestra este error para indicar que los datos de actividad de la página principal del usuario no están disponibles a través de esta API. Este error puede ocurrir si configuras el parámetro home como true en una solicitud no autorizada.
    invalidValue (400)	invalidContentDetails	El método playlistItems.insert muestra este error para indicar que el objeto contentDetails de la solicitud no es válido. Uno de los motivos por los que se produce este error es que el campo contentDetails.note tiene más de 280 caracteres.
    forbidden (403)	watchHistoryNotAccessible	El método playlistItems.list muestra este error para indicar que la solicitud intentó recuperar el “historial de reproducciones” elementos de la playlist, pero no se pueden recuperar usando la API.
    forbidden (403)	watchLaterNotAccessible	El método playlistItems.list muestra este error para indicar que la solicitud intentó recuperar “ver más tarde”. elementos de la playlist, pero no se pueden recuperar usando la API.
    badRequest (400)	uploadLimitExceeded	El método videos.insert devuelve este error para indicar que el canal superó la cantidad de videos que puede subir.
    forbidden (403)	forbiddenEmbedSetting	El método videos.update devuelve este error para indicar que la solicitud a la API intenta establecer una configuración de incorporación no válida para el video. Ten en cuenta que es posible que algunos canales no tengan permiso para ofrecer reproductores incorporados en las transmisiones en vivo. Para obtener más información, consulta el Centro de ayuda de YouTube.

  • El método playlistItems.insert ya no muestra un error si insertas un video duplicado en una playlist. Ese error ocurrió anteriormente en algunas playlists, como los videos favoritos, que no permitían duplicados, pero ya no son compatibles. En general, las playlists permiten videos duplicados.

• Otras actualizaciones

  • Se actualizó la entrada del historial de revisión del 15 de septiembre de 2016 para aclarar que, siempre que se incluyan en una respuesta las propiedades contentDetails.relatedPlaylists.watchHistory y contentDetails.relatedPlaylists.watchLater del recurso channel, siempre contendrán los valores HL y WL, respectivamente. Además, esas propiedades solo se incluyen si un usuario autorizado recupera datos sobre el canal del usuario.

15 de septiembre de 2016

Esta actualización incluye los siguientes cambios:

• En la actualización del historial de revisión del 11 de agosto de 2016, se analizaron varios cambios relacionados con los IDs de temas, incluido el hecho de que el conjunto de IDs de temas admitidos cambiará a partir del 10 de febrero de 2017. La lista de temas que se admitirán se publicará el 10 de noviembre de 2016.

• Los siguientes cambios ya entraron en vigencia. Estos cambios se notificaron en la actualización del historial de revisión el 11 de agosto de 2016:

  • Si se llama al método activities.list con el parámetro home establecido en true, la respuesta de la API ahora contiene elementos similares a los que vería en la página principal un usuario de YouTube que no accedió a su cuenta.

    Este es un pequeño cambio que pretende proporcionar una mejor experiencia del usuario que el comportamiento descrito en la actualización del historial de revisión del 11 de agosto de 2016. Esa actualización indicó que las solicitudes que usaban el parámetro home mostrarían una lista vacía.

  • Las propiedades contentDetails.relatedPlaylists.watchHistory y contentDetails.relatedPlaylists.watchLater del recurso channel ahora contienen valores de HL y WL, respectivamente, para todos los canales.

    Para ser claros, estas propiedades solo son visibles para un usuario autorizado que recupera datos sobre el canal del usuario. Las propiedades siempre contienen los valores HL y WL, incluso para un usuario autorizado que recupera datos sobre el canal del usuario. Por lo tanto, los ID de las listas de reproducción del historial de reproducciones y de la lista de reproducción Ver más tarde no se pueden recuperar a través de la API.

    Además, las solicitudes para recuperar los detalles de la playlist (playlists.list) o los elementos de la playlist (playlistItems.list) del historial de reproducciones de un canal o de la playlist Ver más tarde ahora mostrarán listas vacías. Este comportamiento se aplica a los valores nuevos, HL y WL, así como a los ID de los historiales de reproducciones o de las listas de reproducción para ver más tarde que tu cliente de API ya haya almacenado.

• Ya no se muestran el objeto fileDetails.recordingLocation del recurso video ni sus propiedades secundarias. Anteriormente, estos datos (como el objeto superior fileDetails) solo los podía recuperar el propietario de un video.

11 de agosto de 2016

Esta actualización incluye los siguientes cambios:

• Las nuevas Condiciones del Servicio de los Servicios de la API de YouTube (“las Condiciones actualizadas”), que se analizan en detalle en el Blog para desarrolladores e ingeniería de YouTube, proporcionan un conjunto amplio de actualizaciones a las Condiciones del Servicio actuales. Además de las Condiciones actualizadas, que entrarán en vigencia el 10 de febrero de 2017, esta actualización incluye varios documentos de respaldo que ayudan a explicar las políticas que deben seguir los desarrolladores.

  El conjunto completo de documentos nuevos se describe en el historial de revisión de las Condiciones actualizadas. Además, los cambios futuros que se realicen en las Condiciones actualizadas o en los documentos de respaldo también se explicarán en ese historial de revisión. Puedes suscribirte a un feed RSS que enumere los cambios de ese historial de revisión desde un vínculo de ese documento.

• La baja de Freebase y de la API de Freebase provoca varios cambios en relación con los ID de temas. Los IDs de tema se usan en los siguientes recursos y métodos de la API:

  • La parte topicDetails del recurso channel identifica los temas asociados con el canal.
  • La parte topicDetails del recurso video identifica los temas asociados con el video.
  • El parámetro topicId del método search.list te permite buscar videos o canales relacionados con un tema específico.

  Los cambios en estas funciones son los siguientes:

  • A partir del 10 de febrero de 2017, YouTube comenzará a mostrar un pequeño conjunto de ID de temas en lugar del conjunto mucho más detallado de ID que se mostró hasta ahora. Ese conjunto de temas admitidos identificará categorías generales, como Deportes o Básquet, pero, por ejemplo, no identificará equipos ni jugadores específicos. Anunciaremos el conjunto de temas admitidos para que tengas tiempo de preparar tu postulación para este cambio.

  • Los IDs de tema de Freebase que ya hayas recuperado se pueden usar para buscar contenido hasta el 10 de febrero de 2017. Sin embargo, después de ese tiempo, solo podrás usar el conjunto más pequeño de temas identificado en el elemento anterior para recuperar los resultados de la búsqueda por tema.

  • Después del 10 de febrero de 2017, si intentas buscar resultados con un ID de tema que no se encuentra en el conjunto más pequeño de ID de temas admitidos, la API mostrará un conjunto de resultados vacío.

• Varios campos y parámetros de la API dejarán de estar disponibles a partir del 12 de septiembre de 2016:

  • El parámetro home del método activities.list permitió que un usuario autorizado recuperara el feed de actividad que se mostraría en la página principal de YouTube para ese usuario. Las solicitudes que usen este parámetro después del 12 de septiembre de 2016 mostrarán una lista vacía.

  • Las propiedades contentDetails.relatedPlaylists.watchHistory y contentDetails.relatedPlaylists.watchLater del recurso channel solo son visibles para un usuario autorizado que recupera datos sobre el propio canal del usuario. Después del 12 de septiembre de 2016, contentDetails.relatedPlaylists.watchHistory mostrará un valor de HL y la propiedad contentDetails.relatedPlaylists.watchLater mostrará un valor de WL para todos los canales.

    Las solicitudes para recuperar detalles de listas de reproducción (playlists.list) del historial de reproducciones o de la lista de reproducción Ver más tarde de un canal mostrarán una lista vacía después del 12 de septiembre de 2016. Las solicitudes para recuperar elementos de playlists (playlistItems.list) en cualquiera de esas playlists también mostrarán una lista vacía después de ese tiempo. Esto se aplica a los nuevos valores, HL y WL, así como a los ID de los historiales de reproducciones o de las listas de reproducción para ver más tarde que tu cliente de API ya haya almacenado.

  • El objeto fileDetails.recordingLocation del recurso video o cualquiera de sus propiedades secundarias ya no se mostrarán después del 12 de septiembre de 2016. Estos datos solo los puede recuperar el propietario de un video, ya que solo el propietario del video puede recuperar el objeto superior fileDetails.

13 de junio de 2016

Esta actualización incluye los siguientes cambios:

• La propiedad contentDetails.googlePlusUserId del recurso channel dejó de estar disponible. Anteriormente, la propiedad solo estaba presente si el canal estaba asociado a un perfil de Google+. Tras la baja, la propiedad ya no se incluirá en ningún recurso de channel.

• La propiedad snippet.authorGoogleplusProfileUrl del recurso comment dejó de estar disponible. Anteriormente, la propiedad solo estaba presente si el canal estaba asociado a un perfil de Google+. Tras la baja, la propiedad ya no se incluirá en ningún recurso de comment.

Dado que ninguna de estas propiedades se mostrará después de la baja, ambas se quitaron de la documentación de recursos correspondiente.

31 de mayo de 2016

Esta actualización incluye los siguientes cambios:

• El nuevo parámetro myRecentSubscribers del método subscriptions.list recupera una lista de los suscriptores del canal del usuario autenticado en orden cronológico inverso, de la hora en que se suscribieron al canal.

  Ten en cuenta que el nuevo parámetro solo admite la recuperación de los 1000 suscriptores más recientes del canal del usuario autenticado. Para recuperar una lista completa de suscriptores, usa el parámetro mySubscribers. Ese parámetro, que no muestra suscriptores en un orden en particular, no limita la cantidad de suscriptores que se pueden recuperar.

• Se actualizó la definición de la propiedad snippet.thumbnails.(key) para los recursos activity, playlistItem, playlist, resultado de la búsqueda, miniatura y video con el fin de indicar que existen tamaños adicionales de imágenes en miniatura disponibles para algunos videos.

  • La imagen standard tiene 640 px de ancho y 480 px de alto.
  • La imagen maxres tiene 1280 px de ancho y 720 px de alto.

• Se actualizó la definición del parámetro part del método channelSection.list para indicar que la parte targeting se puede recuperar a un costo de 2 unidades de cuota.

• El método videos.list ahora muestra un error prohibido (403) cuando una solicitud autorizada de forma incorrecta intenta recuperar las partes fileDetails, processingDetails o suggestions de un recurso video. Esas partes solo están disponibles para el propietario del video.

17 de mayo de 2016

La nueva herramienta Fragmentos de código de la API de datos proporciona fragmentos de código cortos para casos de uso comunes de la API de datos de YouTube. Actualmente, los fragmentos de código están disponibles para todos los métodos de API de solo lectura en Apps Script, Go, JavaScript, PHP, Python y Ruby.

Para cada método, la herramienta presenta muestras de código de uno o más casos de uso. Por ejemplo, proporciona cinco fragmentos de código para el método search.list:

• Enumera videos por palabra clave
• Cómo enumerar videos por ubicación
• Enumerar eventos en vivo
• Buscar los videos del usuario autenticado
• Enumerar videos relacionados

Para cada caso de uso, la herramienta muestra los parámetros utilizados en la solicitud a la API. Puedes modificar los valores de los parámetros, en cuyo caso la herramienta actualiza los fragmentos de código para reflejar los valores de parámetros que proporcionaste.

Por último, la herramienta muestra la respuesta de la API a cada solicitud. Si modificaste los parámetros de la solicitud, la respuesta de la API se basará en los valores de los parámetros proporcionados. Ten en cuenta que debes autorizar a la herramienta para que envíe solicitudes en tu nombre para que se muestren las respuestas de la API.

28 de abril de 2016

Esta actualización incluye los siguientes cambios:

• La nueva propiedad contentDetails.projection del recurso video especifica el formato de proyección del video. Los valores de propiedad válidos son 360 y rectangular.

• Se actualizaron las propiedades recordingDetails.location y fileDetails.recordingLocation del recurso video para explicar la diferencia entre las dos propiedades:

  • La propiedad recordingDetails.location identifica la ubicación que el propietario del video quiere asociar con él. La ubicación se puede editar, se puede buscar en los videos públicos y es posible que se muestre a los usuarios para los videos públicos.
  • El valor de la propiedad fileDetails.recordingLocation es inmutable y representa la ubicación asociada con el archivo de video original que se subió. Solo el propietario del video puede ver este valor.

• Se actualizó la definición de la propiedad contentDetails.relatedPlaylists.favorites del recurso channel para indicar que el valor de la propiedad puede contener el ID de una playlist que hace referencia a una playlist vacía y que no se puede recuperar. Esto se debe a que la función de videos favoritos ya no está disponible. Ten en cuenta que esta propiedad no está sujeta a la política de baja de la API.

• La definición del error ineligibleAccount, que puede mostrar el método comments.insert, comments.update, commentThreads.insert o commentThreads.update, se actualizó para reflejar que el error se produce cuando la cuenta de YouTube que se utilizó para autorizar la solicitud a la API no se fusionó con la Cuenta de Google del usuario.

20 de abril de 2016

Esta actualización incluye los siguientes cambios:

• Se actualizó la definición del parámetro part del método channels.update a fin de indicar que localizations también es un valor válido para ese parámetro.

• Se actualizó la sección Uso de la cuota de la guía de introducción para incluir un vínculo a Google Developers Console, donde puedes ver tu cuota y su uso reales.

16 de marzo de 2016

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • Se actualizó la documentación del recurso channelBanner para indicar que el tamaño recomendado para la imagen del banner del canal subida es de 2560 px por 1440 px. El tamaño mínimo (2048 por 1152 píxeles) no ha cambiado.

  • La nueva propiedad snippet.customUrl del recurso channel identifica la URL personalizada asociada con el canal. (No todos los canales tienen URLs personalizadas). En el Centro de ayuda de YouTube, se explican los requisitos de elegibilidad para obtener una URL personalizada y cómo configurarla.

  • El objeto brandingSettings.watch del recurso channel y todas sus propiedades secundarias dejaron de estar disponibles.

  • La respuesta de la API a una solicitud search.list ahora contiene una propiedad regionCode. La propiedad identifica el código de región que se usó para la búsqueda. El código de región le indica a la API que devuelva resultados de búsqueda para el país especificado.

    El valor de la propiedad es un código de país ISO de dos letras que identifica la región. El método i18nRegions.list muestra una lista de regiones admitidas. El valor predeterminado es US. Si se especifica una región no admitida, es posible que YouTube seleccione otra región, en lugar del valor predeterminado, para manejar la consulta.

  • Se actualizaron las definiciones de las propiedades snippet.label y snippet.secondaryReasons[].label del recurso videoAbuseReportReason para indicar que las propiedades contienen texto de etiqueta localizado por los motivos de la denuncia de abuso.

    Además, el método videoAbuseReportReasons.list ahora admite el parámetro hl, que especifica el idioma que se debe usar para el texto de la etiqueta en la respuesta de la API. El valor predeterminado del parámetro es en_US.

  • La nueva propiedad contentDetails.contentRating.ecbmctRating del recurso video identifica la calificación de un video de la Junta de Evaluación y Clasificación del Ministerio de Cultura y Turismo de Türkiye.

    Además, las propiedades de API para otros sistemas de calificación admiten los siguientes valores de propiedad nuevos:

    • contentDetails.contentRating.fpbRating (Sudáfrica)
      Calificación: 10; valor de la propiedad: fpb10
    • contentDetails.contentRating.moctwRating (Taiwán)
      Calificación: R-12; valor de la propiedad: moctwR12
    • contentDetails.contentRating.moctwRating (Taiwán)
      Calificación: R-15; valor de la propiedad: moctwR15

  • La propiedad liveStreamingDetails.activeLiveChatId del recurso video contiene el ID del chat en vivo activo asociado con el video. El valor de la propiedad solo está presente si el video es una transmisión en vivo actual que tiene habilitado el chat en vivo. Una vez que finaliza la transmisión y el chat en vivo, ya no se devuelve la propiedad del video.

  • La propiedad status.rejectionReason del recurso video admite el nuevo valor de propiedad legal.

• La API admite los siguientes errores nuevos:

  Tipo de error	Detalle del error	Descripción
  badRequest (400)	notEditable	Los métodos channelSections.insert, channelSections.update y channelSections.delete muestran este error para indicar que no se puede crear, actualizar ni borrar la sección del canal especificada.
  badRequest (400)	styleRequired	Los métodos channelSections.insert y channelSections.update muestran este error para indicar que el recurso channelSection enviado en la solicitud a la API debe especificar un valor para la propiedad snippet.style.
  badRequest (400)	typeRequired	Los métodos channelSections.insert y channelSections.update muestran este error para indicar que el recurso channelSection enviado en la solicitud a la API debe especificar un valor para la propiedad snippet.type.
  badRequest (400)	processingFailure	El método commentThreads.list muestra este error para indicar que el servidor de la API no pudo procesar correctamente la solicitud. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válida.
  forbidden (403)	commentsDisabled	El método commentThreads.list muestra este error para indicar que se inhabilitaron los comentarios en el video identificado por el parámetro videoId.
  badRequest (400)	commentTextTooLong	El método commentThreads.insert muestra este error para indicar que el recurso comment que se inserta contiene demasiados caracteres en la propiedad snippet.topLevelComment.snippet.textOriginal.
  invalidValue (400)	videoAlreadyInAnotherSeriesPlaylist	El método playlistItems.insert devuelve este error para indicar que el video que intentas agregar a la playlist ya está en otra playlist de series. Consulta el Centro de ayuda de YouTube para obtener más información sobre las playlists de series.
  badRequest (400)	subscriptionForbidden	El método subscriptions.insert muestra este error para indicar que alcanzaste la cantidad máxima de suscripciones o que creaste demasiadas suscripciones recientes. En este último caso, puedes reintentar la solicitud después de unas horas.
  badRequest (400)	invalidCategoryId	El método videos.update muestra este error para indicar que la propiedad snippet.categoryId en el recurso video subido especificó un ID de categoría no válido. Usa el método videoCategories.list para recuperar las categorías admitidas.
  badRequest (400)	invalidDescription	El método videos.update muestra este error para indicar que la propiedad snippet.description en el recurso video subido especificó un valor no válido.
  badRequest (400)	invalidPublishAt	El método videos.update muestra este error para indicar que la propiedad status.publishAt en el recurso video subido especificó una hora de publicación programada no válida.
  badRequest (400)	invalidRecordingDetails	El método videos.update muestra este error para indicar que el objeto recordingDetails en el recurso video subido especificó detalles de registro no válidos.
  badRequest (400)	invalidTags	El método videos.update muestra este error para indicar que la propiedad snippet.tags en el recurso video subido especificó un valor no válido.
  badRequest (400)	invalidTitle	El método videos.update muestra este error para indicar que la propiedad snippet.title en el recurso video subido especificó un título de video no válido o vacío.
  badRequest (400)	invalidVideoMetadata	El método videos.update muestra este error para indicar que los metadatos de la solicitud no son válidos. Este error se produce si la solicitud actualiza la parte snippet de un recurso video, pero no establece un valor para las propiedades snippet.title y snippet.categoryId.

18 de diciembre de 2015

Las leyes de la Unión Europea (UE) exigen que se proporcione cierta divulgación a los usuarios finales de la UE y que se obtenga el consentimiento de ellos. Por lo tanto, en el caso de los usuarios finales de la Unión Europea, debe satisfacer la Política de Consentimiento de Usuarios de la UE. Agregamos un aviso sobre este requisito en las Condiciones del Servicio de la API de YouTube.

19 de noviembre de 2015

La API ahora admite la capacidad de establecer y recuperar texto localizado para las propiedades snippet.title y snippet.description de los recursos playlist y video, la propiedad snippet.title del recurso channelSection y la propiedad snippet.description del recurso channel.

• Cómo configurar títulos y descripciones localizados

  Puedes establecer valores localizados para un recurso cuando llamas al método insert o update para ese recurso. Para establecer valores localizados para un recurso, haz lo siguiente:

  • Asegúrate de establecer un valor para la propiedad snippet.defaultLanguage del recurso. Esa propiedad identifica el idioma de las propiedades snippet.title y snippet.description del recurso. El valor puede ser cualquier idioma de aplicación compatible o la mayoría de los demás códigos de idioma ISO 639-1:2002. Por ejemplo, si subes un video que tiene un título y una descripción en inglés, debes establecer la propiedad snippet.defaultLanguage en en.

    Nota para actualizar recursos channel: Si quieres configurar la propiedad snippet.defaultLanguage para un recurso channel, debes actualizar la propiedad brandingSettings.channel.defaultLanguage.

  • Agrega el objeto localizations al recurso que estás actualizando. Cada clave de objeto es una cadena que identifica el idioma de una aplicación o un código de idioma ISO 639-1:2002, y cada clave se asigna a un objeto que contiene el título localizado (y la descripción) del recurso.

    En el siguiente fragmento de ejemplo, se configura el idioma predeterminado del recurso en inglés. También agrega títulos y descripciones localizados en alemán y español a un video:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        ...
      },
      "localizations":
        "de": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        },
        "es": {
          "title": "Jugar al fútbol",
          "description": "Nosotros jugamos fútbol en el parque los domingos",
        }
      }
    }

  Importante: Recuerda que, cuando actualizas los datos localizados de un recurso, la solicitud a la API debe incluir todas las versiones localizadas existentes de los datos. Por ejemplo, si enviaste una solicitud posterior para agregar datos en portugués al video del ejemplo anterior, la solicitud deberá incluir datos localizados en alemán, español y portugués.

• Cómo recuperar valores localizados

  La API admite dos maneras de recuperar valores localizados para un recurso:

  • Agrega el parámetro hl a tu solicitud de channels.list, channelSections.list, playlists.list o videos.list para recuperar datos localizados de un idioma de aplicación específico compatible con el sitio web de YouTube. Si los detalles de recursos localizados están disponibles en ese idioma, el objeto snippet.localized del recurso contendrá los valores localizados. Sin embargo, si no hay detalles localizados disponibles, el objeto snippet.localized contendrá detalles del recurso en el idioma predeterminado del recurso.

    Por ejemplo, supongamos que una solicitud videos.list recupera datos para el video descrito anteriormente con datos localizados en alemán y español. Si el parámetro hl se configurara como de, el recurso contendría los siguientes datos:

    {
      "kind": "youtube#video",
      ...
      "snippet": {
        "title": "Playing soccer",
        "description": "We play soccer in the park on Sundays.",
        "defaultLanguage": "en",
        "localized": {
          "title": "Fußball spielen",
          "description": "Wir spielen Fußball im Park am Sonntag"
        }
        ...
      }
    }

    Sin embargo, si el parámetro hl se configurara como fr, el objeto snippet.localized contendrá el título y la descripción en inglés, ya que es el idioma predeterminado del recurso y no hay detalles disponibles en francés.

    Importante: El parámetro hl solo admite valores que identifican los idiomas de apps compatibles con el sitio web de YouTube. Para determinar si el texto localizado está disponible para otros idiomas, debes recuperar la parte localizations del recurso y filtrar para determinar si el texto localizado existe.
    
    Por ejemplo, debes recuperar la lista completa de localizaciones para determinar si el texto localizado está disponible en inglés de los Apalaches.
    
    

  • Cuando recuperes un recurso, incluye localizations en el valor del parámetro part para recuperar todos los detalles localizados de ese recurso. Si quieres recuperar datos localizados de un idioma que no es el idioma actual de una aplicación de YouTube, debes usar este enfoque para recuperar todas las localizaciones y, luego, aplicar un filtro para determinar si existen los datos localizados que deseas.

• Errores relacionados con valores de texto localizado

  La API también admite los siguientes errores nuevos para valores de texto localizado:

  Tipo de error	Detalle del error	Descripción
  badRequest (400)	defaultLanguageNotSetError	Este error indica que falla una solicitud que intenta insertar o actualizar el objeto localizations de un recurso porque la propiedad snippet.defaultLanguage no está configurada para ese recurso. Los métodos channels.update, channelSections.insert, channelSections.update, playlists.insert, playlists.update, videos.insert y videos.update admiten este error.
  badRequest (400)	localizationValidationError	Este error indica que no se pudo validar uno de los valores en el objeto localizations de un recurso. Por ejemplo, este error puede ocurrir si el objeto contiene un código de idioma no válido. Los métodos channels.update, channelSections.insert, channelSections.update, playlists.insert y playlists.update admiten este error.

4 de noviembre de 2015

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • Se actualizó el parámetro order del método search.list para indicar que, si ordenas las transmisiones en vivo por viewCount, los resultados de la API se ordenan según las transmisiones. la cantidad de espectadores simultáneos mientras las transmisiones aún están en curso.

  • Se actualizó el parámetro relatedToVideoId del método search.list para indicar que, si se configura el parámetro, los únicos otros parámetros admitidos son part, maxResults, pageToken, regionCode, relevanceLanguage, safeSearch, type (que debe establecerse en video) y fields. Esta actualización no refleja un cambio en el comportamiento de la API.

  • Se actualizó la definición de la propiedad snippet.publishedAt del recurso video para indicar que el valor de la propiedad, que especifica la fecha y hora en que se publicó el video, puede ser diferente a la hora en que se subió. Por ejemplo, si un video se sube como privado y, luego, se hace público, el valor de la propiedad especifica el momento en que el video se hizo público. La definición actualizada también explica cómo se propaga el valor para los videos privados y no listados.

    Este cambio no refleja un cambio en el comportamiento de la API.

  • Se actualizó la definición de la propiedad status.publishAt del recurso video para tener en cuenta lo siguiente:

    • Si configuras el valor de esta propiedad cuando llamas al método videos.update, también debes establecer el valor de la propiedad status.privacyStatus en private, incluso si el video ya es privado.
    • Si la solicitud programa la publicación de un video en algún momento en el pasado, este se publicará de inmediato. Por lo tanto, el efecto de configurar la propiedad status.publishAt en una fecha y hora pasadas es el mismo que cambiar el privacyStatus del video de private a public.

  • La propiedad contentDetails.contentRating.cncRating del recurso video especifica la calificación del video según la Comisión de Clasificación Cinematográfica de Francia. Esta propiedad reemplaza la propiedad contentDetails.contentRating.fmocRating, que dejó de estar disponible.

  • Se actualizó la definición del elemento brandingSettings.channel.keywords del recurso channel para reflejar correctamente que el valor de la propiedad contiene una lista de strings separadas por espacios y no una lista separada por comas, como se documentó anteriormente. Esta actualización no refleja un cambio en el comportamiento de la API.

  • Se actualizó la documentación del método thumbnails.set para reflejar con exactitud que el cuerpo de la solicitud contiene la imagen en miniatura que subirás y asocias con un video. El cuerpo de la solicitud no contiene un recurso thumbnail. Anteriormente, la documentación decía que no debías proporcionar un cuerpo de solicitud cuando se llamaba a este método. Esta actualización no refleja un cambio en el comportamiento de la API.

  • Se actualizó la descripción del recurso activity para reflejar el hecho de que, por el momento, el método activities.list no incluye recursos relacionados con comentarios nuevos de videos. También se actualizaron los elementos snippet.type y contentDetails.comment del recurso.

• Errores nuevos y actualizados

  • La API ahora admite los siguientes errores:

    Detalles del error
    activities.insert	Código de respuesta HTTP badRequest (400) Motivo invalidMetadata Descripción La propiedad kind no coincide con el tipo de ID proporcionado.
    commentThreads.update comments.insert comments.update	Código de respuesta HTTP badRequest (400) Motivo commentTextTooLong Descripción El recurso comment que se está insertando o actualizando contiene demasiados caracteres en la propiedad snippet.topLevelComment.snippet.textOriginal.
    playlistItems.insert playlistItems.update	Código de respuesta HTTP forbidden (403) Motivo playlistItemsNotAccessible Descripción La solicitud no está debidamente autorizada para insertar, actualizar o eliminar el elemento especificado de la playlist.
    playlists.delete playlists.insert playlists.update	Código de respuesta HTTP badRequest (400) Motivo playlistForbidden Descripción Esta operación está prohibida o la solicitud no está debidamente autorizada.
    search.list	Código de respuesta HTTP badRequest (400) Motivo invalidLocation Descripción El valor del parámetro location o locationRadius tenía un formato incorrecto.
    search.list	Código de respuesta HTTP badRequest (400) Motivo invalidRelevanceLanguage Descripción El valor del parámetro relevanceLanguage tenía un formato incorrecto.
    subscriptions.insert	Código de respuesta HTTP badRequest (400) Motivo subscriptionForbidden Descripción Este error ocurre cuando se cumple alguna de las siguientes condiciones: La suscripción que intentas crear ya existe Alcanzaste la cantidad máxima de suscripciones Estás intentando suscribirte a tu propio canal, que no se admite. Creaste demasiadas suscripciones recientemente y debes esperar unas horas antes de reintentar la solicitud.
    videos.update	Código de respuesta HTTP badRequest (400) Motivo invalidDefaultBroadcastPrivacySetting Descripción La solicitud intenta establecer una configuración de privacidad no válida para la transmisión predeterminada.

28 de agosto de 2015

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • La propiedad statistics.favoriteCount del recurso video dejó de estar disponible.

    De acuerdo con nuestra política de baja, esta propiedad seguirá incluida en los recursos de video durante al menos un año después de este anuncio. Sin embargo, el valor de la propiedad ahora está siempre establecido en 0.

7 de agosto de 2015

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • Se actualizó la definición de la propiedad snippet.tags[] del recurso video para proporcionar más información sobre cómo el servidor de la API calcula la longitud del valor de la propiedad. Ten en cuenta que esta actualización no refleja un cambio en el comportamiento de la API.

    Específicamente, la definición ahora explica que si una etiqueta contiene un espacio, el servidor de la API maneja el valor de la etiqueta como si estuviera entre comillas, y estas se consideran para el límite de caracteres. Por lo tanto, a efectos de establecer límites de caracteres, la etiqueta Foo-Baz contiene siete caracteres, pero la etiqueta Foo Baz contiene nueve.

  • El método commentThreads.insert ya no admite el parámetro shareOnGooglePlus, que indicaba anteriormente si un comentario y sus respuestas también debían publicarse en el perfil de Google+ del autor. Si una solicitud envía el parámetro, el servidor de la API lo ignora, pero controla la solicitud.

18 de junio de 2015

Esta actualización incluye los siguientes cambios:

• Actualizaciones de recursos y métodos existentes

  • El nuevo parámetro order del método commentThreads.list especifica el orden en el que la respuesta de la API debe enumerar los hilos de comentarios. Las conversaciones se pueden ordenar por tiempo o relevancia. El comportamiento predeterminado es ordenarlas por tiempo.

  • La nueva propiedad snippet.defaultAudioLanguage del recurso video especifica el idioma que se habla en la pista de audio predeterminada del video.

  • Se actualizó la definición de la propiedad contentDetails.licensedContent del recurso video para aclarar que el contenido se debe haber subido originalmente a un canal vinculado a un socio de contenido de YouTube y, luego, reclamado por ese socio. Esto no representa un cambio en el comportamiento real de la API.

  • Los métodos captions.delete, captions.download, captions.insert, captions.list y captions.update ahora admiten el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos. Las solicitudes que usan ese método también deben autorizarse con un token que proporcione acceso al permiso https://www.googleapis.com/auth/youtubepartner.

• Errores nuevos y actualizados

  • La API ahora admite los siguientes errores:

    Detalles del error
    videos.rate	Código de respuesta HTTP badRequest (400) Motivo emailNotVerified Descripción El usuario debe verificar su dirección de correo electrónico antes de calificar el video.
    videos.rate	Código de respuesta HTTP badRequest (400) Motivo videoPurchaseRequired Descripción Solo los usuarios que los alquilaron pueden calificar los videos de alquiler.

  • Los métodos subscriptions.delete y subscriptions.insert ya no admiten los errores accountClosed y accountSuspended.

27 de abril de 2015

Esta actualización incluye los siguientes cambios:

• Nuevos recursos y métodos

  • El nuevo recurso videoAbuseReportReason contiene información sobre un motivo por el que se marcaría un video por incluir contenido abusivo. El método videoAbuseReportReasons.list te permite recuperar una lista de todos los motivos por los que podrían marcarse videos.

  • El nuevo método videos.reportAbuse proporciona una forma de marcar un video con contenido abusivo. El cuerpo de la solicitud contiene un objeto JSON que especifica el video que se marca, así como el motivo por el que se considera que el video incluye contenido abusivo. Los motivos válidos se pueden obtener del método videoAbuseReportReason.list descrito anteriormente.

    La guía de migración también se actualizó con un ejemplo para denunciar un video abusivo. Con este cambio, la API v3 ahora admite todas las funciones de la API v2 que está programada para admitir. Todas estas funciones también se explican en la guía de migración.

• Actualizaciones de recursos y métodos existentes

  • El nuevo parámetro de filtro forDeveloper del método search.list restringe la búsqueda para recuperar solo los videos subidos mediante la aplicación o el sitio web del desarrollador. El parámetro forDeveloper se puede usar junto con parámetros de búsqueda opcionales, como el parámetro q.

    En el caso de esta función, cada video que se sube se etiqueta automáticamente con el número de proyecto asociado a la aplicación del desarrollador en Google Developers Console.

    Cuando una solicitud de búsqueda establece posteriormente el parámetro forDeveloper en true, el servidor de la API usa las credenciales de autorización de la solicitud para identificar al desarrollador. Por lo tanto, un desarrollador puede restringir los resultados a los videos subidos mediante su app o sitio web, pero no a videos subidos mediante otras apps o sitios.

    La nueva función ofrece una funcionalidad similar, aunque no idéntica, a la funcionalidad de las etiquetas de desarrollador que admitía la API v2.

  • La nueva propiedad snippet.country del recurso channel permite que los propietarios de canales asocien sus canales con un país en particular.

    Nota: Si quieres configurar la propiedad snippet.country para un recurso channel, debes actualizar la propiedad brandingSettings.channel.country.

  • La API ahora admite la segmentación para recursos channelSection. La segmentación por sección del canal proporciona una forma de restringir la visibilidad de una sección de contenido para los usuarios que coincidan con criterios específicos.

    La API expone tres opciones de segmentación. Para que una sección de un canal sea visible, el usuario debe cumplir con todos los parámetros de configuración de segmentación.

    • targeting.languages[]: Es una lista de idiomas de aplicaciones de YouTube. Los usuarios que hayan elegido uno de esos idiomas podrán ver la sección del canal correspondiente.

    • targeting.regions[]: Es una lista de las regiones de contenido preferidas de YouTube. La sección del canal es visible para los usuarios que hayan seleccionado una de esas regiones, así como los usuarios para los que una de esas regiones se selecciona automáticamente.

    • targeting.countries[]: Es una lista de los países en los que está visible la sección del canal. Cada valor de la lista es un código de país ISO 3166-1 alpha-2.

  • Se corrigió la definición de la propiedad contentDetails.duration del recurso video para reflejar que el valor puede reflejar horas, días, etcétera.

  • Se corrigió la documentación de los métodos channelSections.delete, playlistItems.delete, playlists.delete, subscriptions.delete y videos.delete para reflejar que, cuando se ejecutan correctamente, todos esos métodos muestran un código de respuesta HTTP 204 (No Content).

• Errores nuevos y actualizados

  • La API ahora admite los siguientes errores:

    Tipo de error	Detalle del error	Descripción
    badRequest (400)	targetInvalidCountry	Los métodos channelSections.insert y channelSections.update muestran este error si el recurso channelSection insertado contenía un valor no válido para la propiedad targeting.countries[].
    badRequest (400)	targetInvalidLanguage	Los métodos channelSections.insert y channelSections.update muestran este error si el recurso channelSection insertado contenía un valor no válido para la propiedad targeting.languages[].
    badRequest (400)	targetInvalidRegion	Los métodos channelSections.insert y channelSections.update muestran este error si el recurso channelSection insertado contenía un valor no válido para la propiedad targeting.regions[].
    badRequest (400)	operationNotSupported	El método comments.insert muestra este error si el usuario de la API no puede insertar un comentario en respuesta al comentario de nivel superior identificado por la propiedad snippet.parentId. En un recurso commentThread, la propiedad snippet.canReply indica si el visualizador actual puede responder a la conversación.
    badRequest (400)	invalidChannelId	El método search.list muestra este error si el parámetro channelId de la solicitud especificó un ID de canal no válido.
    badRequest (400)	subscriptionForbidden	El método subscriptions.insert muestra este error si el usuario de la API intenta suscribirse al propio canal del usuario.

  • El método captions.update ya no admite los errores invalidMetadata y videoNotFound.

16 de abril de 2015

Esta actualización incluye los siguientes cambios:

• La guía de migración se actualizó para explicar cómo migrar aplicaciones que aún usan la funcionalidad de comentarios de la API v2.

  En la guía, también se mencionan varias funciones de comentarios que la API v2 no admitía, pero que son compatibles con la API v3. Estos incluyen los siguientes:

  • Cómo recuperar comentarios sobre un canal
  • Recuperar todos los hilos de comentarios relacionados con un canal, lo que significa que la respuesta de la API puede contener comentarios acerca del canal o cualquiera de sus videos.
  • Cómo actualizar el texto de un comentario
  • Marcar un comentario como spam
  • Configurar el estado de moderación de un comentario

• Se actualizó la guía Cómo suscribirse a las notificaciones push para reflejar el hecho de que las notificaciones solo se envían al concentrador de Google PubSubHubBub y no al de Superfeedr, como se indicó anteriormente.

9 de abril de 2015

Esta actualización incluye los siguientes cambios:

• Los nuevos recursos commentThread y comment de la API te permiten recuperar, insertar, actualizar, borrar y moderar comentarios.

  • Un recurso commentThread contiene información sobre un hilo de comentarios de YouTube, que comprende un comentario de nivel superior y respuestas a ese comentario, si hubiera alguno. Un recurso commentThread puede representar comentarios sobre un video o un canal.

    El comentario de nivel superior y las respuestas son, en realidad, recursos comment anidados dentro del recurso commentThread. Es importante tener en cuenta que el recurso commentThread no necesariamente contiene todas las respuestas a un comentario y que debes usar el método comments.list si deseas recuperar todas las respuestas de un comentario en particular. Además, algunos comentarios no tienen respuestas.

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

    • commentThreads.list: Recupera una lista de hilos de comentarios. Utiliza este método para recuperar los comentarios asociados con un video o canal en particular.
    • commentThreads.insert: crea un nuevo comentario de nivel superior. (Usa el método comments.insert para responder un comentario existente).
    • commentThreads.update: Modifica un comentario de nivel superior.

  • Un recurso comment contiene información sobre un solo comentario de YouTube. Un recurso comment puede representar un comentario sobre un video o un canal. Además, el comentario puede ser de nivel superior o la respuesta a un comentario de nivel superior.

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

    • comments.list: Recupera una lista de comentarios. Utiliza este método para recuperar todas las respuestas a un comentario en particular.
    • comments.insert: crea una respuesta a un comentario existente.
    • comments.update: modificar un comentario.
    • comments.markAsSpam: marca uno o más comentarios como spam.
    • comments.setModerationStatus: establece el estado de moderación de uno o más comentarios. Por ejemplo, borra un comentario para que sea visible públicamente o rechaza un comentario como no apto para mostrarse. La solicitud a la API debe estar autorizada por el propietario del canal o del video asociado con los comentarios.
    • comments.delete: eliminar un comentario.

  Ten en cuenta que el nuevo alcance https://www.googleapis.com/auth/youtube.force-ssl de la API, descrito en el historial de revisión del 2 de abril de 2015, es obligatorio para las llamadas a los métodos comments.insert, comments.update, comments.markAsSpam, comments.setModerationStatus, comments.delete, commentThreads.insert y commentThreads.update.

• En la nueva guía Cómo suscribirse a las notificaciones push, se explica la nueva compatibilidad de la API para las notificaciones push a través de PubSubHubBub, un protocolo de publicación y suscripción de servidor a servidor para recursos accesibles desde la Web. Tu servidor de devolución de llamada de PubSubHubBub puede recibir notificaciones de feed de Atom cuando un canal realiza cualquiera de las siguientes actividades:

  • sube un video
  • actualiza el título de un video
  • actualiza la descripción de un video

• La guía de migración también se actualizó para indicar la nueva compatibilidad con las notificaciones push. Sin embargo, dado que la API v2 admite muchos otros tipos de notificaciones push que no son compatibles con la API v3, la mención de la compatibilidad con PubSubHubBub aún aparece en la sección Obsoleto de esa guía.

• El nuevo alcance https://www.googleapis.com/auth/youtube.force-ssl de la API ahora es un alcance válido para cualquier método de API que antes admitía el alcance https://www.googleapis.com/auth/youtube.

• La API ahora admite los siguientes errores:

  Tipo de error	Detalle del error	Descripción
  badRequest (400)	invalidRating	El método videos.rate muestra este error si la solicitud contiene un valor inesperado para el parámetro rating.

• El método subscriptions.insert ya no admite el error subscriptionLimitExceeded, que indicaba anteriormente que el suscriptor identificado con la solicitud había superado el límite de frecuencia de suscripción.

2 de abril de 2015

Esta actualización incluye los siguientes cambios:

• El nuevo recurso captions representa una pista de subtítulos de YouTube. Una pista de subtítulos se asocia con exactamente un video de YouTube.

  La API admite métodos para enumerar, insertar, actualizar, descargar y borrar pistas de subtítulos.

• La guía de migración también se actualizó para explicar cómo migrar aplicaciones que aún usan la funcionalidad de subtítulos en la API v2.

• El nuevo alcance https://www.googleapis.com/auth/youtube.force-ssl de la API requiere que la comunicación con el servidor de la API se realice a través de una conexión SSL.

  Este permiso nuevo otorga el mismo acceso que el permiso https://www.googleapis.com/auth/youtube. De hecho, esos dos alcances son funcionalmente idénticos porque el servidor de la API de YouTube solo está disponible a través de un extremo HTTPS. Como resultado, a pesar de que el alcance https://www.googleapis.com/auth/youtube no requiere una conexión SSL, no hay otra manera de realizar una solicitud a la API.

  El nuevo alcance es obligatorio para las llamadas a todos los métodos del recurso caption.

11 de marzo de 2015

Esta actualización incluye los siguientes cambios:

• La Guía de migración de la API de datos de YouTube (v3) contiene una nueva pestaña, llamada Nuevo en la API v3, en la que se enumeran las funciones que la API v3 admite y que la API v2 no admitía. Las mismas funciones estaban antes y siguen apareciendo en otras pestañas de la guía. Por ejemplo, la nueva función que explica cómo actualizar los datos de las campañas promocionales en video de un canal también aparece en la pestaña Canales (perfiles).

• Se actualizó la guía de migración de la API de YouTube Data (v3) para indicar que la API v3 será compatible con la siguiente función de la API v2:

  • Cómo marcar un video

• Se actualizó la guía de migración de la API de YouTube Data (v3) para indicar que las siguientes funciones de la API v2 no serán compatibles con la API v3:

  • Recuperar recomendaciones de video: la API v3 no recupera una lista que solo contiene videos recomendados para el usuario actual de la API. Sin embargo, puedes usar la API v3 para encontrar videos recomendados llamando al método activities.list y configurando el valor del parámetro home en true.

    En la respuesta de la API, un recurso corresponde a un video recomendado si el valor de la propiedad snippet.type es recommendation. En ese caso, las propiedades contentDetails.recommendation.reason y contentDetails.recommendation.seedResourceId contendrán información sobre por qué se recomendó el video. Ten en cuenta que no hay garantía de que la respuesta contenga una cantidad particular de videos recomendados.

  • Cómo recuperar las sugerencias de canales

  • Recuperar nuevos videos de suscripción: la API v3 no recupera una lista que solo contiene los videos que se subieron recientemente a los canales a los que el usuario de la API está suscrito. Sin embargo, puedes usar la API v3 para buscar nuevos videos de suscripción llamando al método activities.list y configurando el valor del parámetro home en true.

    En la respuesta de la API, un recurso corresponde a un nuevo video de suscripción si el valor de la propiedad snippet.type es upload. Ten en cuenta que no hay garantía de que la respuesta contenga un número particular de nuevos videos de suscripción.

  • Compatibilidad con feeds RSS

  • Notificaciones push sobre actualizaciones de feed: La API v2 admite notificaciones push, ya sea mediante Simple Update Protocol (SUP) o PubSubHubbub, para supervisar los feeds de actividad de los usuarios de YouTube. Se proporcionaron notificaciones para las nuevas suscripciones a canales y para cuándo se calificaron, compartieron, marcaron como favoritos, hicieron comentarios o subieron los videos.

    La API v3 admitirá notificaciones push con el protocolo PubSubHubbub, pero las notificaciones solo cubrirán las cargas y actualizaciones de títulos o descripciones de videos.

  • Ubicación del canal: La API v2 usó la etiqueta <yt:location> para identificar la ubicación del usuario tal como se ingresó en el perfil público de YouTube del canal. Si bien algunos desarrolladores usaban este campo para asociar un canal con un país en particular, los datos del campo no se pudieron usar de forma coherente para ese propósito.

  • Configurar o recuperar etiquetas del desarrollador: La API v2 admitía la capacidad de asociar palabras clave (o etiquetas de desarrollador) con un video en el momento en que se subió el video. Las etiquetas del programador no se muestran a los usuarios de YouTube, pero los propietarios de los videos pueden recuperar los videos que coincidan con una etiqueta del desarrollador específica.

    La API v3 proporcionará una función similar, pero no idéntica. Específicamente, el desarrollador podrá buscar videos subidos por su propia aplicación. En el caso de esta función, cada video que se sube se etiqueta automáticamente con el número de proyecto asociado a la aplicación del desarrollador en Google Developers Console. El desarrollador usa el mismo número de proyecto para buscar videos.

  • Enumerar videos por fecha de publicación, recuento de vistas o calificación: En la API v2, el parámetro orderby te permite ordenar los videos de una playlist por posición, duración, fecha de publicación, título y muchos otros valores. En la API v3, los elementos de la lista de reproducción generalmente se ordenan por posición, en orden ascendente y otras opciones de orden no están disponibles.

    Existen algunas excepciones. Una carga nueva, un video favorito, un video que te gustó o un video visto recientemente se agrega automáticamente como el primer elemento (snippet.position=0) para los siguientes tipos de playlists. Por lo tanto, cada una de estas listas se ordena eficazmente por el elemento más nuevo al más antiguo en función de la cantidad de elementos que se agregaron a la lista.

    • cargas de usuarios
    • videos favoritos
    • videos con Me gusta
    • historial de reproducciones

    Sin embargo, ten en cuenta que se agregó un nuevo elemento a la lista La playlist se agrega como el último elemento de esa lista, de manera que la lista se ordena eficazmente desde el elemento más antiguo hasta el más reciente.

  • Procesamiento por lotes: La API v3 admite uno de los casos de uso de procesamiento por lotes que admitía la API v2. Los métodos channels.list, channelSections.list, guideCategories.list, playlistItems.list, playlists.list, subscriptions.list, videoCategories.list y videos.list de la API v3 admiten un parámetro id, que se puede usar para especificar una lista de IDs delimitados por comas (ID de video, IDs de canales, etc.). Con estos métodos, puedes recuperar una lista de varios recursos con una sola solicitud.

  Con estos cambios, la guía ahora identifica todas las funcionalidades admitidas en la API anterior (v2) que quedarán obsoletas en la versión actual de la API (v3).

4 de marzo de 2015

Esta actualización incluye los siguientes cambios:

• Los métodos channelSections.delete y channelSections.update ahora admiten el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos.

• Las siguientes propiedades y sus propiedades secundarias dejaron de estar disponibles:

  • brandingSettings.image.backgroundImageUrl
  • brandingSettings.image.largeBrandedBannerImageImapScript
  • brandingSettings.image.largeBrandedBannerImageUrl
  • brandingSettings.image.smallBrandedBannerImageImapScript
  • brandingSettings.image.smallBrandedBannerImageUrl

  Nota: Ninguna de estas propiedades estaba sujeta a la política de baja de la API.

• La nueva propiedad contentDetails.contentRating.contentDetails.contentRating.djctqRatingReasons del recurso video identifica los motivos por los que el video recibió su calificación de DJCQT (Brasil).

• La API ahora admite los siguientes errores:

  Tipo de error	Detalle del error	Descripción
  notFound (404)	channelNotFound	El método channels.update muestra este error si el parámetro id de la solicitud especifica un canal que no se puede encontrar.
  badRequest (400)	manualSortRequiredinvalidValue	Los métodos playlistItems.insert y playlistItems.update muestran este error si la solicitud intenta establecer la posición del elemento de la playlist, pero la playlist no usa el orden manual. Por ejemplo, los elementos de una playlist pueden ordenarse por fecha o popularidad. Para abordar este error, quita el elemento snippet.position del recurso que se envió en el cuerpo de la solicitud. Si quieres que el elemento de la playlist tenga una posición específica en la lista, primero tendrás que actualizar la configuración de orden de la playlist a Manual. Esta configuración se puede ajustar en el Administrador de videos de YouTube.
  forbidden (403)	channelClosed	El método playlists.list muestra este error si el parámetro channelId de la solicitud especifica un canal que se cerró.
  forbidden (403)	channelSuspended	El método playlists.list muestra este error si el parámetro channelId de la solicitud especifica un canal que se suspendió.
  forbidden (403)	playlistForbidden	El método playlists.list muestra este error si el parámetro id de la solicitud no la admite o si esta no está autorizada correctamente.
  notFound (404)	channelNotFound	El método playlists.list muestra este error si el parámetro channelId de la solicitud especifica un canal que no se puede encontrar.
  notFound (404)	playlistNotFound	El método playlists.list muestra este error si el parámetro id de la solicitud especifica una playlist que no se puede encontrar.
  notFound (404)	videoNotFound	El método videos.list muestra este error si el parámetro id de la solicitud especifica un video que no se puede encontrar.
  badRequest (400)	invalidRating	El método videos.rate muestra este error si la solicitud contiene un valor inesperado para el parámetro rating.

2 de marzo de 2015

Esta actualización incluye los siguientes cambios:

• El método search.list ahora admite el parámetro relevanceLanguage, que te permite solicitar los resultados más relevantes para un idioma en particular.

  También actualizamos la Guía de migración de la API de datos de YouTube (v3) para explicar cómo utilizar este parámetro nuevo. El parámetro soluciona una brecha de funciones que existía anteriormente entre la versión actual de la API (v3) y la versión anterior (v2), que ya dejó de estar disponible.

• También actualizamos la guía de migración de la API de datos de YouTube (v3) para indicar la baja de los feeds especiales y campos de metadatos que la API v2 proporcionaba para describir películas, avances, programas de televisión, temporadas de televisión y episodios de televisión.

14 de enero de 2015

Esta actualización incluye los siguientes cambios:

• Se actualizó la Guía de migración de la API de datos de YouTube (v3) para explicar cómo utilizar la API v3 para subir videos con JavaScript. Consulta la sección Subir un video para obtener más información. Esta funcionalidad es comparable con la funcionalidad de carga basada en el navegador que admite la API v2. Ten en cuenta que este cambio en la guía de migración no refleja un cambio real en la API, sino la disponibilidad de un nuevo código de muestra para subir videos con JavaScript del cliente.

  Dada la compatibilidad para subir videos con la biblioteca cliente de JavaScript y CORS, la guía de migración ya no enumera la carga basada en el navegador como una función que puede dejar de estar disponible en la API v3.

• Se actualizó la documentación del método videos.insert para incluir la nueva muestra de código JavaScript descrita anteriormente. También actualizamos la lista de muestras de código JavaScript para la API de datos de YouTube (v3).

11 de noviembre de 2014

Esta actualización incluye los siguientes cambios:

• El costo de la cuota para una llamada al método search.list cambió a 100 unidades.

  Importante: En muchos casos, puedes usar otros métodos de API para recuperar información con una cuota menor. Por ejemplo, considera estas dos formas de encontrar los videos que se subieron al canal GoogleDevelopers.

  • Costo de la cuota: 100 unidades

    Llama al método search.list y busca GoogleDevelopers.

  • Costo de cuota: 6 unidades

    Llama al método channels.list para encontrar el ID del canal correcto. Establece el parámetro forUsername en GoogleDevelopers y el parámetro part en contentDetails. En la respuesta de la API, la propiedad contentDetails.relatedPlaylists.uploads especifica el ID de la playlist de los videos subidos del canal.

    Luego, llama al método playlistItems.list y establece el parámetro playlistId en el ID capturado y el parámetro part en snippet.

8 de octubre de 2014

Esta actualización incluye los siguientes cambios:

• El recurso channel contiene dos propiedades nuevas:

  • La propiedad status.longUploadsStatus indica si el canal es apto para subir videos que duran más de 15 minutos. Esta propiedad solo se devuelve si el propietario del canal autorizó la solicitud a la API. Los valores de propiedad válidos son los siguientes:

    • allowed: el canal puede subir videos de más de 15 minutos de duración.
    • eligible: el canal es apto para subir videos de más de 15 minutos de duración, pero primero debe habilitar la función.
    • disallowed: el canal no puede subir videos de más de 15 minutos de duración, o no es apto para subir videos.

    Consulta la definición de propiedad para obtener más información sobre estos valores. El Centro de ayuda de YouTube también proporciona información más detallada sobre esta función.

  • La propiedad invideoPromotion.useSmartTiming indica si la campaña promocional del canal utiliza "tiempo inteligente". Esta función intenta mostrar las promociones en un momento del video en el que es más probable que los usuarios hagan clic en ellas y que interrumpan la experiencia de visualización. Esta función también permite seleccionar una sola promoción para que se muestre en cada video.

• Se actualizaron las definiciones de las propiedades snippet.title y snippet.categoryId del recurso video para aclarar la forma en que la API maneja las llamadas al método videos.update. Si llamas a ese método para actualizar la parte snippet de un recurso video, debes establecer un valor para ambas propiedades.

  Si intentas actualizar la parte snippet de un recurso video y no estableces un valor para ambas propiedades, la API mostrará un error invalidRequest. También se actualizó la descripción del error.

• La propiedad contentDetails.contentRating.oflcRating del recurso video, que identifica la calificación de un video según la Oficina de Clasificación de Películas y Literatura de Nueva Zelanda, ahora admite dos nuevas calificaciones: oflcRp13 y oflcRp16. Estas corresponden a las calificaciones RP13 y RP16, respectivamente.

• El método channelBanners.insert ahora admite el siguiente error:

  Tipo de error	Detalle del error	Descripción
  badRequest	bannerAlbumFull	El álbum del diseño del canal de YouTube del propietario del canal tiene demasiadas imágenes. El propietario del canal debe ir a http://photos.google.com, navegar a la página de los álbumes y quitar algunas imágenes de ese álbum.

12 de septiembre de 2014

Esta actualización incluye los siguientes cambios:

• El costo de la cuota para una llamada al método search.list cambió de 1 unidad a 2 unidades, además del costo de las partes de recursos especificadas.

13 de agosto de 2014

Esta actualización incluye los siguientes cambios:

• El método subscriptions.insert ahora admite el siguiente error:

  Tipo de error	Detalle del error	Descripción
  badRequest	subscriptionLimitExceeded	El suscriptor identificado con la solicitud superó el límite de frecuencia de suscripción. Es posible que se realicen más intentos de suscripciones en unas horas.

12 de agosto de 2014

Esta actualización incluye los siguientes cambios:

• Una nueva guía, titulada Cómo migrar tu aplicación a la API de YouTube Data (v3), explica cómo utilizar la API de YouTube Data (v3) para realizar la funcionalidad disponible en la API de YouTube Data (v2). La API anterior dejó de estar disponible de manera oficial el 4 de marzo de 2014. El objetivo de esta guía es ayudarte a migrar las aplicaciones que aún usan la API v2 a la versión más reciente de la API.

8 de julio de 2014

Esta actualización incluye los siguientes cambios:

• El método playlists.insert ahora admite el siguiente error:

  Tipo de error	Detalle del error	Descripción
  badRequest	maxPlaylistExceeded	Este error ocurre si no se puede crear una playlist porque el canal ya tiene el número máximo permitido de playlists.

18 de junio de 2014

Esta actualización incluye los siguientes cambios:

• La descripción de cada método de API se actualizó para incluir el costo de cuota en el que se incurre una llamada a ese método. De manera similar, las definiciones de los parámetros part se actualizaron para especificar el costo de cuota de cada parte que se puede recuperar en una llamada a la API. Por ejemplo, una llamada al método subscriptions.insert tiene un costo de cuota de aproximadamente 50 unidades. El recurso subscription también contiene tres partes (snippet, contentDetails y subscriberSnippet), y cada una de ellas tiene un costo de dos unidades.

  Recuerda que los costos de cuota pueden cambiar sin previo aviso.

• El recurso video ahora admite 43 nuevos sistemas de clasificación de contenido, que identifican las clasificaciones que los videos recibieron de varias agencias nacionales de clasificación.

28 de mayo de 2014

Esta actualización incluye los siguientes cambios:

• El método search.list ahora admite los parámetros location y locationRadius, que te permiten buscar videos asociados con una ubicación geográfica. Una solicitud debe especificar un valor para ambos parámetros a fin de recuperar resultados según la ubicación. La API mostrará un error si la solicitud incluye solo uno de los dos parámetros.

  • El parámetro location especifica las coordenadas de latitud y longitud en el centro del área geográfica circular.

  • El parámetro locationRadius especifica la distancia máxima que puede tener la ubicación asociada con un video desde el centro del área para que el video aún se incluya en los resultados de la búsqueda.

13 de mayo de 2014

Esta actualización incluye los siguientes cambios:

• Se actualizó la propiedad invideoPromotion.items[] del recurso channel para indicar que, por lo general, solo puedes configurar un elemento promocionado para tu canal. Si intentas insertar demasiados elementos promocionados, la API mostrará un error tooManyPromotedItems, que tiene un código de estado HTTP 400.

• El recurso channelSection ahora puede contener información sobre algunos nuevos tipos de contenido destacado. La propiedad snippet.type del recurso channelSection ahora admite los siguientes valores:

  • postedPlaylists: playlists que publicó el propietario del canal en el feed de actividad del canal
  • postedVideos: videos que publicó el propietario del canal en el feed de actividad del canal
  • subscriptions: canales a los que se suscribió el propietario del canal

• La nueva propiedad contentDetails.contentRating.ifcoRating del recurso video identifica la clasificación que recibió un video de la Oficina de Clasificación de Películas de Irlanda.

• Se actualizó la definición de la propiedad position.cornerPosition del recurso watermark para indicar que la marca de agua siempre aparece en la esquina superior derecha del reproductor.

• Se actualizó la definición del parámetro q para el método search.list a fin de indicar que el término de búsqueda puede usar el operador booleano NOT (-) para excluir los videos asociados con un término de búsqueda específico. El valor también puede usar el operador booleano O (|) para buscar videos asociados con uno de varios términos de búsqueda.

• Se actualizó la definición de la propiedad pageInfo.totalResults que se muestra en una respuesta de la API a una llamada a search.list para indicar que el valor es una aproximación y es posible que no represente un valor exacto. Además, el valor máximo es 1,000,000. No debes utilizar este valor para crear vínculos de paginación. En su lugar, usa los valores de propiedad nextPageToken y prevPageToken para determinar si se muestran los vínculos de paginación.

• Se actualizaron los métodos watermarks.set y watermarks.unset para reflejar que la API muestra un código de respuesta HTTP 204 para las solicitudes exitosas a esos métodos.

2 de mayo de 2014

Esta actualización incluye los siguientes cambios:

• El nuevo recurso i18nLanguage identifica un lenguaje de aplicación compatible con el sitio web de YouTube. El lenguaje de la aplicación también puede denominarse lenguaje de IU. Para el sitio web de YouTube, el idioma de una aplicación se podría seleccionar automáticamente en función de la configuración de la cuenta de Google, el idioma del navegador o la ubicación de IP, y el usuario también podría seleccionar manualmente el idioma de la interfaz de usuario deseado en el pie de página del sitio de YouTube.

  La API admite un método para enumerar los idiomas de la aplicación admitidos. Los idiomas admitidos se pueden usar como el valor del parámetro hl cuando se llama a métodos de API como videoCategories.list y guideCategories.list.

• El nuevo recurso i18nRegion identifica un área geográfica que un usuario de YouTube puede seleccionar como región de contenido preferida. La región de contenido también puede denominarse configuración regional de contenido. Para el sitio web de YouTube, se podría seleccionar automáticamente una región de contenido en función de heurísticas, como el dominio de YouTube o la ubicación IP del usuario, y un usuario también podría seleccionar manualmente la región de contenido deseada en el pie de página del sitio de YouTube.

  La API admite un método para enumerar las regiones de contenido admitidas. Los códigos regionales admitidos se pueden usar como el valor del parámetro regionCode cuando se llama a métodos de la API, como search.list, videos.list, activities.list y videoCategories.list.

7 de abril de 2014

Esta actualización incluye los siguientes cambios:

• El nuevo recurso channelSection contiene información sobre un conjunto de videos que un canal decidió destacar. Por ejemplo, una sección puede mostrar las cargas más recientes de un canal, los más populares o los videos de una o más playlists.

  La API admite métodos para enumerar, insertar, actualizar o borrar secciones de un canal. Para recuperar una lista de secciones del canal del usuario autenticado, puedes especificar un ID de canal en particular o una lista de ID de sección de canal únicos.

  La documentación sobre errores también se actualizó para describir los mensajes de error que la API admite específicamente para estos nuevos métodos.

• Se actualizó la definición del objeto fileDetails del recurso video para explicar que ese objeto solo se mostrará si la propiedad processingDetails.fileDetailsAvailability del video tiene un valor de available.

  De manera similar, se actualizó la definición del objeto suggestions del recurso video para explicar que ese objeto solo se mostrará si la propiedad processingDetails.tagSuggestionsAvailability del video o su propiedad processingDetails.editorSuggestionsAvailability tienen un valor de available.

• Se actualizó la documentación de los métodos videos.insert y videos.update para reflejar que se puede establecer la propiedad status.publishAt cuando se llama a esos métodos.

• Se actualizó la definición del objeto invideoPromotion del recurso channel para explicar que solo el propietario del canal puede recuperar el objeto.

• Se actualizó la lista de parámetros del método videos.rate para reflejar que ese método en realidad no admite el parámetro onBehalfOfContentOwner. Este fue un error de documentación, ya que las solicitudes videos.rate que configuran este parámetro muestran un error 500.

31 de marzo de 2014

Esta actualización incluye los siguientes cambios:

• La nueva propiedad status.publishAt del recurso video te permite especificar la fecha y hora en que se programó la publicación de un video privado. Esta propiedad solo se puede establecer si el estado de privacidad del video es private y si el video nunca se publicó. Esta nueva propiedad no está sujeta a la política de baja.

13 de marzo de 2014

Esta actualización incluye los siguientes cambios:

• La API ahora admite la parte contentOwnerDetails para los recursos channel. La nueva parte contiene datos del canal que son relevantes para los socios de YouTube vinculados al canal, como el ID del propietario del contenido vinculado al canal y la fecha y hora en que el propietario de contenido y el canal se vincularon. Ten en cuenta que esta nueva pieza no está sujeta a la política de baja.

• En la documentación, ahora se indica la longitud máxima de caracteres que se admite para las siguientes propiedades:

  Recurso	Propiedad	Longitud máxima
  channel	invideoPromotion.items[].customMessage	40 caracteres
  video	snippet.title	100 caracteres
  video	snippet.description	5,000 bytes
  video	snippet.tags	500 caracteres. Ten en cuenta que el valor de la propiedad es una lista y que las comas entre los elementos de la lista se tienen en cuenta para el límite.

• La propiedad brandingSettings.watch.featuredPlaylistId del recurso channel dejó de estar disponible. La API devolverá un error si intentas establecer su valor.

• Se agregaron las siguientes propiedades de recursos de video a la lista de valores que se pueden configurar cuando se inserta o se actualiza un video:

  • recordingDetails.locationDescription
  • recordingDetails.location.latitude
  • recordingDetails.location.longitude
  • recordingDetails.recordingDate

• La documentación sobre errores ahora especifica el código de respuesta HTTP para cada tipo de error.

• La API ahora admite los siguientes errores:

  Tipo de error	Detalle del error	Descripción
  badRequest (400)	invalidCriteria	El método channels.list muestra este error si la solicitud especifica parámetros de filtro que no se pueden usar en conjunto.
  badRequest (400)	channelTitleUpdateForbidden	El método channels.update muestra este error si intentas actualizar la parte brandingSettings de un canal y cambiar el valor de la propiedad brandingSettings.channel.title. (Ten en cuenta que la API no muestra el error si omites la propiedad).
  badRequest (400)	invalidRecentlyUploadedBy	El método channels.update muestra este error si la propiedad invideoPromotion.items[].id.recentlyUploadedBy especifica un ID de canal no válido.
  badRequest (400)	invalidTimingOffset	El método channels.update muestra este error si la parte invideoPromotion especifica un desplazamiento de tiempo no válido.
  badRequest (400)	tooManyPromotedItems	El método channels.update muestra este error si la parte invideoPromotion especifica una cantidad de elementos promocionadas mayor que la permitida.
  forbidden (403)	promotedVideoNotAllowed	El método channels.update muestra este error si la propiedad invideoPromotion.items[].id.videoId especifica un ID de video que no se puede encontrar o que no se puede usar como elemento promocionado.
  forbidden (403)	websiteLinkNotAllowed	El método channels.update muestra este error si la propiedad invideoPromotion.items[].id.websiteUrl especifica una URL no permitida.
  required (400)	requiredTimingType	El método channels.update muestra este error si una solicitud no especifica la configuración de sincronización predeterminada del momento en que YouTube debe mostrar un elemento promocionado.
  required (400)	requiredTiming	El método channels.update debe especificar un objeto invideoPromotion.items[].timing para cada elemento promocionado.
  required (400)	requiredWebsiteUrl	El método channels.update debe especificar una propiedad invideoPromotion.items[].id.websiteUrl para cada elemento promocionado.
  badRequest (400)	invalidPublishAt	El método videos.insert muestra este error si los metadatos de la solicitud especifican una hora de publicación programada no válida.

4 de marzo de 2014

Esta actualización incluye los siguientes cambios:

• La API de datos de YouTube (versión 3) ahora está sujeta a la Política de baja que se describe en las Condiciones del Servicio de las APIs de YouTube. Ten en cuenta que la página que enumera las APIs que están sujetas a la política de baja excluye específicamente algunas funciones de la API v3 de la política.

5 de diciembre de 2013

Esta actualización incluye los siguientes cambios:

• Se actualizó la documentación del método search.list para reflejar correctamente que no necesitas especificar un valor para exactamente un parámetro de filtro cuando envías una solicitud de búsqueda. En su lugar, puedes establecer un valor para cero parámetros de filtro o para un parámetro de filtro.

• Las definiciones de los parámetros del método search.list se actualizaron para tener en cuenta que debes establecer el valor del parámetro type en video si también especificas un valor para cualquiera de los siguientes parámetros:

  • eventType
  • videoCaption
  • videoCategoryId
  • videoDefinition
  • videoDimension
  • videoDuration
  • videoEmbeddable
  • videoLicense
  • videoSyndicated
  • videoType

• El tamaño mínimo de las imágenes del banner del canal subidas se redujo a 2048 px por 1152 px. (Antes, el tamaño mínimo era de 2,120 px por 1,192 px). Además, ten en cuenta que la documentación del recurso channel especifica los tamaños máximos de todas las imágenes de banner que se publican desde la API. Por ejemplo, el tamaño máximo de la imagen brandingSettings.image.bannerTvImageUrl para aplicaciones de televisión es de 2,120 px por 1,192 px, pero la imagen real puede ser de 2,048 px por 1,152 px. En el Centro de ayuda de YouTube encontrarás orientación adicional para optimizar el diseño del canal y mostrarlo en diferentes tipos de dispositivos.

• Se actualizaron varias definiciones de propiedades del recurso channel para reflejar la siguiente información:

  • El valor de la propiedad brandingSettings.channel.description tiene una longitud máxima de 1,000 caracteres.
  • La propiedad brandingSettings.channel.featuredChannelsTitle tiene una longitud máxima de 30 caracteres.
  • La propiedad brandingSettings.channel.featuredChannelsUrls[] ahora puede incluir hasta 100 canales.
  • Si se establece el valor de la propiedad brandingSettings.channel.unsubscribedTrailer, se debe especificar el ID de video de YouTube de un video público o no listado que pertenece al propietario del canal.

• El método channels.update ahora admite actualizaciones de la propiedad invideoPromotion.items[].promotedByContentOwner. Esa propiedad indica si se mostrará el nombre del propietario del contenido cuando se muestre la promoción. Solo se puede establecer si la solicitud a la API que establece el valor de la propiedad se realiza en nombre del propietario del contenido mediante el parámetro onBehalfOfContentOwner.

• Los métodos playlistItems.list y playlistItems.insert ahora admiten el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos.

• Ahora la propiedad contentDetails.contentRating.acbRating puede especificar una clasificación de la Australian Classification Board (ACB) para las películas o de la Australian Communications and Media Authority (ACMA) para la programación de televisión infantil.

• Las nuevas propiedades contentDetails.contentRating.catvRating y contentDetails.contentRating.catvfrRating identifican las clasificaciones que recibió un video según el sistema de clasificación de TV canadiense y el sistema de clasificación Régie du cinéma, en francés, que se usa en Quebec, respectivamente.

• La nueva propiedad snippet.assignable del recurso videoCategory indica si los videos actualizados o los que se subieron recientemente se pueden asociar con esa categoría.

• Se agregaron muestras de código para los siguientes métodos:

  • activities.insert (Ir)
  • channelBanners.insert (Python)
  • channels.update (Python)
  • playlistItems.list (Ir)
  • search.list (Ir)
  • thumbnails.set (Java)
  • videos.insert (Ir)

24 de octubre de 2013

Esta actualización incluye los siguientes cambios:

• La API incluye dos funciones adicionales diseñadas para ayudar a encontrar y presentar contenido de transmisiones en vivo:

  La nueva propiedad snippet.liveBroadcastContent en los resultados de la búsqueda indica si un recurso de video o canal tiene contenido de transmisión en vivo. Los valores de propiedad válidos son upcoming, active y none.

  • La nueva propiedad snippet.liveBroadcastContent del recurso video indica si el video es una transmisión en vivo futura o activa. En la siguiente lista, se explican los valores posibles de la propiedad:

    • upcoming: el video es una transmisión en vivo que todavía no comenzó.
    • active: el video es una transmisión en vivo en curso.
    • none: el video no es una transmisión en vivo futura ni activa. Este será el valor de la propiedad de las transmisiones finalizadas que aún se pueden ver en YouTube.

  • La nueva propiedad liveStreamingDetails del recurso video es un objeto que contiene metadatos sobre una transmisión de video en vivo. Para recuperar estos metadatos, incluye liveStreamingDetails en la lista de partes de recursos del valor del parámetro part. Los metadatos incluyen las siguientes propiedades nuevas:

    • liveStreamingDetails.actualStartTime: la hora a la que comenzó la transmisión. (Este valor estará presente una vez que el estado de la transmisión sea active).
    • liveStreamingDetails.actualEndTime: la hora a la que finalizó la transmisión. (Este valor estará presente una vez que la transmisión haya finalizado).
    • liveStreamingDetails.scheduledStartTime: la hora a la que está programada el inicio de la transmisión.
    • liveStreamingDetails.scheduledEndTime: hora a la que terminará la transmisión programada. Si el valor de la propiedad está vacío o la propiedad no está presente, se programa la transmisión para continuar indefinidamente.
    • liveStreamingDetails.concurrentViewers: la cantidad de personas que ven la transmisión en vivo.

    Para recuperar estos metadatos, incluye liveStreamingDetails en el valor del parámetro part cuando llames a los métodos videos.list, videos.insert o videos.update.

  Ten en cuenta que el 1 de octubre de 2013 se lanzaron otras dos funciones para identificar contenido de transmisiones en vivo: el parámetro eventType del método search.list y la propiedad snippet.liveBroadcastContent del resultado de la búsqueda.

• El método videos.insert ahora admite el parámetro notifySubscribers, que indica si YouTube debe enviar una notificación sobre el video nuevo a los usuarios que se suscriben al canal del video. El valor predeterminado del parámetro es True, lo que indica que los suscriptores recibirán una notificación sobre los videos subidos recientemente. Sin embargo, el propietario de un canal que sube muchos videos podría establecer el valor en False para evitar enviar una notificación sobre cada video nuevo a los suscriptores del canal.

• Se actualizó la lista de propiedades que se pueden modificar cuando se llama al método channels.update para incluir las propiedades invideoPromotion.items[].customMessage y invideoPromotion.items[].websiteUrl. Además, la lista se modificó para identificar las propiedades de brandingSettings que se pueden modificar. Estas propiedades de brandingSettings ya se pueden modificar, por lo que el cambio en la documentación no refleja un cambio en la funcionalidad existente de la API.

• Los métodos playlists.insert, playlists.update y playlists.delete ahora admiten el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos.

• El método playlists.insert ahora admite el parámetro onBehalfOfContentOwnerChannel, que ya es compatible con muchos otros métodos.

• La propiedad contentDetails.contentRating.tvpgRating del recurso video ahora admite un valor de pg14, que corresponde a una calificación TV-14.

• Se corrigió la definición de la propiedad snippet.liveBroadcastContent, que forma parte de los resultados de la búsqueda, para reflejar que live es un valor de propiedad válido, pero active no lo es.

• La propiedad contentDetails.contentRating.mibacRating del recurso video ahora admite dos calificaciones adicionales:

  • mibacVap (VAP): Los niños deben estar acompañados por un adulto.
  • mibacVm6 (V.M.6): Restringido para mayores de 6 años.
  • mibacVm12 (V.M.12): Restringido a mayores de 12 años.

• La nueva propiedad invideoPromotion.items[].promotedByContentOwner del recurso channel indica si se mostrará el nombre del propietario del contenido cuando se muestre la promoción. Este campo solo se puede establecer si la solicitud a la API que establece el valor se realiza en nombre del propietario del contenido. Consulta el parámetro onBehalfOfContentOwner para obtener más información.

1 de octubre de 2013

Esta actualización incluye los siguientes cambios:

• El nuevo objeto auditDetails del recurso channel contiene datos del canal que una red multicanal (MCN) evaluaría a la hora de determinar si aceptar o rechazar 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 alcance https://www.googleapis.com/auth/youtubepartner-channel-audit. Además, cualquier token que use ese alcance se debe revocar cuando la MCN decide aceptar o rechazar el canal, o en un plazo de dos semanas a partir de la fecha de emisión del token.

• La propiedad invideoPromotion.items[].id.type del recurso channel ahora admite un valor de recentUpload, que indica que el elemento promocionado es el video más reciente de un canal especificado.

  De forma predeterminada, el canal es el mismo para el que se configuran los datos de promoción en video. Sin embargo, puedes promocionar el video más reciente que se haya subido desde otro canal. Para ello, configura el valor de la nueva propiedad invideoPromotion.items[].id.recentlyUploadedBy con el ID de ese canal.

• El recurso channel contiene tres propiedades nuevas (brandingSettings.image.bannerTvLowImageUrl, brandingSettings.image.bannerTvMediumImageUrl y brandingSettings.image.bannerTvHighImageUrl) que especifican las URLs para las imágenes de banner que se muestran en los canales de usuario en aplicaciones de televisión.

• La nueva propiedad snippet.liveBroadcastContent en los resultados de la búsqueda indica si un recurso de video o canal tiene contenido de transmisión en vivo. Los valores de propiedad válidos son upcoming, active y none.

  • Para un recurso video, un valor de upcoming indica que el video es una transmisión en vivo que aún no comenzó, mientras que un valor de active indica que el video es una transmisión en vivo en curso.
  • Para un recurso channel, un valor de upcoming indica que el canal tiene una transmisión programada que aún no comenzó, mientras que un valor de acive indica que el canal tiene una transmisión en vivo en curso.

• En el recurso watermark, la propiedad targetChannelId cambió de un objeto a una cadena. En lugar de contener una propiedad secundaria que especifica el ID del canal de YouTube del canal al que está vinculada la imagen de marca de agua, la propiedad targetChannelId ahora especifica ese valor. Por lo tanto, se quitó la propiedad targetChannelId.value del recurso.

• El método thumbnails.set ahora admite el parámetro onBehalfOfContentOwner, que ya es compatible con muchos otros métodos.

• El método search.list ahora admite el parámetro eventType, que restringe una búsqueda para que solo muestre eventos de transmisión activos, próximos o completados.

• La nueva propiedad contentDetails.contentRating.mibacRating identifica la clasificación que recibió un video del Ministero dei Beni e delle Attivita Culturali e del Turismo de Italia.

• La API ahora admite los siguientes errores:

  Tipo de error	Detalle del error	Descripción
  badRequest	invalidImage	El método thumbnails.set muestra este error si el contenido de imagen proporcionado no es válido.
  forbidden	videoRatingDisabled	El método videos.rate devuelve este error si el propietario del video que se está calificando inhabilitó las calificaciones para ese video.

27 de agosto de 2013

Esta actualización incluye los siguientes cambios:

• El nuevo recurso watermark identifica una imagen que se muestra durante las reproducciones de videos de un canal específico. También puedes especificar un canal de destino al que vinculará la imagen, así como información de sincronización que determina cuándo aparece la marca de agua en las reproducciones de video y el período de tiempo que será visible.

  El método watermarks.set sube y establece la imagen de marca de agua de un canal. El método watermarks.unset borra la imagen de marca de agua de un canal.

  En la documentación de errores, se describen los mensajes de error que la API admite específicamente para los métodos watermarks.set y watermarks.unset.

• La nueva propiedad statistics.hiddenSubscriberCount del recurso channel contiene un valor booleano que indica si el número de suscriptores del canal está oculto. Por lo tanto, el valor de la propiedad es false si el recuento de suscriptores del canal es visible públicamente.

• El método playlists.list ahora admite los parámetros onBehalfOfContentOwner y onBehalfOfContentOwnerChannel. Ambos parámetros ya son compatibles con muchos otros métodos.

• El método videos.list ahora admite el parámetro regionCode, que identifica la región de contenido para la que se debe recuperar un gráfico. Este parámetro solo se puede usar junto con el parámetro chart. El valor del parámetro es un código de país ISO 3166-1 alpha-2.

• En error documentation, se describe el siguiente error de solicitud común nuevo, que podría ocurrir para varios métodos de la API:

  Tipo de error	Detalle del error	Descripción
  forbidden	insufficientPermissions	Los permisos asociados con el token de OAuth 2.0 que se proporcionó para la solicitud no son suficientes para acceder a los datos solicitados.

15 de agosto de 2013

Esta actualización incluye los siguientes cambios:

• El objeto invideoPromotion del recurso channel tiene las siguientes propiedades nuevas y actualizadas:

  • La API ahora admite la capacidad de especificar un sitio web como un elemento promocionado. Para ello, establece el valor de la propiedad invideoPromotion.items[].id.type en website y usa la nueva propiedad invideoPromotion.items[].id.websiteUrl para especificar la URL. Además, usa la nueva propiedad invideoPromotion.items[].customMessage para definir el mensaje personalizado que se mostrará para la promoción.

    Los vínculos pueden ser sitios web relacionados, sitios comerciales o sitios de redes sociales. Consulta las instrucciones del Centro de ayuda de YouTube para los sitios web asociados y los sitios de comercios para obtener más información sobre cómo habilitar vínculos para tu contenido.

    Si agrega vínculos promocionales, acepta que esos vínculos no se usarán para redireccionar el tráfico a sitios no autorizados y que estos cumplirán con las políticas de AdWords, las políticas de anuncios de YouTube, los Lineamientos de la Comunidad de YouTube y las Condiciones del Servicio de YouTube.

  • Se reestructuraron las propiedades relacionadas con la configuración de sincronización para mostrar los elementos promocionados durante la reproducción de video:

    • Se movió el objeto invideoPromotion.timing a invideoPromotion.items[].timing. Este objeto ahora te permite personalizar los datos de sincronización de cada elemento promocionado en la lista de invideoPromotion.items[].

    • El nuevo objeto invideoPromotion.defaultTiming especifica la configuración de tiempos predeterminada de tu promoción. Esas opciones definen cuándo aparecerá un elemento promocionado durante la reproducción de uno de los videos de tu canal. Puedes anular la sincronización predeterminada de cualquier elemento promocionado a través del objeto invideoPromotion.items[].timing.

    • La nueva propiedad invideoPromotion.items[].timing.durationMs especifica la cantidad de tiempo, en milisegundos, que debe mostrarse la promoción. El objeto invideoPromotion.defaultTiming también contiene un campo durationMs que especifica la cantidad de tiempo predeterminada que se mostrará el elemento promocionado.

  • Las propiedades invideoPromotion.items[].type y invideoPromotion.items[].videoId se movieron al objeto invideoPromotion.items[].id.

• El método subscriptions.list ahora admite los parámetros onBehalfOfContentOwner y onBehalfOfContentOwnerChannel. Ambos parámetros ya son compatibles con muchos otros métodos.

• En la respuesta de la API a una solicitud thumbnails.set, el valor de la propiedad kind cambió de youtube#thumbnailListResponse a youtube#thumbnailSetResponse.

• Se agregaron muestras de código para los siguientes métodos:

  • channels.update (Java y Python)
  • playlists.insert (.NET y PHP)
  • subscriptions.insert (PHP, Python)
  • thumbnails.set (PHP, Python)
  • videos.insert (PHP)
  • videos.list (PHP)
  • videos.rate (Python)
  • videos.update (Java, PHP y Python)

  Ten en cuenta que también se quitó el ejemplo de Python para el método playlistItems.insert, ya que la funcionalidad que demostró ahora se controla con el método videos.rate.

• error documentation describe el siguiente error de contexto de solicitud nuevo, que podría ocurrir con cualquier método de API que admita el parámetro de solicitud mine:

  Tipo de error	Detalle del error	Descripción
  badRequest	invalidMine	No se puede utilizar el parámetro mine en solicitudes en las que el usuario autenticado es un socio de YouTube. Debes quitar el parámetro mine, autenticarte como usuario de YouTube quitando el parámetro onBehalfOfContentOwner o actuar como uno de los canales del socio proporcionando el parámetro onBehalfOfContentOwnerChannel, si está disponible para el método al que se llama.

8 de agosto de 2013

Esta actualización incluye los siguientes cambios:

• La sección Uso de la cuota de la guía Cómo empezar a utilizar la API de datos de YouTube se ha actualizado para reflejar un cambio en el costo de cuota de subida de un video de 16,000 unidades a 1600 unidades aproximadamente.

30 de julio de 2013

Esta actualización incluye los siguientes cambios:

• En un recurso channelBanner, el valor del valor de la propiedad kind cambió de youtube#channelBannerInsertResponse a youtube#channelBannerResource. Este recurso se muestra en respuesta a una solicitud channelBanners.insert.

• La nueva propiedad brandingSettings.channel.profileColor del recurso channel especifica un color destacado que complementa el contenido del canal. El valor de la propiedad es un signo numeral (#) seguido de una cadena hexadecimal de seis caracteres, como #2793e6.

• La API ahora admite la capacidad de especificar si una suscripción es para todas las actividades de un canal o solo para nuevas subidas. La nueva propiedad contentDetails.activityType del recurso subscription identifica los tipos de actividades de las que se notificará al suscriptor. Los valores de propiedad válidos son all y uploads.

• El método videos.list admite parámetros nuevos para recuperar un gráfico de los videos más populares en YouTube:

  • El parámetro chart identifica el gráfico que deseas recuperar. Por el momento, el único valor admitido es mostPopular. Ten en cuenta que el parámetro chart es un parámetro de filtro, lo que significa que no se puede usar en la misma solicitud que otros parámetros de filtro (id y myRating).
  • El parámetro videoCategoryId identifica la categoría de video para la que se debe recuperar el gráfico. Este parámetro solo se puede usar junto con el parámetro chart. De forma predeterminada, los gráficos no se restringen a una categoría en particular.

• La nueva propiedad topicDetails.relevantTopicIds[] del recurso video proporciona una lista de ID de temas de Freebase que son relevantes para el video o su contenido. Es posible que los temas de estos temas se mencionen o aparezcan en el video.

• Se cambió el nombre de la propiedad recordingDetails.location.elevation del recurso video a recordingDetails.location.altitude y el nombre de su propiedad fileDetails.recordingLocation.location.elevation a fileDetails.recordingLocation.location.altitude.

• El objeto contentDetails.contentRating del recurso video especifica las calificaciones que recibió un video en función de diversos esquemas de calificación, como las clasificaciones de la MPAA y de la TVPG, entre otras. Para cada sistema de calificación, la API ahora admite un valor de calificación que indica que el video no se calificó. Ten en cuenta que, en el caso de las clasificaciones de la MPAA, se incluirá una columna calificación se utiliza con frecuencia para identificar las versiones sin cortes de las películas para las cuales la versión editada de la película sí recibió una clasificación oficial.

• La nueva propiedad contentDetails.contentRating.ytRating del recurso video identifica el contenido con restricción de edad. El valor de la propiedad será ytAgeRestricted si YouTube identifica que el video incluye contenido inapropiado para usuarios menores de 18 años. Si la propiedad está ausente o si el valor de la propiedad está vacío, entonces el contenido no se identificó como restricción de edad.

• El parámetro mySubscribers del método channels.list dejó de estar disponible. Usa el método subscriptions.list y su parámetro mySubscribers para recuperar una lista de los suscriptores al canal del usuario autenticado.

• Los métodos channelBanners.insert, channels.update, videos.getRating y videos.rate ahora admiten el parámetro onBehalfOfContentOwner. Ese parámetro indica que el usuario autenticado actúa en nombre del propietario del contenido especificado en el valor del parámetro.

• Se actualizó la documentación del método channels.update para reflejar el hecho de que ese método se puede usar para actualizar el objeto brandingSettings del recurso channel y sus propiedades secundarias. En la documentación, ahora también se muestra la lista actualizada de propiedades que puedes configurar para el objeto invideoPromotion del recurso channel.

• En error documentation, se describen los siguientes errores nuevos:

  Tipo de error	Detalle del error	Descripción
  forbidden	accountDelegationForbidden	Este error no es específico de un método de API en particular. Indica que el usuario autenticado no está autorizado para actuar en nombre de la Cuenta de Google especificada.
  forbidden	authenticatedUserAccountClosed	Este error no es específico de un método de API en particular. Indica que la cuenta de YouTube del usuario autenticado está cerrada. Si el usuario actúa en nombre de otra Cuenta de Google, este error indicará que la otra cuenta está cerrada.
  forbidden	authenticatedUserAccountSuspended	Este error no es específico de un método de API en particular. Indica que la cuenta de YouTube del usuario autenticado está suspendida. Si el usuario actúa en nombre de otra Cuenta de Google, este error indicará que la otra cuenta está suspendida.
  forbidden	authenticatedUserNotChannel	Este error no es específico de un método de API en particular. Indica que el servidor de la API no puede identificar el canal asociado con la solicitud a la API. Si la solicitud está autorizada y usa el parámetro onBehalfOfContentOwner, también debes establecer el parámetro onBehalfOfContentOwnerChannel.
  forbidden	cmsUserAccountNotFound	Este error no es específico de un método de API en particular. No se permite al usuario de CMS actuar en nombre del propietario de contenido especificado.
  notFound	contentOwnerAccountNotFound	Este error no es específico de un método de API en particular. No se encontró la cuenta del propietario del contenido especificada.
  badRequest	invalidPart	Este error no es específico de un método de API en particular. El parámetro part de la solicitud especifica las partes que no se pueden escribir al mismo tiempo.
  badRequest	videoChartNotFound	El método videos.list muestra este error cuando la solicitud especifica un gráfico de videos no compatible o no disponible.
  notFound	videoNotFound	El método videos.update muestra este error para indicar que no se puede encontrar el video que intentas actualizar. Comprueba el valor de la propiedad id en el cuerpo de la solicitud para asegurarte de que sea correcto.

10 de junio de 2013

Esta actualización incluye los siguientes cambios:

• El nuevo parámetro forUsername del método channels.list te permite recuperar información sobre un canal mediante la especificación del nombre de usuario de YouTube.

• El método activities.list ahora admite el parámetro regionCode, que le indica a la API que muestre resultados relevantes para el país especificado. YouTube utiliza este valor cuando la actividad anterior del usuario autorizado en YouTube no proporciona suficiente información para generar el feed de actividad.

• Los recursos de playlist ahora contienen la propiedad snippet.tags. La propiedad solo se devolverá a los usuarios autorizados que recuperen datos sobre sus propias playlists. Los usuarios autorizados también pueden configurar etiquetas de playlists cuando llaman a los métodos playlists.insert o playlists.update.

• El parámetro onBehalfOfContentOwner, que antes era compatible con los métodos channels.list y search.list, ahora también es compatible con los métodos videos.insert, videos.update y videos.delete. Ten en cuenta que, cuando se usa este parámetro en una llamada al método videos.insert, la solicitud también debe especificar un valor para el nuevo parámetro onBehalfOfContentOwnerChannel, que identifica el canal al que se agregará el video. El canal debe estar vinculado al propietario del contenido que especifica el parámetro onBehalfOfContentOwner.

  El parámetro indica que las credenciales de autorización de la solicitud identifican a un usuario del CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado.

  Este parámetro está dirigido a socios de contenido que poseen y administran muchos canales de YouTube diferentes. El parámetro les permite a esos socios autenticarse una vez y obtener acceso a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal.

  Específicamente en relación con esta versión, el parámetro ahora permite que un socio de contenido inserte, actualice o borre videos en cualquiera de los canales de YouTube que le pertenecen.

• En error documentation, se describen los siguientes errores nuevos:

  Tipo de error	Detalle del error	Descripción
  forbidden	insufficientCapabilities	Este error no es específico de un método de API en particular. Indica que el usuario del CMS que llama a la API no tiene permisos suficientes para realizar la operación solicitada. Este error está asociado con el uso del parámetro onBehalfOfContentOwner, que es compatible con varios métodos de API.
  unauthorized	authorizationRequired	El método activities.list muestra este error cuando la solicitud usa el parámetro home, pero no está debidamente autorizado.

• En el recurso channels, se quitó la propiedad invideoPromotion.channelId porque el ID del canal ya se especificó con la propiedad id del recurso.

• La nueva guía Cómo trabajar con los IDs de canal explica cómo la API usa los IDs de canal. La guía puede ser especialmente útil para los desarrolladores que migran desde la versión anterior de la API y quienes tienen aplicaciones que solicitan contenido para el usuario de default o que se basan en la noción de que cada canal de YouTube tiene un nombre de usuario único, que ya no es así.

22 de mayo de 2013

Esta actualización incluye los siguientes cambios:

• El nuevo método channelBanners.insert te permite subir una imagen de banner que luego puede establecerse como la imagen de banner para un canal a través de la nueva propiedad brandingSettings.image.bannerExternalUrl del recurso channel.

• Se actualizó la documentación del método channels.update para enumerar las propiedades que se pueden modificar cuando se llama al método.

• La documentación del recurso video ya no muestra unspecified como un valor de propiedad válido para las propiedades suggestions.processingErrors[], suggestions.processingHints[], suggestions.processingWarnings[] y suggestions.editorSuggestions[].

• El parámetro maxResults del método videos.list ahora tiene un valor predeterminado de 5.

• Ahora, error documentation enumera los errores de los métodos channelBanners.insert y subscriptions.list. También se enumeran varios errores nuevos para el método channels.update.

14 de mayo de 2013

Esta actualización incluye los siguientes cambios:

• Las páginas independientes ahora incluyen muestras de código para Java, .NET, PHP y Ruby.

• La página que enumera las muestras de código de Python ahora incluye ejemplos para agregar una suscripción, crear una playlist y actualizar un video.

10 de mayo de 2013

Esta actualización incluye los siguientes cambios:

• YouTube ya no identifica elementos y servicios experimentales de la API. En cambio, ahora se ofrece una lista de las API de YouTube que están sujetas a la política de baja.

8 de mayo de 2013

Esta actualización incluye los siguientes cambios:

• Los recursos de canal ahora admiten el objeto inVideoPromotion, que encapsula información sobre una campaña promocional asociada al canal. Un canal puede utilizar una campaña promocional en video para mostrar imágenes en miniatura de un video promocionado dentro del reproductor de video durante las reproducciones de videos del canal.

  Para recuperar estos datos, incluye invideoPromotion en el valor del parámetro part en una solicitud channels.list.

• Se puede usar el nuevo método channels.update para actualizar los datos de las campañas promocionales en video de un canal. Ten en cuenta que el método solo admite actualizaciones en la parte invideoPromotion del recurso channel y aún no admite actualizaciones en otras partes de ese recurso.

2 de mayo de 2013

Esta actualización incluye los siguientes cambios:

• Los recursos del canal ahora admiten la propiedad status.isLinked, que 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.

• Los recursos de suscripción ahora admiten la parte subscriberSnippet. Ese objeto encapsula datos de fragmentos para el canal del suscriptor.

• La API ahora admite el método videos.getRating, que recupera las calificaciones que el usuario autenticado le dio a una lista de uno o más videos.

• El nuevo parámetro myRating del método videos.list te permite recuperar una lista de videos que el usuario autenticado calificó con like o dislike.

  Los parámetros myRating y id ahora se consideran parámetros de filtro, lo que significa que una solicitud a la API debe especificar exactamente uno de los parámetros. (Antes, el parámetro id era un parámetro obligatorio para este método).

  El método devuelve un error forbidden para las solicitudes que intentan recuperar información de clasificación de videos, pero no están debidamente autorizadas para hacerlo.

• Con la introducción del parámetro myRating, también se actualizó el método videos.list para admitir la paginación. Sin embargo, ten en cuenta que los parámetros de paginación solo se admiten para solicitudes que usan el parámetro myRating. (La información y los parámetros de Paging no son compatibles con las solicitudes que usan el parámetro id).

  • El parámetro maxResults especifica la cantidad máxima de videos que la API puede mostrar en el conjunto de resultados, y el parámetro pageToken identifica una página específica en el conjunto de resultados que deseas recuperar.

  • El recurso youtube#videoListResponse, que se muestra en respuesta a una solicitud videos.list, ahora contiene el objeto pageInfo, que contiene detalles como la cantidad total de resultados y la cantidad de resultados incluidos en el conjunto de resultados actual. El recurso youtube#videoListResponse también puede incluir propiedades nextPageToken y prevPageToken, cada una de las cuales proporciona un token que se podría usar para recuperar una página específica en el conjunto de resultados.

• El método videos.insert admite los siguientes parámetros nuevos:

  • autoLevels: establece este valor de parámetro en true para indicarle a YouTube que debe mejorar automáticamente la iluminación y el color del video.
  • stabilize: establece este valor de parámetro en true para indicarle a YouTube que ajuste el video eliminando los movimientos de la cámara.

• Se agregó la propiedad channelTitle a snippet para los siguientes recursos:

  • playlistItem: la propiedad especifica el nombre del canal que agregó el elemento de la playlist.
  • playlist: la propiedad especifica el nombre del canal que creó la playlist.
  • subscription: la propiedad especifica el nombre del canal al que te suscribiste.

• Se agregaron muestras de código para los siguientes métodos:

  • activities.insert (Ruby)
  • playlistItems.list (.NET)
  • search.list (.NET)
  • subscriptions.insert (Java y Ruby)
  • videos.insert (.NET y Ruby)

• El nuevo parámetro mySubscribers del método subscriptions.list te permite recuperar una lista de los suscriptores del usuario autenticado actualmente. Este parámetro solo se puede utilizar en una solicitud debidamente autorizada.

  Nota: Esta funcionalidad tiene como objetivo reemplazar el parámetro mySubscribers que se admite actualmente para el método channels.list. Ese parámetro dejará de estar disponible.

• En un recurso video, el valor de propiedad unspecified ya no es un valor posible para ninguna de las siguientes propiedades:

  • fileDetails.fileType
  • fileDetails.videoStreams[].rotation
  • processingDetails.processingStatus
  • processingDetails.processingFailureReason
  • fileDetails.fileType

• Las solicitudes a la API que contienen un parámetro inesperado ahora muestran un error badRequest, y el motivo informado para el error es unexpectedParameter.

• Se actualizó el error que muestra el método playlistItems.insert cuando la playlist ya contiene la cantidad máxima de elementos permitidos. Ahora se informa como un error forbidden y el motivo del error es playlistContainsMaximumNumberOfVideos.

19 de abril de 2013

Esta actualización incluye los siguientes cambios:

• El nuevo método videos.rate permite que un usuario establezca una calificación de like o dislike en un video, o que quite la calificación.

  También se actualizó la documentación sobre errores para enumerar los errores que la API podría mostrar en respuesta a una llamada al método videos.rate.

• Las imágenes en miniatura ahora se identifican en la documentación de la API como un recurso independiente, y el nuevo método thumbnails.set te permite subir una miniatura de video personalizada a YouTube y configurarla para un video.

  También se actualizó la documentación sobre errores para enumerar los errores que la API podría mostrar en respuesta a una llamada al método thumbnails.set.

  Ten en cuenta que este cambio en realidad no afecta a los recursos existentes que muestran imágenes en miniatura. Las imágenes en miniatura se muestran en esos recursos de la misma manera que antes, aunque, en la documentación, ahora se enumeran los nombres de los diferentes tamaños de miniaturas que la API puede mostrar.

• La nueva parte brandingSettings del recurso channel identifica la configuración, el texto y las imágenes para el canal de usuario y las páginas de reproducción de video del canal.

• El recurso playlistItem contiene las siguientes propiedades nuevas:

  • El nuevo objeto status encapsula la información de estado sobre el elemento de la playlist, y la propiedad status.privacyStatus identifica el estado de privacidad del elemento de la playlist.

• El recurso video contiene las siguientes propiedades nuevas:

  • La propiedad status.publicStatsViewable indica si las estadísticas extendidas del video en la página de reproducción son visibles públicamente. De forma predeterminada, esas estadísticas se pueden consultar, y otras estadísticas, como el recuento de reproducciones y las calificaciones de un video, seguirán siendo visibles públicamente, incluso si el valor de esta propiedad se establece en false. Puedes configurar el valor de esta propiedad cuando llamas a los métodos videos.insert o videos.update.

  • El objeto contentDetails.contentRating encapsula las calificaciones que recibió el video según varios esquemas de calificación. En la siguiente lista, se identifican los sistemas de calificación admitidos y se proporciona un vínculo a la propiedad asociada con cada uno de ellos. Las definiciones de propiedad identifican los valores de calificación admitidos para cada sistema.

    País	Sistema de clasificación	Propiedad
    Estados Unidos	Asociación Cinematográfica de Estados Unidos (MPAA)	contentDetails.contentRating.mpaaRating
    Estados Unidos	Pautas de televisión para los padres	contentDetails.contentRating.tvpgRating
    Australia	Junta de Clasificación de Australia (ACB)	contentDetails.contentRating.acbRating
    Brasil	Departamento de Justiça, Classificação, Qualificação e Títulos	contentDetails.contentRating.djctqRating
    Canadá	Sistema de Clasificación de Videos de Canadá (CHVRS)	contentDetails.contentRating.chvrsRating
    Francia	Centre National du cinéma et de l'image animée (Ministerio de Cultura de Francia)	contentDetails.contentRating.fmocRating
    Alemania	Freiwillige Selbstkontrolle der Filmwirtschaft (FSK)	contentDetails.contentRating.fskRating
    Gran Bretaña	Comité de Clasificación de Películas por Edades Británico (British Board of Film Classification, BBFC)	contentDetails.contentRating.bbfcRating
    India	Junta Central de Certificación de Películas (CBFC)	contentDetails.contentRating.cbfcRating
    Japón	映倫管理委員 (EIRIN)	contentDetails.contentRating.eirinRating
    Corea	영テ물등metaま faltante (KMRB)	contentDetails.contentRating.kmrbRating
    México	Dirección General de Radio, Televisión y Cinematografía (RTC)	contentDetails.contentRating.rtcRating
    Nueva Zelanda	Clasificación de la Oficina de Cine y Literatura	contentDetails.contentRating.oflcRating
    Rusia	Registro Nacional de Cine de la Federación Rusa	contentDetails.contentRating.russiaRating
    España	Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA)	contentDetails.contentRating.icaaRating

• Se actualizó la documentación del método playlistItems.update para reflejar el hecho de que la propiedad snippet.resourceId debe especificarse en el recurso enviado como cuerpo de la solicitud.

• El método search.list ahora admite la siguiente funcionalidad:

  • El nuevo parámetro forMine restringe una búsqueda para recuperar solo los videos del usuario autenticado.

  • El parámetro order ahora admite la capacidad de ordenar los resultados alfabéticamente por título (order=title) o por recuento de videos en orden descendente (order=videoCount).

  • El nuevo parámetro safeSearch indica si los resultados de la búsqueda deben incluir contenido restringido.

• El método videos.insert admite varios errores nuevos, que se enumeran en la siguiente tabla:

  Tipo de error	Detalle del error	Descripción
  badRequest	invalidCategoryId	La propiedad snippet.categoryId especifica un ID de categoría no válido. Usa el método videoCategories.list para recuperar las categorías admitidas.
  badRequest	invalidRecordingDetails	metadata specifies invalid recording details.
  badRequest	invalidVideoGameRating	Los metadatos de la solicitud especifican una calificación de videojuego no válida.
  badRequest	invalidVideoMetadata	Los metadatos de la solicitud no son válidos.

• Se quitó el parámetro onBehalfOfContentOwner de la lista de parámetros admitidos para los métodos videos.update y videos.delete.

12 de marzo de 2013

Esta actualización incluye los siguientes cambios:

• Se agregó la propiedad channelTitle a snippet para los siguientes recursos:

  • activity: la propiedad especifica el nombre del canal responsable de la actividad.
  • search: la propiedad especifica el nombre del canal asociado con el recurso que identifica el resultado de la búsqueda.
  • video: la propiedad especifica el nombre del canal que subió el video.

• El método search.list admite los siguientes parámetros nuevos:

  • El parámetro channelType te permite restringir una búsqueda de canales para recuperar todos los canales o solo recuperar programas.

  • El parámetro videoType te permite restringir una búsqueda de videos para recuperar todos los videos o solo obtener películas o solo episodios de programas.

• Se actualizó la definición de la parte recordingDetails del recurso video para indicar que el objeto solo se mostrará para un video si se establecieron los datos de ubicación geográfica o el tiempo de grabación del video.

• El método playlistItems.update ahora muestra un error invalidSnippet, que se muestra si la solicitud a la API no especifica un fragmento válido.

• Varios métodos de API admiten parámetros nuevos que están destinados exclusivamente a socios de contenido de YouTube. Entre los socios de contenido de YouTube, se incluyen estudios cinematográficos y de televisión, sellos discográficos y otros creadores que publican su contenido en YouTube.

  • El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario del CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado.

    Este parámetro está dirigido a socios de contenido que poseen y administran muchos canales de YouTube diferentes. El parámetro les permite a esos socios autenticarse una vez y obtener acceso a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal.

    Los métodos channels.list, search.list, videos.delete, videos.list y videos.update admiten este parámetro.

  • El parámetro managedByMe, compatible con el método channels.list, le indica a la API que muestre todos los canales que pertenecen al propietario del contenido que especifica el parámetro onBehalfOfContentOwner.

  • El parámetro forContentOwner, que es compatible con el método search.list, le indica a la API que restrinja los resultados de la búsqueda para incluir solo los recursos que pertenecen al propietario del contenido que se especifica en el parámetro onBehalfOfContentOwner.

25 de febrero de 2013

Esta actualización incluye los siguientes cambios:

• La API admite varias piezas y propiedades nuevas para los recursos video:

  • Las nuevas partes fileDetails, processingDetails y suggestions proporcionan información a los propietarios de los videos acerca de los videos que subieron. Estos datos son muy útiles en las aplicaciones que permiten subir videos e incluyen lo siguiente:

    • estado del procesamiento y progreso
    • errores y otros problemas encontrados durante el procesamiento de un video
    • disponibilidad de las imágenes en miniatura
    • sugerencias para mejorar la calidad de los videos o los metadatos
    • detalles sobre el archivo original que se subió a YouTube

    Solo el propietario del video puede recuperar todas estas partes. En la siguiente lista, se describen brevemente las nuevas partes, y la documentación del recurso video define todas las propiedades que contiene cada una.

    • El objeto fileDetails contiene información sobre el archivo de video que se subió a YouTube, incluida la resolución del archivo, la duración, los códecs de audio y video, las tasas de bits de transmisión y mucho más.

    • El objeto processingProgress contiene información sobre el progreso de YouTube en el procesamiento del archivo de video que se subió. Las propiedades del objeto identifican el estado actual del procesamiento y calculan el tiempo restante hasta que YouTube termine de procesar el video. Esta parte también indica si los diferentes tipos de datos o contenido, como detalles de los archivos o las imágenes en miniatura, están disponibles para el video.

      Este objeto está diseñado para ser consultado para que quien sube el video pueda realizar un seguimiento del progreso que ha hecho YouTube en el procesamiento del archivo de video subido.

    • El objeto suggestions contiene sugerencias que identifican oportunidades para mejorar la calidad del video o los metadatos del video que se subió.

  • La parte contentDetails contiene cuatro propiedades nuevas. Estas propiedades se pueden recuperar con solicitudes sin autenticar.

    • dimension: indica si el video está disponible en 2D o 3D.
    • definition: Indica si el video está disponible en definición estándar o alta.
    • caption: indica si hay subtítulos disponibles para el video.
    • licensedContent: indica si el video incluye contenido reclamado por un socio de contenido de YouTube.

  • La parte status contiene dos propiedades nuevas. Los propietarios de videos pueden establecer valores para ambas propiedades cuando insertan o actualizan un video. Estas propiedades también se pueden recuperar con solicitudes sin autenticar.

    • embeddable: indica si el video puede incorporarse en otro sitio web.
    • license: especifica la licencia del video. Los valores válidos son creativeCommon y youtube.

• Se actualizó la definición del parámetro part para los métodos videos.list, videos.insert y videos.update a fin de enumerar las partes recién agregadas descritas anteriormente, así como la parte recordingDetails, que se omitió de manera involuntaria.

• La nueva propiedad contentDetails.googlePlusUserId del recurso channel especifica el ID del perfil de Google+ asociado con el canal. Este valor se puede utilizar para generar un vínculo al perfil de Google+.

• Cada objeto de imagen en miniatura ahora especifica el ancho y la altura de la imagen. Actualmente, las imágenes en miniatura se muestran en los recursos activity, channel, playlist, playlistItem, search result, subscription y video.

• playlistItems.list ahora admite el parámetro videoId, que se puede usar junto con el parámetro playlistId para recuperar solo el elemento de la playlist que representa el video especificado.

  La API muestra un error notFound si el video que identifica el parámetro no se puede encontrar en la playlist.

• En la documentación sobre errores, se describe un nuevo error forbidden, que indica que una solicitud no está debidamente autorizada para realizar la acción solicitada.

• Se quitó la propiedad snippet.channelId del recurso channel. La propiedad id del recurso proporciona el mismo valor.

30 de enero de 2013

Esta actualización incluye los siguientes cambios:

• La nueva página error enumera los errores que la API puede mostrar. La página incluye errores generales, que pueden ocurrir con varios métodos de API diferentes, así como errores específicos de métodos.

16 de enero de 2013

Esta actualización incluye los siguientes cambios:

• Las muestras de código ahora están disponibles para los métodos y los lenguajes que se indican en la siguiente lista:

  • activities.insert: Java
  • playlistItems.insert: Python
  • playlistItems.list: Java, JavaScript, PHP, Python y Ruby
  • playlists.insert: Java, JavaScript y Python
  • search.list: Java, JavaScript, Python y Ruby
  • videos.insert: Java

• Un recurso activity ahora puede denunciar una acción channelItem, que ocurre cuando YouTube agrega un video a un canal de YouTube generado automáticamente. (YouTube identifica de forma algorítmica los temas que tienen una presencia significativa en el sitio web de YouTube y genera canales automáticamente para esos temas).

• Se actualizaron los siguientes parámetros de search.list:

  • El parámetro q ya no se designa como filtro, lo que significa que...
  • Se cambió el nombre del parámetro relatedToVideo por relatedToVideoId.
  • El parámetro published se reemplazó por dos parámetros nuevos, publishedAfter y publishedBefore, que se describen a continuación.

• El método search.list admite los siguientes parámetros nuevos:

  Nombre del parámetro	Valor	Descripción
  channelId	string	Muestra recursos creados por el canal especificado.
  publishedAfter	datetime	Muestra los recursos creados después del tiempo especificado.
  publishedBefore	datetime	Muestra los recursos creados antes del tiempo especificado.
  regionCode	string	Muestra recursos para el país especificado.
  videoCategoryId	string	Filtra los resultados de la búsqueda de videos para incluir solo los videos asociados con la categoría de video especificada.
  videoEmbeddable	string	Filtra los resultados de la búsqueda de videos para incluir únicamente los que se pueden reproducir en un reproductor incorporado en una página web. Establece el valor del parámetro en true para recuperar solo los videos que se puedan incorporar.
  videoSyndicated	string	Filtra los resultados de la búsqueda de videos para incluir únicamente los videos que se pueden reproducir fuera de YouTube.com. Establece el valor del parámetro en true para recuperar solo los videos distribuidos.

• Varios recursos de la API admiten propiedades nuevas. En la siguiente tabla, se identifican los recursos y sus nuevas propiedades:

  Recurso	Nombre de la propiedad	Valor	Descripción
  activity	contentDetails.playlistItem.playlistItemId	string	ID de elemento de la playlist que YouTube asignó para identificar de forma exclusiva el elemento en la playlist.
  activity	contentDetails.channelItem	object	Un objeto que contiene información sobre un recurso que se agregó a un canal. Esta propiedad solo está presente si snippet.type es channelItem.
  activity	contentDetails.channelItem.resourceId	object	Un objeto que identifica el recurso que se agregó al canal. Al igual que otras propiedades de resourceId, contiene una propiedad kind que especifica el tipo de recurso, como un video o una playlist. También contiene exactamente una de varias propiedades (videoId, playlistId, etc.) que especifican el ID que identifica a ese recurso de manera inequívoca.
  channel	status	object	Este objeto encapsula información sobre el estado de privacidad del canal.
  channel	status.privacyStatus	string	Estado de privacidad del canal. Los valores válidos son private y public.
  playlist	contentDetails	object	Este objeto contiene metadatos acerca del contenido de la playlist.
  playlist	contentDetails.itemCount	unsigned integer	Número de videos en la lista de reproducción.
  playlist	player	object	Este objeto contiene información que puedes utilizar para reproducir la playlist en un reproductor insertado.
  playlist	player.embedHtml	string	Etiqueta <iframe> que incorpora un reproductor de video que reproduce la playlist.
  video	recordingDetails	object	Este objeto encapsula información que identifica o describe el lugar y la hora en que se grabó el video.
  video	recordingDetails.location	object	Este objeto contiene información de ubicación geográfica asociada con el video.
  video	recordingDetails.location.latitude	double	Es la latitud en grados.
  video	recordingDetails.location.longitude	double	Es la longitud en grados.
  video	recordingDetails.location.elevation	double	Altitud sobre la Tierra, en metros.
  video	recordingDetails.locationDescription	string	Es una descripción textual de la ubicación donde se grabó el video.
  video	recordingDetails.recordingDate	datetime	Fecha y hora en que se grabó el video. El valor se especifica en formato ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ).

• La documentación de varios métodos de API ahora identifica propiedades que se deben especificar en el cuerpo de la solicitud o que se actualizan según los valores en el cuerpo de la solicitud. En la siguiente tabla, se enumeran esos métodos, así como las propiedades obligatorias o modificables.

  Nota: Es posible que en la documentación de otros métodos ya se incluyan las propiedades obligatorias y modificables.

  Método	Propiedades
  activities.insert	Propiedades obligatorias: snippet.description Propiedades modificables: snippet.description contentDetails.bulletin.resourceId
  playlists.update	Propiedades obligatorias: id
  playlistItems.update	Propiedades obligatorias: id
  videos.update	Propiedades obligatorias: id

• La API ya no informa un error playlistAlreadyExists si intentas crear o actualizar una playlist que tendría el mismo título que una playlist que ya existe en el mismo canal.

• Varios métodos de API admiten nuevos tipos de error. En la siguiente tabla, se identifica el método y los nuevos errores admitidos:

  Método	Tipo de error	Detalle del error	Descripción
  guideCategories.list	notFound	notFound	No se puede encontrar la categoría guía identificada por el parámetro id. Utiliza el método guideCategories.list para recuperar una lista de valores válidos.
  playlistItems.delete	forbidden	playlistItemsNotAccessible	La solicitud no está debidamente autorizada para eliminar el elemento de la lista de reproducción especificada.
  videoCategories.list	notFound	videoCategoryNotFound	No se puede encontrar la categoría de video identificada por el parámetro id. Utiliza el método videoCategories.list para recuperar una lista de valores válidos.