YouTube Data API - Errors

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.

1. Errores generales
2. activities
3. channelBanners
4. channels
5. guideCategories
6. playlistItems
7. playlists
8. search
9. subscriptions
10. thumbnails
11. videoCategories
12. 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 partes 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 identificada 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 identificado 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 identificado 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 identificar 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 identificada 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 identificada 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 video 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.