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:
|
|
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 elsnippet
del recursovideo
.snippet.categoryId
: Esta propiedad solo es necesaria si la solicitud actualiza elsnippet
del recursovideo
.
-
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 propiedadstatus.privacyStatus
enprivate
.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.