Videos: update

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

Actualiza los metadatos de un video.

Impacto en la cuota: Una llamada a este método tiene un costo de cuota de 50 unidades.

Casos de uso habituales

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/youtube/v3/videos

Autorización

Esta solicitud requiere autorización con al menos uno de los siguientes alcances (obtén más información acerca de la autenticación y autorización).

Alcance
https://www.googleapis.com/auth/youtubepartner
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

Parámetros

En la siguiente tabla, se enumeran los parámetros que admite esta consulta. Todos los parámetros mencionados son parámetros de consulta.

Parámetros
Parámetros obligatorios
part string
El parámetro part tiene dos propósitos en esta operación. Identifica las propiedades que configurará la operación de escritura, así como las propiedades que incluirá la respuesta de la API.

Ten en cuenta que este método anulará los valores existentes para todas las propiedades que pueden modificarse que se encuentran en cualquier parte que especifique el valor del parámetro. Por ejemplo, la configuración de privacidad de un video se encuentra en la parte status. Por lo tanto, si tu solicitud es la actualización de un video privado y el valor del parámetro part de la solicitud incluye la parte status, la configuración de privacidad del video se actualizará según el valor que especifica el cuerpo de la solicitud. Si el cuerpo de la solicitud no especifica un valor, se quitará la configuración de privacidad existente y el video volverá a la configuración de privacidad predeterminada.

Además, no todas las partes contienen propiedades que se pueden establecer cuando se inserta o se actualiza un video. Por ejemplo, el objeto statistics contiene estadísticas que YouTube calcula para un video y no contiene valores que se pueden establecer o modificar. Si el valor del parámetro especifica un part que no contiene valores mutables, ese part se incluirá en la respuesta de la API.

En la siguiente lista, se incluyen los nombres part que puedes incluir en el valor del parámetro:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Parámetros opcionales
onBehalfOfContentOwner string
Este parámetro solo se puede utilizar en una solicitud autorizada debidamente. Nota: Este parámetro está dirigido exclusivamente a socios de contenido de YouTube.

El parámetro onBehalfOfContentOwner indica que las credenciales de autorización de la solicitud identifican a un usuario de CMS de YouTube que actúa en nombre del propietario del contenido especificado en el valor del parámetro. Este parámetro está dirigido a socios de contenido de YouTube que poseen y administran varios canales de YouTube diferentes. Permite a los propietarios de contenido autenticarse una vez y acceder a todos los datos de sus videos y canales, sin tener que proporcionar credenciales de autenticación para cada canal. La cuenta de CMS con la que se autentica el usuario debe estar relacionada con el propietario del contenido de YouTube especificado.

Cuerpo de la solicitud

Proporciona un recurso de video en el cuerpo de la solicitud. Para ese recurso:

  • Debes especificar un valor para estas propiedades:

    • id
    • snippet.title: Esta propiedad solo es necesaria si la solicitud actualiza el snippet del recurso video.
    • snippet.categoryId: Esta propiedad solo es necesaria si la solicitud actualiza el snippet del recurso video.

  • Puedes establecer los valores de las siguientes propiedades:

    • snippet.categoryId
    • snippet.defaultLanguage
    • snippet.description
    • snippet.tags[]
    • snippet.title
    • status.embeddable
    • status.license
    • status.privacyStatus
    • status.publicStatsViewable
    • status.publishAt: Si configuras un valor para esta propiedad, también debes establecer la propiedad status.privacyStatus en private.
    • status.selfDeclaredMadeForKids
    • recordingDetails.locationDescription (obsoleto)
    • recordingDetails.location.latitude (obsoleto)
    • recordingDetails.location.longitude (obsoleto)
    • recordingDetails.recordingDate
    • localizations.(key)
    • localizations.(key).title
    • localizations.(key).description

    Si envías una solicitud de actualización sin especificar un valor para una propiedad que ya tiene un valor, el valor actual de la propiedad se eliminará.

Respuesta

Si se aplica correctamente, este método muestra un recurso de video en el cuerpo de la respuesta.

Errores

En la siguiente tabla se identifican los mensajes de error que la API podría mostrar en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más información.

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSet La solicitud a la API está intentando agregar detalles localizados del video sin especificar el idioma predeterminado de los detalles del video.
badRequest (400) 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 compatibles.
badRequest (400) invalidDefaultBroadcastPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para la transmisión predeterminada.
badRequest (400) invalidDescription Los metadatos de la solicitud especifican una descripción del video no válida.
badRequest (400) invalidPublishAt Los metadatos de la solicitud especifican una hora de publicación programada no válida.
badRequest (400) invalidRecordingDetails El objeto recordingDetails en los metadatos de la solicitud especifica detalles de grabación no válidos.
badRequest (400) invalidTags Los metadatos de la solicitud especifican palabras clave de video no válidas.
badRequest (400) invalidTitle Los metadatos de la solicitud especifican un título de video no válido o vacío.
badRequest (400) invalidVideoMetadata Los metadatos de la solicitud no son válidos.
forbidden (403) forbidden
forbidden (403) forbiddenEmbedSetting La solicitud 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 para las transmisiones en vivo. Consulta el Centro de ayuda de YouTube para obtener más información.
forbidden (403) forbiddenLicenseSetting La solicitud intenta establecer una licencia no válida para el video.
forbidden (403) forbiddenPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para el video.
notFound (404) videoNotFound El vídeo que intentas actualizar no se puede encontrar. Comprueba el valor del campo id en el cuerpo de la solicitud para asegurarte de que sea correcto.

Pruébela.

Usa APIs Explorer para llamar a esta API y ver la solicitud y la respuesta de la API.