En este documento se identifican los diferentes tipos de errores que pueden mostrar las operaciones 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
- activities
- channelBanners
- channels
- guideCategories
- playlistItems
- playlists
- search
- subscriptions
- thumbnails
- videoCategories
- videos
Errores generales
Las tablas siguientes identifican los mensajes de error de la API que no son específicos a un método de API en particular.
Core API errors
Tipo de error |
Detalle del error |
Descripción |
forbidden |
forbidden |
Acceso prohibido. Puede que la solicitud no esté debidamente autorizada. |
quotaExceeded |
quotaExceeded |
La solicitud no se puede completar porque superaste tu cuota. |
Common request errors
Tipo de error |
Detalle del error |
Descripción |
badRequest |
incompatibleParameters |
La solicitud especifica dos o más parámetros que no se pueden utilizar en la misma solicitud. |
badRequest |
invalidFilters |
La solicitud especifica un parámetro de filtro no válido. |
badRequest |
invalidPageToken |
La solicitud especifica un token de página no válido. |
badRequest |
missingRequiredParameter |
A la solicitud le falta un parámetro obligatorio. |
badRequest |
unexpectedParameter |
La solicitud especifica un parámetro inesperado. |
forbidden |
accountDelegationForbidden |
El usuario autenticado no puede actuar en nombre de la cuenta de Google especificada. |
forbidden |
authenticatedUserAccountClosed |
La cuenta de YouTube del usuario autenticado está cerrada. En caso de que el usuario autenticado esté actuando en nombre de otra cuenta de Google, este error se refiere a este último punto. |
forbidden |
authenticatedUserAccountSuspended |
La cuenta de YouTube del usuario autenticado está suspendida. En caso de que el usuario autenticado esté actuando en nombre de otra cuenta de Google, este error se refiere a este último punto. |
forbidden |
authenticatedUserNotChannel |
En esta solicitud, el usuario autenticado debe resolverse en un canal, pero no lo hace. Si tu solicitud se autentica y utiliza el parámetro de delegación onBehalfOfContentOwner , entonces también debes establecer el parámetro onBehalfOfContentOwnerChannel . |
forbidden |
channelClosed |
El canal identificado en la solicitud se cerró. |
forbidden |
channelNotFound |
No se puede encontrar el canal identificado en la solicitud. |
forbidden |
channelSuspended |
El canal identificado en la solicitud se suspendió. |
forbidden |
cmsUserAccountNotFound |
No se permite al usuario de CMS actuar en nombre del propietario de contenido especificado. |
forbidden |
insufficientCapabilities |
El usuario CMS tiene capacidades insuficientes. |
notFound |
contentOwnerAccountNotFound |
No se encontró la cuenta del propietario del contenido especificada. |
Request context errors
Tipo de error |
Detalle del error |
Descripción |
badRequest |
invalidLanguage |
El valor del parámetro hl no especifica un código de idioma válido. |
badRequest |
invalidMine |
No se admite el uso del parámetro mine por parte de la solicitud. |
badRequest |
invalidPart |
El parámetro part de la solicitud especifica algunas part es que no se pueden escribir al mismo tiempo. |
badRequest |
invalidRegionCode |
El parámetro regionCode especifica un código de región no válido. |
badRequest |
unexpectedPart |
El parámetro part de la solicitud especifica un valor inesperado. |
badRequest |
unknownPart |
El parámetro part de la solicitud especifica un valor desconocido. |
badRequest |
unsupportedLanguageCode |
El valor del parámetro hl no especifica un código de idioma compatible. |
badRequest |
unsupportedRegionCode |
El parámetro regionCode especifica un código de región no compatible. |
unauthorized |
authorizationRequired |
La solicitud utiliza el parámetro mine , pero no está debidamente autorizado. |
unauthorized |
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 tener acceso a muchas funciones que dependen de la autorización del usuario, tales como calificar videos o agregar videos a una lista de reproducción 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 tiene sin lugar a dudas una cuenta de Google, pero es posible que no haya vinculado esa cuenta de Google a un canal de YouTube.
Este error generalmente se presenta si se intenta utilizar el flujo de la Cuenta de servicio de OAuth 2.0. YouTube no admite Cuentas de servicio, por lo que si intentas autenticar mediante una Cuenta de servicio, recibirás este error.
La entrada en el blog de API de YouTube que presenta la compatibilidad de la cuenta de Google también analiza el error de youtubeSignupRequired con mayor profundidad. 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
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos activities
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
activities.list
Tipo de error |
Detalle del error |
Descripción |
notFound |
channelNotFound |
No se puede encontrar el ID del canal identificado por el parámetro channelId de la solicitud. |
notFound |
homeChannelNotFound |
No se puede encontrar un feed de página principal de YouTube para el usuario autenticado actualmente. |
unauthorized |
authorizationRequired |
La solicitud utiliza el parámetro home , pero no está debidamente autorizado. |
activities.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest |
bulletinTextRequired |
La solicitud debe utilizar la propiedad description del objeto snippet para proporcionar el texto de la entrada de boletín. |
notFound |
playlistNotFound |
YouTube no puede encontrar el video que intentas asociar con la entrada de boletín. Comprueba el valor de la propiedad contentDetails.bulletinPosted.playlistId . |
notFound |
videoNotFound |
YouTube no puede encontrar el video que intentas asociar con la entrada de boletín. Comprueba el valor de la propiedad contentDetails.bulletinPosted.videoId . |
userRateLimitExceeded |
rateLimitExceeded |
La solicitud no se puede completar porque superaste tu cuota. |
channelBanners
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos channelBanners
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
channelBanners.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest |
mediaBodyRequired |
La solicitud no incluye el contenido de la imagen. |
channels
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos channels
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
channels.list
Tipo de error |
Detalle del error |
Descripción |
forbidden |
channelForbidden |
El canal especificado por el parámetro id no admite la solicitud o no está debidamente autorizada. |
notFound |
categoryNotFound |
No se puede encontrar la categoría identificada por el parámetro categoryId . Utiliza el método guideCategories.list para recuperar una lista de valores válidos. |
notFound |
channelNotFound |
No se puede encontrar el canal especificado en el parámetro id . |
channels.update
Tipo de error |
Detalle del error |
Descripción |
badRequest |
brandingValidationError |
Ocurrió un error en la validación de uno de los valores del objeto brandingSettings . Utiliza el método channels.list para recuperar la configuración existente del canal y actualiza los valores de la propiedad siguiendo las pautas de la documentación de recursos channels . |
badRequest |
invalidBrandingOption |
Una de las configuraciones del desarrollo de la marca que especificaste no existe. Utiliza el método channels.list para recuperar los valores válidos y asegúrate de actualizarlos siguiendo las pautas de la documentación de recursos channels . |
badRequest |
invalidCornerPosition |
Los metadatos de la solicitud especifican una posición de esquina no válida para identificar la ubicación en la que aparecerá el elemento promocionado. Comprueba el valor de la propiedad invideoPromotion.position.cornerPosition en el recurso que la solicitud envió. |
badRequest |
invalidItemType |
Los metadatos de la solicitud especifican un tipo de elemento no válido en la parte invideoPromotion. Comprueba el valor de la propiedad invideoPromotion.items[].type en el recurso que la solicitud envió. |
badRequest |
invalidPositionOffset |
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. Comprueba el valor de la propiedad invideoPromotion.position.type en el recurso que la solicitud envió. |
badRequest |
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. Comprueba el valor de la propiedad invideoPromotion.timing.offsetMs en el recurso que la solicitud envió. |
badRequest |
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. Comprueba el valor de la propiedad invideoPromotion.timing.type en el recurso que la solicitud envió. |
forbidden |
channelForbidden |
El canal especificado en el parámetro id no admite la solicitud o la solicitud no está debidamente autorizada. |
notFound |
channelNotFound |
El canal especificado por el parámetro id no se puede encontrar o no tiene opciones de marca. |
notFound |
unknownChannelId |
No se puede encontrar el canal que la solicitud de la API está intentando actualizar. Comprueba el valor de la propiedad id en el recurso channel que la solicitud envió para asegurarte de que el ID del canal es correcto. |
notFound |
unknownVideoId |
No se puede encontrar la identificación de video especificada como un elemento promovido. |
required |
requiredCornerPosition |
Los metadatos de la solicitud deben especificar una posición de esquina para que YouTube pueda determinar dónde mostrar el elemento promovido en el reproductor. Establece el valor de la propiedad invideoPromotion.position.cornerPosition en el recurso que la solicitud envía. |
required |
requiredItemType |
Los metadatos de la solicitud deben especificar el tipo de elemento promovido. Establece el valor de la propiedad invideoPromotion.items[].type en el recurso que la solicitud envía. |
required |
requiredPositionOffset |
Los metadatos de la solicitud deben especificar un tipo de posición para que YouTube pueda determinar cómo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.position.type en el recurso que la solicitud envía. |
required |
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 la solicitud envía. |
required |
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 la solicitud envía. |
required |
requiredVideoId |
Los metadatos de la solicitud deben especificar una identificación de video para identificar el elemento promovido. |
guideCategories
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos guideCategories
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
guideCategories.list
Tipo de error |
Detalle del error |
Descripción |
notFound |
notFound |
No se puede encontrar la categoría guía id entificada por el parámetro id . Utiliza el método guideCategories.list para recuperar una lista de valores válidos. |
playlistItems
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos playlistItems
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
playlistItems.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden |
playlistItemsNotAccessible |
La solicitud no está debidamente autorizada para eliminar el elemento de la lista de reproducción especificada. |
notFound |
playlistItemNotFound |
No se puede encontrar el elemento de la lista de reproducción id entificado con el parámetro id de la solicitud. |
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 |
playlistContainsMaximumNumberOfVideos |
La lista de reproducción ya contiene el número máximo permitido de elementos. |
invalidValue |
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. Comprueba el valor de la propiedad de position en el snippet del recurso. |
invalidValue |
invalidResourceType |
El type especificado para el ID de recurso no se admite en esta operación. El ID identifica el elemento que se agrega a la lista de reproducción, por ejemplo, youtube#video . |
notFound |
playlistNotFound |
No se puede encontrar la lista de reproducción identificada con el parámetro playlistId de la solicitud. |
notFound |
videoNotFound |
El video que intentas agregar a la lista de reproducción no se puede encontrar. Comprueba el valor de la propiedad videoId para asegurarte de que sea correcto. |
required |
channelIdRequired |
La solicitud no especifica un valor para la propiedad channelId requerida. |
required |
playlistIdRequired |
La solicitud no especifica un valor para la propiedad playlistId requerida. |
required |
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 |
playlistItemsNotAccessible |
La solicitud no está debidamente autorizada para recuperar la lista de reproducción especificada. |
notFound |
playlistNotFound |
No se puede encontrar la lista de reproducción identificada con el parámetro playlistId de la solicitud. |
notFound |
videoNotFound |
No se puede encontrar el video identificado con el parámetro videoId de la solicitud. |
required |
playlistIdRequired |
La solicitud de suscripción no especifica un valor para la propiedad playlistId requerida. |
playlistItems.update
Tipo de error |
Detalle del error |
Descripción |
invalidValue |
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. Comprueba el valor de la propiedad de position en el snippet del recurso. |
invalidValue |
invalidResourceType |
El type especificado para el ID de recurso no se admite en esta operación. El ID identifica el elemento que se agrega a la lista de reproducción, por ejemplo, youtube#video . |
invalidValue |
invalidSnippet |
La solicitud no especifica una propiedad snippet válida. |
notFound |
playlistItemNotFound |
No se puede encontrar el elemento id entificado de la lista de reproducción con la propiedad id de la solicitud. |
notFound |
playlistNotFound |
No se puede encontrar la lista de reproducción identificada con el parámetro playlistId de la solicitud. |
required |
channelIdRequired |
La solicitud no especifica un valor para la propiedad channelId requerida. |
required |
playlistIdRequired |
La solicitud no especifica un valor para la propiedad playlistId requerida. |
required |
playlistItemIdRequired |
El recurso del elemento de la lista de reproducción especificado en la solicitud debe utilizar la propiedad id para id entificar el elemento de la lista de reproducción que se está actualizando. |
playlists
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos playlists
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
playlists.delete
Tipo de error |
Detalle del error |
Descripción |
notFound |
playlistNotFound |
No se puede encontrar la lista de reproducción id entificada con el parámetro id de la solicitud. |
playlists.insert
Tipo de error |
Detalle del error |
Descripción |
invalidValue |
invalidPlaylistSnippet |
La solicitud proporciona un fragmento de una lista de reproducción no válido. |
required |
playlistTitleRequired |
La solicitud debe especificar un título para la lista de reproducción. |
playlists.update
Tipo de error |
Detalle del error |
Descripción |
invalidValue |
invalidPlaylistSnippet |
La solicitud proporciona un fragmento de una lista de reproducción no válido. |
notFound |
playlistNotFound |
No se puede encontrar la lista de reproducción id entificada con el parámetro id de la solicitud. |
required |
playlistTitleRequired |
La solicitud debe especificar un título para la lista de reproducción. |
search
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos search
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
search.list
Tipo de error |
Detalle del error |
Descripción |
badRequest |
invalidSearchFilter |
La solicitud contiene una combinación no válida de filtros de búsqueda o restricciones. |
badRequest |
invalidVideoId |
El parámetro relatedToVideo especifica una identificación de video no válida. |
subscriptions
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos subscriptions
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
subscriptions.delete
Tipo de error |
Detalle del error |
Descripción |
badRequest |
accountClosed |
La cuenta que intenta crear la suscripción se cerró. |
badRequest |
accountSuspended |
La cuenta que intenta crear la suscripción se suspendió. |
forbidden |
subscriptionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
notFound |
subscriptionNotFound |
No se puede encontrar la suscripción que intentas eliminar. Comprueba 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 |
accountClosed |
La cuenta que intenta crear la suscripción se cerró. |
badRequest |
accountSuspended |
La cuenta que intenta crear la suscripción se suspendió. |
badRequest |
subscriptionDuplicate |
La suscripción que intentas crear ya existe. |
forbidden |
subscriptionForbidden |
La solicitud no se autenticó correctamente o no es compatible con este canal. |
notFound |
publisherNotFound |
No se puede encontrar el recurso especificado por la propiedad snippet.resourceId de la solicitud. |
notFound |
subscriberNotFound |
No se puede encontrar el suscriptor identificado con la solicitud. |
required |
publisherRequired |
El recurso de suscripción especificado en la solicitud debe utilizar la propiedad snippet.resourceId para identificar el canal al que te estás suscribiendo. |
subscriptions.list
Tipo de error |
Detalle del error |
Descripción |
forbidden |
accountClosed |
Las suscripciones no se pudieron recuperar porque la cuenta del suscriptor está cerrada. |
forbidden |
accountSuspended |
Las suscripciones no se pudieron recuperar porque la cuenta del suscriptor está suspendida. |
forbidden |
subscriptionForbidden |
El solicitante no está autorizado a acceder a las suscripciones solicitadas. |
notFound |
subscriberNotFound |
No se puede encontrar el suscriptor identificado con la solicitud. |
thumbnails
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos thumbnails
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
thumbnails.set
Tipo de error |
Detalle del error |
Descripción |
badRequest |
mediaBodyRequired |
La solicitud no incluye el contenido de la imagen. |
forbidden |
forbidden |
El usuario autenticado no tiene permiso para subir y establecer miniaturas de video personalizadas. |
forbidden |
forbidden |
La miniatura no se puede establecer para el video especificado. Puede que la solicitud no esté debidamente autorizada. |
notFound |
videoNotFound |
No se puede encontrar el video al que intentas insertar una imagen en miniatura. Comprueba el valor del parámetro videoId de la solicitud para asegurarte de que sea correcto. |
videoCategories
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos videoCategories
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
videoCategories.list
Tipo de error |
Detalle del error |
Descripción |
notFound |
videoCategoryNotFound |
No se puede encontrar la categoría de vid eo identificada por el parámetro id . Utiliza el método videoCategories.list para recuperar una lista de valores válidos. |
videos
Las tablas siguientes identifican los mensajes de error que la API muestra en respuesta a invocaciones relacionadas con los recursos videos
. Estos métodos también podrían mostrar errores indicados en la sección Errores comunes.
videos.insert
Tipo de error |
Detalle del error |
Descripción |
badRequest |
invalidCategoryId |
La propiedad snippet.categoryId especifica un ID de categoría no válido. Utiliza el método videoCategories.list para recuperar las categorías admitidas. |
badRequest |
invalidDescription |
Los metadatos de la solicitud especifican una descripción del video no válida. |
badRequest |
invalidFilename |
El nombre del archivo de video especificado en el encabezado de Slug no es válido. |
badRequest |
invalidRecordingDetails |
El objeto recordingDetails en los metadatos de la solicitud especifica detalles de registro no válidos. |
badRequest |
invalidTags |
Los metadatos de la solicitud especifican palabras clave de video no válidas. |
badRequest |
invalidTitle |
Los metadatos de la solicitud especifican un título de video no válido. |
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. |
badRequest |
mediaBodyRequired |
La solicitud no incluye el contenido del video. |
forbidden |
forbiddenLicenseSetting |
La solicitud intenta establecer una licencia no válida para el video. |
forbidden |
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 |
videoChartNotFound |
El gráfico del video solicitado no es compatible o no está disponible. |
forbidden |
forbidden |
La solicitud no puede acceder a la información de calificación del usuario. Este error puede deberse a que la solicitud no está debidamente autorizada para utilizar el parámetro myRating . |
videos.delete
Tipo de error |
Detalle del error |
Descripción |
forbidden |
forbidden |
El video que intentas eliminar no se puede eliminar. Puede que la solicitud no esté debidamente autorizada. |
notFound |
videoNotFound |
El video que intentas eliminar no se puede encontrar. Comprueba 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 |
invalidRequest |
Los metadatos de la solicitud no son válidos. |
forbidden |
forbidden |
|
forbidden |
forbiddenLicenseSetting |
La solicitud intenta establecer una licencia no válida para el video. |
forbidden |
forbiddenPrivacySetting |
La solicitud intenta establecer una configuración de privacidad no válida para el video. |
notFound |
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. |
videos.rate
Tipo de error |
Detalle del error |
Descripción |
forbidden |
forbidden |
El video que intentas calificar no se puede clasificar. Puede que la solicitud no esté debidamente autorizada. |
notFound |
videoNotFound |
El video que intentas calificar no se puede encontrar. Comprueba el valor del parámetro id de la solicitud para asegurarte de que sea correcto. |