Videos: update

La API ahora permite marcar tu canal o tus videos como “creado para niños”. Además, ahora los recursos channel y video también incluyen una propiedad que identifica el estado de contenido “creado para niños” de ese canal o video. También se actualizaron las Condiciones del Servicio y las Políticas para Desarrolladores de los servicios de la API de YouTube el 10 de enero de 2020. Para obtener más información, consulta los registros de revisión del Servicio de la API de YouTube Data 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 establecerá la operación de escritura, así como las que incluirá la respuesta de la API.

Ten en cuenta que este método anulará los valores existentes de todas las propiedades mutables que se contengan en las partes 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 actualiza 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á al valor que especifique 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 actualiza un video. Por ejemplo, el objeto statistics encapsula las estadísticas que YouTube calcula para un video y no contiene valores que puedas establecer o modificar. Si el valor del parámetro especifica un part que no contiene valores mutables, ese part se incluirá de todas formas en la respuesta de la API.

La siguiente lista contiene los nombres part que puedes incluir en el valor del parámetro:
  • contentDetails
  • fileDetails
  • id
  • liveStreamingDetails
  • localizations
  • paidProductPlacementDetails
  • player
  • processingDetails
  • recordingDetails
  • snippet
  • statistics
  • status
  • suggestions
  • topicDetails
Parámetros opcionales
onBehalfOfContentOwner string
Este parámetro solo se puede usar en una solicitud autorizada correctamente. 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 del 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 muchos 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 obligatoria si la solicitud actualiza el snippet del recurso video.
    • snippet.categoryId: Esta propiedad solo es obligatoria 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 estableces un valor para esta propiedad, también debes establecer la propiedad status.privacyStatus en private.
    • status.selfDeclaredMadeForKids
    • status.containsSyntheticMedia
    • 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 podría mostrar la API en respuesta a una llamada a este método. Consulta la documentación sobre mensajes de error para obtener más detalles.

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSet La solicitud a la API intenta agregar detalles de video localizados 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 admitidas.
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 de los metadatos de la solicitud especifica detalles de registro 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 inserció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. 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. Verifica el valor del campo id en el cuerpo de la solicitud para asegurarte de que sea correcto.

Pruébalo

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