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.