YouTube Data API - Errors
En este documento, se identifican los diferentes tipos de errores que pueden mostrar las operaciones de YouTube Data API. También puedes encontrar una lista de errores para cualquier método individual en la documentación de referencia para dicho método.
Errores generales
En las siguientes tablas, se identifican los mensajes de error de la API que no son específicos de un método de API en particular.
Core API errors
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
Acceso prohibido. Puede que la solicitud no esté debidamente autorizada. |
quotaExceeded (403) |
quotaExceeded |
La solicitud no se puede completar porque superaste tu cuota. |
Common request errors
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
incompatibleParameters |
La solicitud especifica dos o más parámetros que no se pueden utilizar en la misma solicitud. |
badRequest (400) |
invalidFilters |
La solicitud especifica un parámetro de filtro no válido. |
badRequest (400) |
invalidPageToken |
La solicitud especifica un token de página no válido. |
badRequest (400) |
missingRequiredParameter |
A la solicitud le falta un parámetro obligatorio. |
badRequest (400) |
unexpectedParameter |
La solicitud especifica un parámetro inesperado. |
forbidden (403) |
accountDelegationForbidden |
El usuario autenticado no puede actuar en nombre de la Cuenta de Google especificada. |
forbidden (403) |
authenticatedUserAccountClosed |
La cuenta de YouTube del usuario autenticado está cerrada. En caso de que el usuario autenticado actúe en nombre de otra Cuenta de Google, este error se refiere a esta última. |
forbidden (403) |
authenticatedUserAccountSuspended |
La cuenta de YouTube del usuario autenticado está suspendida. En caso de que el usuario autenticado actúe en nombre de otra Cuenta de Google, este error se refiere a esta última. |
forbidden (403) |
authenticatedUserNotChannel |
En esta solicitud, el usuario autenticado debe resolverse en un canal, pero no lo hace. Si tu solicitud está autenticada y usa el parámetro de delegación onBehalfOfContentOwner , también debes configurar el parámetro onBehalfOfContentOwnerChannel . |
forbidden (403) |
channelClosed |
El canal identificado en la solicitud se cerró. |
forbidden (403) |
channelNotFound |
No se puede encontrar el canal identificado en la solicitud. |
forbidden (403) |
channelSuspended |
El canal identificado en la solicitud se suspendió. |
forbidden (403) |
cmsUserAccountNotFound |
No se permite al usuario de CMS actuar en nombre del propietario de contenido especificado. |
forbidden (403) |
insufficientCapabilities |
El usuario CMS tiene capacidades insuficientes. |
forbidden (403) |
insufficientPermissions |
El token de OAuth 2.0 proporcionado para la solicitud especifica permisos insuficientes para acceder a los datos solicitados. |
notFound (404) |
contentOwnerAccountNotFound |
No se encontró la cuenta del propietario del contenido especificada. |
Request context errors
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
invalidLanguage |
El valor del parámetro hl no especifica un código de idioma válido. |
badRequest (400) |
invalidMine |
No se admite el uso del parámetro mine en la solicitud. |
badRequest (400) |
invalidMine |
El parámetro mine no se puede usar 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 llamado. |
badRequest (400) |
invalidPart |
El parámetro part de la solicitud especifica algunas partes que no se pueden escribir al mismo tiempo. |
badRequest (400) |
invalidRegionCode |
El parámetro regionCode especifica un código de región no válido. |
badRequest (400) |
unexpectedPart |
El parámetro part de la solicitud especifica un valor inesperado. |
badRequest (400) |
unknownPart |
El parámetro part de la solicitud especifica un valor desconocido. |
badRequest (400) |
unsupportedLanguageCode |
El valor del parámetro hl no especifica un código de idioma compatible. |
badRequest (400) |
unsupportedRegionCode |
El parámetro regionCode especifica un código de región no admitido. |
unauthorized (401) |
authorizationRequired |
La solicitud usa el parámetro mine , pero no está autorizada correctamente. |
unauthorized (401) |
youtubeSignupRequired |
Este error indica que el usuario tiene una cuenta de Google no vinculada, lo que significa que el usuario tiene una cuenta de Google, pero no un canal de YouTube. Estos usuarios pueden acceder a muchas funciones que dependen de la autorización del usuario, como calificar videos o agregarlos a una playlist de watch_later . Sin embargo, a modo de ejemplo, el usuario necesitaría un canal de YouTube para poder subir un video. Un usuario que tiene una cuenta de Gmail o un dispositivo Android seguramente tiene una Cuenta de Google, pero es posible que aún no la haya vinculado a un canal de YouTube.
Este error suele ocurrir si intentas usar el flujo de la cuenta de servicio de OAuth 2.0. YouTube no admite cuentas de servicio y, si intentas autenticarte con una, recibirás este error.
En la entrada de blog de la API de YouTube en la que se presenta la compatibilidad con Cuentas de Google, también se analiza el error youtubeSignupRequired con más detalle. Si bien la entrada de blog explica el error de la versión 2.1 de la API, el significado del error sigue siendo aplicable. |
activities
YouTube dejó de ofrecer la función de boletines del canal. Ya no se admite el método
activities.insert
.
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de activities
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
activities.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
homeParameterDeprecated |
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. |
forbidden (403) |
forbidden |
La solicitud no está autorizada correctamente. |
notFound (404) |
channelNotFound |
No se puede encontrar el ID del canal identificado por el parámetro channelId de la solicitud. |
notFound (404) |
homeChannelNotFound |
No se puede encontrar un feed de la página principal de YouTube para el usuario autenticado actualmente. |
unauthorized (401) |
authorizationRequired |
La solicitud usa el parámetro home , pero no está autorizada correctamente. |
subtítulos
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de captions
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
captions.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
Los permisos asociados con la solicitud no son suficientes para borrar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada. |
notFound (404) |
captionNotFound |
No se pudo encontrar la pista de subtítulos. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
captions.download
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
Los permisos asociados con la solicitud no son suficientes para descargar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada. |
invalidValue (400) |
couldNotConvert |
No se pudieron convertir los datos de la pista de subtítulos al idioma o formato solicitados. Asegúrate de que los valores de tfmt y tlang solicitados sean válidos y de que el snippet.status de la pista de subtítulos solicitada no sea failed . |
notFound (404) |
captionNotFound |
No se pudo encontrar la pista de subtítulos. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
captions.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
contentRequired |
La solicitud no contiene el contenido de la pista de subtítulos. |
conflict (409) |
captionExists |
El video especificado ya tiene una pista de subtítulos con los snippet.language y snippet.name proporcionados. Un video puede tener varias pistas para el mismo idioma, pero cada una debe tener un nombre diferente.
Existen varias formas de corregir el error. Puedes borrar la pista existente y, luego, insertar una nueva, o bien cambiar el nombre de la nueva pista antes de insertarla. |
forbidden (403) |
forbidden |
Los permisos asociados con la solicitud no son suficientes para subir la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada. |
invalidValue (400) |
invalidMetadata |
La solicitud contiene valores de metadatos no válidos, lo que impide que se cree la pista. Confirma que la solicitud especifique valores válidos para las propiedades snippet.language , snippet.name y snippet.videoId . También se puede incluir la propiedad snippet.isDraft , pero no es obligatoria. |
notFound (404) |
videoNotFound |
No se pudo encontrar el video identificado por el parámetro videoId . |
invalidValue (400) |
nameTooLong |
El snippet.name especificado en la solicitud es demasiado largo. La longitud máxima admitida es de 150 caracteres. |
captions.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
No se pudieron recuperar uno o más segmentos de subtítulos porque los permisos asociados con la solicitud no son suficientes para recuperar los recursos solicitados. Puede que la solicitud no esté debidamente autorizada. |
notFound (404) |
captionNotFound |
No se pudieron encontrar uno o más de los segmentos de subtítulos especificados. Este error se produce si el parámetro videoId identifica un video real, pero el parámetro id identifica IDs de pista de subtítulos que no existen o IDs de pista que están asociados con otros videos. Verifica los valores de los parámetros id y videoId de la solicitud para asegurarte de que sean correctos. |
notFound (404) |
videoNotFound |
No se pudo encontrar el video identificado por el parámetro videoId . |
captions.update
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
contentRequired |
La solicitud no subió un archivo de subtítulos actualizado. El contenido real de la pista es obligatorio si el parámetro sync se establece en true . |
forbidden (403) |
forbidden |
Los permisos asociados con la solicitud no son suficientes para actualizar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada. |
notFound (404) |
captionNotFound |
No se pudo encontrar la pista de subtítulos especificada. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
channelBanners
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de channelBanners
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
channelBanners.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
bannerAlbumFull |
Tu álbum de diseño del canal de YouTube tiene demasiadas imágenes. Ve a http://photos.google.com, navega a la página de álbumes y quita algunas de las imágenes de ese álbum. |
badRequest (400) |
mediaBodyRequired |
La solicitud no incluye el contenido de la imagen. |
channelSections
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de channelSections
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
channelSections.delete
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
notEditable |
No se puede borrar esta sección del canal. |
forbidden (403) |
channelSectionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
invalidValue (400) |
idInvalid |
La propiedad id especifica un ID de sección de canal no válido. |
invalidValue (400) |
idRequired |
La propiedad id debe especificar un valor que identifique la sección del canal que se borrará. |
notFound (404) |
channelNotFound |
No se encontró el canal. |
notFound (404) |
channelSectionNotFound |
No se puede encontrar la sección del canal que intentas actualizar. |
channelSections.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
defaultLanguageNotSetError |
La propiedad snippet.defaultLanguage del recurso channelSection se debe configurar para insertar o actualizar correctamente el objeto localizations de ese recurso. |
badRequest (400) |
invalidLanguage |
Una de las claves de idioma del objeto localizations no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
No se puede crear esta sección del canal. |
badRequest (400) |
styleRequired |
El recurso channelSection debe especificar un valor para el campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno de los valores de la lista targeting.countries no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno de los valores de la lista targeting.languages no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno de los valores de la lista targeting.regions no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
El recurso channelSection debe especificar un valor para el campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
invalidValue (400) |
channelNotActive |
Al menos uno de los canales especificados no está activo. |
invalidValue (400) |
channelsDuplicated |
La solicitud falló porque especificó canales duplicados. |
invalidValue (400) |
channelsNeeded |
Si la propiedad snippet.type tiene un valor de multipleChannels , se debe especificar la propiedad contentDetails.channels[] y, al menos, un canal. |
invalidValue (400) |
channelsNotExpected |
El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.channels[] , pero no se esperan canales para este tipo de sección de canal. |
invalidValue (400) |
contentDetailsNeeded |
El recurso que insertes debe contener un objeto contentDetails para este tipo de sección del canal. |
invalidValue (400) |
inValidPosition |
La propiedad snippet.position contiene un valor no válido. |
invalidValue (400) |
maxChannelSectionExceeded |
No se puede completar la solicitud porque el canal ya tiene la cantidad máxima de secciones. |
invalidValue (400) |
maxChannelsExceeded |
La solicitud falló porque se intentó incluir demasiados canales en la sección de canales. |
invalidValue (400) |
maxPlaylistExceeded |
La solicitud falló porque se intentó incluir demasiadas playlists en la sección del canal. |
invalidValue (400) |
onePlaylistNeeded |
Si la propiedad snippet.type tiene un valor de singlePlaylist , la propiedad contentDetails.playlists[] debe especificar exactamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
No puedes incluir tu propio canal en una sección de canal que aparezca en ese canal. |
invalidValue (400) |
playlistIsPrivate |
Una o más de las playlists especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal. |
invalidValue (400) |
playlistsDuplicated |
La solicitud falló porque especificó playlists duplicadas. |
invalidValue (400) |
playlistsNeeded |
Si la propiedad snippet.type tiene un valor de singlePlaylist o multiplePlaylists , se debe especificar la propiedad contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.playlists[] , pero no se esperan playlists para este tipo de sección del canal. |
invalidValue (400) |
snippetNeeded |
Debes especificar un snippet para crear la sección del canal. |
invalidValue (400) |
titleLengthExceeded |
El valor de la propiedad snippet.title es demasiado largo. |
invalidValue (400) |
titleRequired |
Si la propiedad snippet.type tiene un valor de multiplePlaylists o multipleChannels , debes establecer el título de la sección especificando un valor para la propiedad snippet.title . |
notFound (404) |
channelNotFound |
No se puede encontrar uno o más de los canales especificados. |
notFound (404) |
playlistNotFound |
No se puede encontrar una o más de las playlists especificadas. |
channelSections.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
channelSectionForbidden |
El solicitante no tiene permiso para acceder a las secciones del canal solicitadas. |
invalidValue (400) |
idInvalid |
La solicitud especifica un ID de sección de canal no válido. |
invalidValue (400) |
invalidCriteria |
No se pudo completar la solicitud porque los criterios de filtro no son válidos. |
notFound (404) |
channelNotFound |
No se puede encontrar el canal asociado con la solicitud. |
notFound (404) |
channelSectionNotFound |
No se puede encontrar la sección del canal asociada con la solicitud. |
channelSections.update
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
defaultLanguageNotSetError |
La propiedad snippet.defaultLanguage del recurso channelSection se debe configurar para insertar o actualizar correctamente el objeto localizations de ese recurso. |
badRequest (400) |
invalidLanguage |
Una de las claves de idioma del objeto localizations no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
notEditable |
No se puede editar esta sección del canal. |
badRequest (400) |
styleRequired |
El recurso channelSection debe especificar un valor para el campo snippet.style . |
badRequest (400) |
targetInvalidCountry |
Uno de los valores de la lista targeting.countries no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidLanguage |
Uno de los valores de la lista targeting.languages no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
targetInvalidRegion |
Uno de los valores de la lista targeting.regions no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections . |
badRequest (400) |
typeRequired |
El recurso channelSection debe especificar un valor para el campo snippet.type . |
forbidden (403) |
channelSectionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
invalidValue (400) |
channelNotActive |
Al menos uno de los canales especificados no está activo. |
invalidValue (400) |
channelsDuplicated |
La solicitud falló porque especificó canales duplicados. |
invalidValue (400) |
channelsNeeded |
Si la propiedad snippet.type tiene un valor de multipleChannels , se debe especificar la propiedad contentDetails.channels[] y, al menos, un canal. |
invalidValue (400) |
channelsNotExpected |
El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.channels[] , pero no se esperan canales para este tipo de sección de canal. |
invalidValue (400) |
contentDetailsNeeded |
El recurso que actualizas debe contener un objeto contentDetails para este tipo de sección del canal. |
invalidValue (400) |
idInvalid |
La propiedad id especifica un ID de sección de canal no válido. |
invalidValue (400) |
idRequired |
La propiedad id debe especificar un valor que identifique la sección del canal que se actualizará. |
invalidValue (400) |
inValidPosition |
La propiedad snippet.position contiene un valor no válido. |
invalidValue (400) |
maxChannelsExceeded |
La solicitud falló porque se intentó incluir demasiados canales en la sección de canales. |
invalidValue (400) |
maxPlaylistExceeded |
La solicitud falló porque se intentó incluir demasiadas playlists en la sección del canal. |
invalidValue (400) |
onePlaylistNeeded |
Si la propiedad snippet.type tiene un valor de singlePlaylist , la propiedad contentDetails.playlists[] debe especificar exactamente una playlist. |
invalidValue (400) |
ownChannelInChannels |
No puedes incluir tu propio canal en una sección de canal que aparezca en ese canal. |
invalidValue (400) |
playlistIsPrivate |
Una o más de las playlists especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal. |
invalidValue (400) |
playlistsDuplicated |
La solicitud falló porque especificó playlists duplicadas. |
invalidValue (400) |
playlistsNeeded |
Si la propiedad snippet.type tiene un valor de singlePlaylist o multiplePlaylists , se debe especificar la propiedad contentDetails.playlists[] . |
invalidValue (400) |
playlistsNotExpected |
El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.playlists[] , pero no se esperan playlists para este tipo de sección del canal. |
invalidValue (400) |
snippetNeeded |
Debes especificar un snippet para actualizar la sección del canal. |
invalidValue (400) |
titleLengthExceeded |
El valor de la propiedad snippet.title es demasiado largo. |
invalidValue (400) |
titleRequired |
Si la propiedad snippet.type tiene un valor de multiplePlaylists o multipleChannels , debes establecer el título de la sección especificando un valor para la propiedad snippet.title . |
notFound (404) |
channelNotFound |
No se puede encontrar uno o más de los canales especificados. |
notFound (404) |
channelSectionNotFound |
No se puede encontrar la sección del canal que intentas actualizar. |
notFound (404) |
playlistNotFound |
No se puede encontrar una o más de las playlists especificadas. |
canales
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de channels
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
channels.list
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
invalidCriteria |
Se puede especificar un máximo de uno de los siguientes filtros:id , mySubscribers , categoryId , mine , managedByMe y forUsername . En el caso de la autenticación del propietario del contenido con el parámetro onBehalfOfContentOwner , solo se puede especificar id o managedByMe . |
forbidden (403) |
channelForbidden |
El canal especificado por el parámetro id no admite la solicitud o la solicitud no está autorizada correctamente. |
notFound (404) |
categoryNotFound |
No se puede encontrar la categoría identificada por el parámetro categoryId . Usa el método guideCategories.list para recuperar una lista de valores válidos. |
notFound (404) |
channelNotFound |
No se puede encontrar el canal especificado en el parámetro id . |
channels.update
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
brandingValidationError |
Uno de los valores del objeto brandingSettings no pasó la validación. Usa el método channels.list para recuperar la configuración existente del canal y actualizar los valores de la propiedad según los lineamientos de la documentación del recurso channels . |
badRequest (400) |
channelTitleUpdateForbidden |
Cuando actualices el brandingSettings part de un canal, debes establecer el valor de la propiedad brandingSettings.channel.title en el título actual del canal o omitir la propiedad. La API muestra un error si cambias el valor de la propiedad. |
badRequest (400) |
defaultLanguageNotSetError |
Se debe configurar defaultLanguage para actualizar localizations . |
badRequest (400) |
invalidBrandingOption |
Una de las configuraciones del desarrollo de la marca que especificaste no existe. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación del recurso channels . |
badRequest (400) |
invalidCustomMessage |
Los metadatos de la solicitud especifican un mensaje personalizado no válido. Verifica el valor de la propiedad invideoPromotion.items[].customMessage en el recurso que envió la solicitud. |
badRequest (400) |
invalidDuration |
Los metadatos de la solicitud especifican una duración no válida en la parte invideoPromotion. |
badRequest (400) |
invalidDuration |
Los metadatos de la solicitud especifican un tipo de posición no válido para determinar cómo el elemento promovido se ubica en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.position.type en el recurso que envió la solicitud. |
badRequest (400) |
invalidRecentlyUploadedBy |
Los metadatos de la solicitud especifican un ID de canal no válido. Verifica el valor de la propiedad invideoPromotion.items[].id.recentlyUploadedBy en el recurso que envió la solicitud. |
badRequest (400) |
invalidTimingOffset |
Los metadatos de la solicitud especifican un desfase de tiempo no válido en la parte de invideoPromotion. |
badRequest (400) |
invalidTimingOffset |
Los metadatos de la solicitud especifican una equidistancia de sincronización no válida para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.timing.offsetMs en el recurso que envió la solicitud. |
badRequest (400) |
invalidTimingType |
Los metadatos de la solicitud especifican un método de sincronización no válido para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.timing.type en el recurso que envió la solicitud. |
badRequest (400) |
localizationValidationError |
Uno de los valores del objeto localizations no pasó la validación. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos de canales. |
badRequest (400) |
tooManyPromotedItems |
Se superó la cantidad permitida de elementos promocionados en la parte de invideoPromotion. |
forbidden (403) |
channelForbidden |
El canal especificado en el parámetro id no admite la solicitud o la solicitud no está autorizada correctamente. |
forbidden (403) |
promotedVideoNotAllowed |
No se puede encontrar el canal que la solicitud de la API está intentando actualizar. Verifica el valor de la propiedad id en el recurso channel que envió la solicitud para asegurarte de que el ID del canal sea correcto. |
forbidden (403) |
websiteLinkNotAllowed |
No se permite la URL del sitio web especificada. |
notFound (404) |
channelNotFound |
No se puede encontrar el canal especificado por el parámetro id o no tiene opciones de desarrollo de la marca. |
notFound (404) |
channelNotFound |
No se puede encontrar el canal especificado en el parámetro id . |
notFound (404) |
unknownChannelId |
No se encontró el ID de canal especificado. |
notFound (404) |
unknownChannelId |
No se encontró el ID de canal de recentlyUploadedBy especificado. |
notFound (404) |
unknownVideoId |
No se puede encontrar la identificación de video especificada como un elemento promocionado. |
required (400) |
requiredItemIdType |
Los metadatos de la solicitud deben especificar un tipo de artículo en la parte invideoPromotion. |
required (400) |
requiredItemId |
Los metadatos de la solicitud deben especificar un elemento en la parte invideoPromotion. |
required (400) |
requiredTimingOffset |
Los metadatos de la solicitud deben especificar un desfase de tiempo predeterminado para que YouTube pueda determinar cuándo mostrar el elemento promocionado. Establece el valor de la propiedad invideoPromotion.defaultTiming.offsetMs en el recurso que envía la solicitud. |
required (400) |
requiredTimingOffset |
Los metadatos de la solicitud deben especificar una equidistancia de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.timing.offsetMs en el recurso que envía la solicitud. |
required (400) |
requiredTimingType |
Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.defaultTiming.type en el recurso que envía la solicitud. |
required (400) |
requiredTimingType |
Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.timing.type en el recurso que envía la solicitud. |
required (400) |
requiredTiming |
Los metadatos de la solicitud deben especificar un tiempo para cada elemento de la parte invideoPromotion . |
required (400) |
requiredVideoId |
Los metadatos de la solicitud deben especificar una identificación de video para identificar el elemento promocionado. |
required (400) |
requiredWebsiteUrl |
Los metadatos de la solicitud deben especificar una URL de sitio web en la parte invideoPromotion. Establece el valor de la propiedad invideoPromotion.items[].id.websiteUrl en el recurso que envía la solicitud. |
miembros
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de members
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
members.list
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
channelMembershipsNotEnabled |
El canal del creador que autoriza la solicitud no tiene habilitadas las membresías. |
badRequest (400) |
invalidMode |
El valor del parámetro mode no es válido.
Este error puede ocurrir si el parámetro pageToken especifica un token que se recuperó con un modo diferente al especificado. |
badRequest (400) |
invalidPageToken |
El valor del parámetro pageToken no es válido. Este error se produce si el token de página que se usó en la solicitud venció. |
badRequest (400) |
invalidHasAccessToLevel |
El valor del parámetro hasAccessToLevel no es válido. No hay ningún nivel con el id especificado. |
badRequest (400) |
invalidFilterByMemberChannelId |
El valor del parámetro filterByMemberChannelId no es válido. Este error se produce si el valor del parámetro filterByMemberChannelId especifica más de 100 canales. |
membershipsLevels
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de members
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
membershipsLevels.list
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
channelMembershipsNotEnabled |
El canal del creador que autoriza la solicitud no tiene habilitadas las membresías. |
playlistItems
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de playlistItems
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
playlistItems.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
playlistItemsNotAccessible |
La solicitud no está debidamente autorizada para eliminar el elemento de la lista de reproducción especificada. |
notFound (404) |
playlistItemNotFound |
No se puede encontrar el elemento de la playlist identificado con el parámetro id de la solicitud. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de borrar videos de la playlist especificada. Por ejemplo, no puedes borrar un video de la playlist de videos subidos. |
playlistItems.insert
Tipo de error |
Detalle del error |
Descripción |
duplicate |
videoAlreadyInPlaylist |
El video que intentas agregar a la lista de reproducción ya está en ella. |
forbidden (403) |
playlistContainsMaximumNumberOfVideos |
La lista de reproducción ya contiene el número máximo permitido de elementos. |
forbidden (403) |
playlistItemsNotAccessible |
La solicitud no tiene la autorización adecuada para insertar el elemento de playlist especificado. |
invalidValue (400) |
invalidContentDetails |
La propiedad contentDetails de la solicitud no es válida. Una posible razón es que el campo contentDetails.note tiene más de 280 caracteres. |
invalidValue (400) |
invalidPlaylistItemPosition |
La solicitud intenta establecer la posición del elemento de la lista de reproducción en un valor no válido o no admitido. Verifica el valor de la propiedad position en el snippet del recurso. |
invalidValue (400) |
invalidResourceType |
El type especificado para el ID de recurso no es compatible con esta operación. El ID de recurso identifica el elemento que se agregará a la playlist, como youtube#video . |
invalidValue (400) |
manualSortRequired |
La solicitud intenta establecer la posición del elemento de la playlist, pero esta no usa la ordenación manual. (por ejemplo, los elementos de una playlist se pueden ordenar por fecha o popularidad). Para corregir el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la playlist tenga una posición en particular en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar esta configuración en el Administrador de videos de YouTube. |
invalidValue (400) |
videoAlreadyInAnotherSeriesPlaylist |
El video que intentas agregar a la playlist ya está en otra playlist de series. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de insertar videos en la playlist especificada. Por ejemplo, no puedes insertar un video en la playlist de videos subidos. |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro playlistId de la solicitud. |
notFound (404) |
videoNotFound |
El video que intentas agregar a la lista de reproducción no se puede encontrar. Verifica el valor de la propiedad videoId para asegurarte de que sea correcto. |
required (400) |
channelIdRequired |
La solicitud no especifica un valor para la propiedad channelId obligatoria. |
required (400) |
playlistIdRequired |
La solicitud no especifica un valor para la propiedad playlistId obligatoria. |
required (400) |
resourceIdRequired |
La solicitud debe contener un recurso en el que el objeto snippet especifique un resourceId . |
playlistItems.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
playlistItemsNotAccessible |
La solicitud no está debidamente autorizada para recuperar la lista de reproducción especificada. |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro playlistId de la solicitud. |
notFound (404) |
videoNotFound |
No se puede encontrar el video identificado con el parámetro videoId de la solicitud. |
required (400) |
playlistIdRequired |
La solicitud de suscripción no especifica un valor para la propiedad playlistId obligatoria. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de mostrar una lista de videos en la playlist especificada. Por ejemplo, no puedes incluir un video en tu playlist de Ver más tarde. |
playlistItems.update
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
playlistItemsNotAccessible |
La solicitud no tiene la autorización adecuada para actualizar el elemento de playlist especificado. |
invalidValue (400) |
invalidPlaylistItemPosition |
La solicitud intenta establecer la posición del elemento de la lista de reproducción en un valor no válido o no admitido. Verifica el valor de la propiedad position en el snippet del recurso. |
invalidValue (400) |
invalidResourceType |
El type especificado para el ID de recurso no es compatible con esta operación. El ID de recurso identifica el elemento que se agregará a la playlist, como youtube#video . |
invalidValue (400) |
invalidSnippet |
La solicitud no especifica una propiedad snippet válida. |
invalidValue (400) |
manualSortRequired |
La solicitud intenta establecer la posición del elemento de la playlist, pero esta no usa la ordenación manual. (por ejemplo, los elementos de una playlist se pueden ordenar por fecha o popularidad). Para corregir el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la playlist tenga una posición en particular en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar esta configuración en el Administrador de videos de YouTube. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la actualización de videos en la playlist especificada. Por ejemplo, no puedes actualizar un video en la playlist de videos subidos. |
notFound (404) |
playlistItemNotFound |
No se puede encontrar el elemento de la playlist identificado con la propiedad id de la solicitud. |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro playlistId de la solicitud. |
required (400) |
channelIdRequired |
La solicitud no especifica un valor para la propiedad channelId obligatoria. |
required (400) |
playlistIdRequired |
La solicitud no especifica un valor para la propiedad playlistId obligatoria. |
required (400) |
playlistItemIdRequired |
El recurso de elemento de playlist especificado en la solicitud debe usar la propiedad id para identificar el elemento de playlist que se actualizará. |
playlists
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de playlists
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
playlists.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
playlistForbidden |
Esta operación está prohibida o la solicitud no está autorizada correctamente. |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro id de la solicitud. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de borrar la playlist especificada. Por ejemplo, no puedes borrar la playlist de videos que subiste. |
playlists.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
channelClosed |
Se cerró el canal especificado en el parámetro channelId . |
forbidden (403) |
channelSuspended |
Se suspendió el canal especificado en el parámetro channelId . |
forbidden (403) |
playlistForbidden |
La playlist identificada con el parámetro id de la solicitud no es compatible con la solicitud o la solicitud no está autorizada correctamente. |
notFound (404) |
channelNotFound |
No se puede encontrar el canal especificado en el parámetro channelId . |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro id de la solicitud. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de mostrar la playlist especificada. Por ejemplo, no puedes mostrar tu playlist de Ver más tarde. |
playlists.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
defaultLanguageNotSetError |
Se debe configurar defaultLanguage para actualizar localizations . |
badRequest (400) |
localizationValidationError |
Uno de los valores del objeto localizations no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos de playlists. |
badRequest (400) |
maxPlaylistExceeded |
No se puede crear la playlist porque el canal ya tiene la cantidad máxima permitida. |
forbidden (403) |
playlistForbidden |
Esta operación está prohibida o la solicitud no está autorizada correctamente. |
invalidValue (400) |
invalidPlaylistSnippet |
La solicitud proporciona un fragmento de una lista de reproducción no válido. |
required (400) |
playlistTitleRequired |
La solicitud debe especificar un título para la lista de reproducción. |
playlists.update
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
defaultLanguageNotSetError |
Se debe configurar defaultLanguage para actualizar localizations . |
badRequest (400) |
localizationValidationError |
Uno de los valores del objeto localizations no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos de playlists. |
forbidden (403) |
playlistForbidden |
Esta operación está prohibida o la solicitud no está autorizada correctamente. |
invalidValue (400) |
invalidPlaylistSnippet |
La solicitud proporciona un fragmento de una lista de reproducción no válido. |
invalidValue (400) |
playlistOperationUnsupported |
La API no admite la capacidad de actualizar la playlist especificada. Por ejemplo, no puedes actualizar las propiedades de la playlist de videos que subiste. |
notFound (404) |
playlistNotFound |
No se puede encontrar la playlist identificada con el parámetro id de la solicitud. |
required (400) |
playlistTitleRequired |
La solicitud debe especificar un título para la lista de reproducción. |
search
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de search
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
search.list
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
invalidChannelId |
El parámetro channelId especificó un ID de canal no válido. |
badRequest (400) |
invalidLocation |
El valor del parámetro location o locationRadius tiene un formato incorrecto. |
badRequest (400) |
invalidRelevanceLanguage |
El valor del parámetro relevanceLanguage tiene un formato incorrecto. |
badRequest (400) |
invalidSearchFilter |
La solicitud contiene una combinación no válida de filtros de búsqueda o restricciones. Debes establecer el parámetro type en video si configuras un valor para los parámetros eventType , videoCaption , videoCategoryId , videoDefinition , videoDimension , videoDuration , videoEmbeddable , videoLicense , videoSyndicated o videoType . |
suscripciones
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de subscriptions
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
subscriptions.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
subscriptionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
notFound (404) |
subscriptionNotFound |
No se puede encontrar la suscripción que intentas eliminar. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
subscriptions.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
subscriptionDuplicate |
La suscripción que intentas crear ya existe. |
badRequest (400) |
subscriptionForbidden |
Alcanzaste la cantidad máxima de suscripciones. |
badRequest (400) |
subscriptionForbidden |
Tienes demasiadas suscripciones recientes. Vuelve a intentarlo en unas horas. |
badRequest (400) |
subscriptionForbidden |
No se admite la suscripción a tu propio canal. |
forbidden (403) |
subscriptionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
notFound (404) |
publisherNotFound |
No se puede encontrar el recurso especificado por la propiedad snippet.resourceId de la solicitud. |
notFound (404) |
subscriberNotFound |
No se puede encontrar el suscriptor identificado con la solicitud. |
required (400) |
publisherRequired |
El recurso de suscripción especificado en la solicitud debe usar la propiedad snippet.resourceId para identificar el canal al que se suscribe. |
subscriptions.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
accountClosed |
No se pudieron recuperar las suscripciones porque la cuenta del suscriptor está cerrada. |
forbidden (403) |
accountSuspended |
No se pudieron recuperar las suscripciones porque la cuenta del suscriptor está suspendida. |
forbidden (403) |
subscriptionForbidden |
El solicitante no tiene permiso para acceder a las suscripciones solicitadas. |
notFound (404) |
subscriberNotFound |
No se puede encontrar el suscriptor identificado con la solicitud. |
Miniaturas
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de thumbnails
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
thumbnails.set
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
invalidImage |
El contenido de la imagen proporcionada no es válido. |
badRequest (400) |
mediaBodyRequired |
La solicitud no incluye el contenido de la imagen. |
forbidden (403) |
forbidden |
La miniatura no se puede establecer para el video especificado. Puede que la solicitud no esté debidamente autorizada. |
forbidden (403) |
forbidden |
El usuario autenticado no tiene permiso para subir y establecer miniaturas de video personalizadas. |
notFound (404) |
videoNotFound |
No se puede encontrar el video al que intentas insertar una imagen en miniatura. Verifica el valor del parámetro videoId de la solicitud para asegurarte de que sea correcto. |
tooManyRequests (429) |
uploadRateLimitExceeded |
El canal subió demasiadas miniaturas recientemente. Vuelve a intentar la solicitud más tarde. |
videoAbuseReportReasons
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de videoAbuseReportReasons
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
videoAbuseReportReasons.list
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
Acceso prohibido. Puede que la solicitud no esté debidamente autorizada. |
videoCategories
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de videoCategories
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
videoCategories.list
Tipo de error |
Detalle del error |
Descripción |
notFound (404) |
videoCategoryNotFound |
No se puede encontrar la categoría de video identificada por el parámetro id . Usa el método videoCategories.list para recuperar una lista de valores válidos. |
videos
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de videos
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.
videos.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
defaultLanguageNotSet |
La solicitud 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) |
invalidDescription |
Los metadatos de la solicitud especifican una descripción del video no válida. |
badRequest (400) |
invalidFilename |
El nombre de archivo de video especificado en el encabezado Slug no es válido. |
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) |
invalidVideoGameRating |
Los metadatos de la solicitud especifican una calificación de videojuego no válida. |
badRequest (400) |
invalidVideoMetadata |
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 ni snippet.categoryId . |
badRequest (400) |
mediaBodyRequired |
La solicitud no incluye el contenido del video. |
badRequest (400) |
uploadLimitExceeded |
El usuario superó la cantidad de videos que puede subir. |
forbidden (403) |
forbidden |
|
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. |
videos.list
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
videoChartNotFound |
El gráfico del video solicitado no es compatible o no está disponible. |
forbidden (403) |
forbidden |
La solicitud no está autorizada correctamente para acceder al archivo de video ni a la información de procesamiento. Las partes fileDetails , processingDetails y suggestions solo están disponibles para el propietario del video. |
forbidden (403) |
forbidden |
La solicitud no puede acceder a la información de calificación del usuario. Este error puede ocurrir porque la solicitud no está autorizada correctamente para usar el parámetro myRating . |
notFound (404) |
videoNotFound |
No se puede encontrar el video que intentas recuperar. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
videos.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
El video que intentas eliminar no se puede eliminar. Puede que la solicitud no esté debidamente autorizada. |
notFound (404) |
videoNotFound |
El video que intentas eliminar no se puede encontrar. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
videos.update
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 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. 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 ni snippet.categoryId . |
forbidden (403) |
forbidden |
Acceso prohibido Puede que la solicitud no esté debidamente autorizada. |
forbidden (403) |
forbiddenEmbedSetting |
La solicitud intenta establecer una configuración de incorporación no válida para el video. 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. |
videos.rate
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
emailNotVerified |
El usuario debe verificar su dirección de correo electrónico antes de calificar. |
badRequest (400) |
invalidRating |
La solicitud contenía un valor inesperado para el parámetro rating . |
badRequest (400) |
videoPurchaseRequired |
Solo los usuarios que alquilaron los videos pueden calificarlos. |
forbidden (403) |
forbidden |
El video que intentas calificar no se puede clasificar. Puede que la solicitud no esté debidamente autorizada. |
forbidden (403) |
videoRatingDisabled |
El propietario del video que intentas calificar inhabilitó las calificaciones para ese video. |
notFound (404) |
videoNotFound |
El video que intentas calificar no se puede encontrar. Verifica el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |
videos.reportAbuse
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
invalidAbuseReason |
La solicitud contenía un valor inesperado para el campo reason_id o una combinación de los campos reason_id y secondary_reason_id . |
badRequest (400) |
rateLimitExceeded |
El usuario envió demasiadas solicitudes en un período determinado. |
forbidden (403) |
forbidden |
|
notFound (404) |
videoNotFound |
No se puede encontrar el video por el que intentas denunciar un abuso. |
marcas de agua
En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de watermarks
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.
watermarks.set
Tipo de error |
Detalle del error |
Descripción |
badRequest (400) |
imageFormatUnsupported |
La imagen proporcionada tiene un formato que no es compatible. |
badRequest (400) |
imageTooTall |
La imagen proporcionada es demasiado alta. |
badRequest (400) |
imageTooWide |
La imagen proporcionada es demasiado ancha. |
badRequest (400) |
mediaBodyRequired |
La solicitud no incluye el contenido de la imagen. |
forbidden (403) |
forbidden |
La marca de agua no se puede establecer para el canal especificado. Es posible que la solicitud no esté autorizada correctamente o que el parámetro channelId tenga un valor no válido. |
watermarks.unset
Tipo de error |
Detalle del error |
Descripción |
forbidden (403) |
forbidden |
La marca de agua no se puede desactivar para el canal especificado. Es posible que la solicitud no esté autorizada correctamente o que el parámetro channelId tenga un valor no válido. |
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-02-06 (UTC)
[null,null,["Última actualización: 2025-02-06 (UTC)"],[[["The YouTube Data API commonly returns errors such as `forbidden (403)` for authorization issues, `badRequest (400)` for invalid requests, and `notFound (404)` for missing resources."],["Specific API methods like `activities`, `captions`, `channelBanners`, `channelSections`, `playlists`, and `videos` have unique error conditions, including missing parameters, content issues, and permission constraints."],["Errors related to channel management, such as creating, deleting, listing, or updating channel sections or playlists, often involve issues with invalid IDs, missing required fields, exceeding limits, or conflicting configurations."],["Comment and comment thread errors can arise from insufficient permissions, disabled commenting, character limits, private comments, or attempting to reply to non-existent parent comments."],["Errors related to video operations may include problems with category IDs, descriptions, titles, privacy settings, invalid licensing, missing content, exceeding upload limits, and improper reporting of abuse."]]],[]]
comentarios
comments.markAsSpam
.En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de
comments
. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la solicitud.comments.list
badRequest (400)
operationNotSupported
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
yparentId
de la solicitud para asegurarte de que sean correctos.comments.setModerationStatus
badRequest (400)
banWithoutReject
banAuthor
solo se puede usar si el valor del parámetromoderationStatus
esrejected
.badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
de la solicitud para asegurarte de que sean correctos.comments.insert
badRequest (400)
commentTextRequired
comment
que se inserta debe especificar un valor para la propiedadsnippet.textOriginal
. Los comentarios no pueden estar vacíos.badRequest (400)
commentTextTooLong
comment
que se inserta contiene demasiados caracteres en la propiedadsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
snippet.parentId
. En un recursocommentThread
, la propiedadsnippet.canReply
indica si el usuario actual puede responder la conversación.badRequest (400)
parentCommentIsPrivate
badRequest (400)
parentIdMissing
comment
en el cuerpo de la solicitud a la API no especificó un valor para la propiedadsnippet.parentId
.badRequest (400)
processingFailure
comment
en el cuerpo de la solicitud para asegurarte de que sea válida.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
parentCommentNotFound
snippet.parentId
en el cuerpo de la solicitud para asegurarte de que sea correcto.comments.delete
badRequest (400)
processingFailure
forbidden (403)
forbidden
notFound (404)
commentNotFound
id
de la solicitud para asegurarte de que sea correcto.comments.update
badRequest (400)
commentTextTooLong
comment
que se está actualizando contiene demasiados caracteres en la propiedadsnippet.textOriginal
.badRequest (400)
invalidCommentMetadata
badRequest (400)
operationNotSupported
badRequest (400)
processingFailure
comment
en el cuerpo de la solicitud para asegurarte de que sea válida.forbidden (403)
forbidden
forbidden (403)
ineligibleAccount
notFound (404)
commentNotFound
id
en el cuerpo de la solicitud para asegurarte de que sea correcto.