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.

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 esté actuando en nombre de otra cuenta de Google, este error se refiere a este último punto.
forbidden (403) 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 (403) authenticatedUserNotChannel En esta solicitud, el usuario autenticado debe resolverse en un canal, pero no lo hace. Si tu solicitud está autenticada y utiliza 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 los alcances que son 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 por parte de 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 proporcionar el parámetro onBehalfOfContentOwnerChannel si está disponible para el método llamado a fin de actuar como uno de los canales del socio.
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 compatible.
unauthorized (401) authorizationRequired La solicitud usa el parámetro mine, pero no está debidamente autorizado.
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 agregar videos a una lista de reproducción de watch_later. Sin embargo, a modo de ejemplo, el usuario necesitaría un canal de YouTube para poder subir un video. Es seguro que un usuario que tiene una cuenta de Gmail o un dispositivo Android tiene una Cuenta de Google, pero es posible que no la haya vinculado a un canal de YouTube.

Este error suele ocurrir cuando se intenta usar el flujo de la cuenta de servicio de OAuth 2.0. YouTube no admite cuentas de servicio, por lo que si intentas autenticarte con una cuenta de servicio, recibirás este error.

La entrada de blog de la API de YouTube en la que se presenta la compatibilidad de la Cuenta de Google también analiza el error youtubeSignupRequired en 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 dio de baja la función de boletín 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 los recursos activities. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

activities.list

Tipo de error Detalle del error Descripción
forbidden (403) homeParameterDeprecated Los datos de actividad en la página principal del usuario no están disponibles a través de esta API. Este error puede ocurrir si estableces el parámetro home en true en una solicitud no autorizada.
forbidden (403) forbidden La solicitud no está debidamente autorizada.
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 página principal de YouTube para el usuario autenticado actualmente.
unauthorized (401) authorizationRequired La solicitud usa el parámetro home, pero no está debidamente autorizado.

captions

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos captions. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

captions.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden Los permisos asociados con la solicitud no son suficientes para eliminar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se encontró la pista de subtítulos. Comprueba 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. Es posible que la solicitud no esté debidamente autorizada o que el pedido del video no haya habilitado las contribuciones de terceros para estos subtítulos.
invalidValue (400) couldNotConvert No se pudieron convertir los datos de la pista de subtítulos al idioma o formato solicitado. Asegúrate de que los valores tfmt y tlang solicitados sean válidos y que el snippet.status de la pista de subtítulos solicitada no sea failed.
notFound (404) captionNotFound No se encontró la pista de subtítulos. Comprueba 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 incluye el contenido de la pista de subtítulos.
conflict (409) captionExists El video especificado ya tiene una pista de subtítulos con los valores snippet.language y snippet.name. Un video puede tener varias pistas para el mismo idioma, pero cada una debe tener un nombre distinto.

Existen varias formas de abordar el error. Puedes eliminar la pista existente y luego insertar una nueva o cambiar el nombre de la pista nueva 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.

captions.list

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No se pudieron recuperar una o más pistas 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 encontraron una o más de las pistas de subtítulos especificadas. Este error se produce si el parámetro videoId identifica un video real, pero el parámetro id identifica ID de pistas de subtítulos que no existen o ID 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 se configura el parámetro sync como 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 encontró la pista de subtítulos especificada. Comprueba 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 los recursos channelBanners. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

channelBanners.insert

Tipo de error Detalle del error Descripción
badRequest (400) bannerAlbumFull El álbum del diseño de tu 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.

canalSecciones

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos channelSections. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

channelSections.delete

Tipo de error Detalle del error Descripción
badRequest (400) notEditable No se puede borrar esta sección de 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 Se debe configurar la propiedad snippet.defaultLanguage del recurso channelSection para insertar o actualizar de forma correcta el objeto localizations de ese recurso.
badRequest (400) invalidLanguage Falló la validación de una de las claves de idioma del objeto localizations. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo 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 de canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry Se produjo un error en la validación de uno de los valores de la lista targeting.countries. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Se produjo un error en la validación de uno de los valores de la lista targeting.languages. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Se produjo un error en la validación de uno de los valores de la lista targeting.regions. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo 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 se especificaron 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 canales.
invalidValue (400) contentDetailsNeeded El recurso que insertas debe contener un objeto contentDetails para este tipo de sección de 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 intentó incluir demasiados canales en la sección de canales.
invalidValue (400) maxPlaylistExceeded La solicitud falló porque intentó incluir demasiadas listas de reproducción en la sección del canal.
invalidValue (400) onePlaylistNeeded Si la propiedad snippet.type tiene un valor de singlePlaylist, entonces la propiedad contentDetails.playlists[] debe especificar exactamente una lista de reproducción.
invalidValue (400) ownChannelInChannels No puedes incluir tu propio canal en una sección que aparece allí.
invalidValue (400) playlistIsPrivate Una o más de las listas de reproducción especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal.
invalidValue (400) playlistsDuplicated La solicitud falló porque especificaba listas de reproducción 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 listas de reproducción para este tipo de sección de 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 pudieron encontrar uno o más de los canales especificados.
notFound (404) playlistNotFound No se pueden encontrar una o más de las listas de reproducción 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 Se debe configurar la propiedad snippet.defaultLanguage del recurso channelSection para insertar o actualizar de forma correcta el objeto localizations de ese recurso.
badRequest (400) invalidLanguage Falló la validación de una de las claves de idioma del objeto localizations. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo 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 de canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry Se produjo un error en la validación de uno de los valores de la lista targeting.countries. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Se produjo un error en la validación de uno de los valores de la lista targeting.languages. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Se produjo un error en la validación de uno de los valores de la lista targeting.regions. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos siguiendo 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 se especificaron 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 canales.
invalidValue (400) contentDetailsNeeded El recurso que estás actualizando debe contener un objeto contentDetails para este tipo de sección de 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 de canal que se actualizará.
invalidValue (400) inValidPosition La propiedad snippet.position contiene un valor no válido.
invalidValue (400) maxChannelsExceeded La solicitud falló porque intentó incluir demasiados canales en la sección de canales.
invalidValue (400) maxPlaylistExceeded La solicitud falló porque intentó incluir demasiadas listas de reproducción en la sección del canal.
invalidValue (400) onePlaylistNeeded Si la propiedad snippet.type tiene un valor de singlePlaylist, entonces la propiedad contentDetails.playlists[] debe especificar exactamente una lista de reproducción.
invalidValue (400) ownChannelInChannels No puedes incluir tu propio canal en una sección que aparece allí.
invalidValue (400) playlistIsPrivate Una o más de las listas de reproducción especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal.
invalidValue (400) playlistsDuplicated La solicitud falló porque especificaba listas de reproducción 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 listas de reproducción para este tipo de sección de 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 pudieron 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 pueden encontrar una o más de las listas de reproducción especificadas.

canales

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos channels. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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 o forUsername. En el caso de la autenticación del propietario del contenido a través del parámetro onBehalfOfContentOwner, solo se pueden especificar id o managedByMe.
forbidden (403) channelForbidden El canal especificado por el parámetro id no admite la solicitud o la solicitud no está debidamente autorizada.
notFound (404) 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 (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 Falló 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 los lineamientos de la documentación del recurso channels.
badRequest (400) channelTitleUpdateForbidden Cuando actualices el brandingSettings part de un canal, debes omitir la propiedad o establecer el valor de la propiedad brandingSettings.channel.title en el título actual del canal. 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. Utiliza el método channels.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos en la documentación de recursos 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 invideoPromoción.
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 una compensación de tiempo no válida en la parte invideoPromoción.
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 Se produjo un error en la validación de uno de los valores del objeto de localización. Utiliza el método channels.list para recuperar los valores válidos y asegúrate de actualizarlos siguiendo las pautas indicadas en la documentación de recursos de los canales.
badRequest (400) tooManyPromotedItems Se superó la cantidad de elementos promocionados permitidos en la parte invideoPromoción.
forbidden (403) channelForbidden El canal especificado en el parámetro id no admite la solicitud o la solicitud no está debidamente autorizada.
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 El canal especificado por el parámetro id no se puede encontrar o no tiene opciones de marca.
notFound (404) channelNotFound No se puede encontrar el canal especificado en el parámetro id.
notFound (404) unknownChannelId No se encontró el ID del canal especificado.
notFound (404) unknownChannelId No se encontró el ID del canal recientementeUploadBy 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 elemento en la parte invideoPromoción.
required (400) requiredItemId Los metadatos de la solicitud deben especificar un ID de elemento en la parte invideoPromoción.
required (400) requiredTimingOffset Los metadatos de la solicitud deben especificar una equidistancia de sincronización predeterminada para que YouTube pueda determinar cuándo mostrar el elemento promovido. 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 invideoPromoción. Establece el valor de la propiedad invideoPromotion.items[].id.websiteUrl en el recurso que envía la solicitud.

Comentar Conversaciones

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos commentThreads. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

commentThreads.list

Tipo de error Detalle del error Descripción
badRequest (400) operationNotSupported El filtro de ID solo es compatible con los comentarios basados en Google+.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) commentsDisabled El video identificado por el parámetro videoId inhabilitó los comentarios.
forbidden (403) forbidden No se pueden recuperar una o más de las conversaciones de comentarios solicitadas porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
notFound (404) channelNotFound No se pudo encontrar el canal identificado por los parámetros channelId o allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound No se pueden encontrar una o más de las conversaciones de comentarios especificadas. Comprueba los valores del parámetro id de la solicitud para asegurarte de que sea correcto.
notFound (404) videoNotFound No se pudo encontrar el video identificado por el parámetro videoId.

commentThreads.insert

Tipo de error Detalle del error Descripción
badRequest (400) channelOrVideoIdMissing Cada conversación de comentarios debe estar vinculada a un canal o video.
  • Si el comentario se aplica a un canal, asegúrate de que el recurso especificado en el cuerpo de la solicitud proporcione un valor para la propiedad snippet.channelId. Los comentarios que corresponden a un canal aparecerán en la pestaña Debate del canal.
  • Si el comentario se aplica a un video, asegúrate de que el recurso especifique valores para las propiedades snippet.channelId y snippet.videoId. Un comentario que se aplica a un video aparece en la página de reproducción del video.
badRequest (400) commentTextRequired El recurso comment que se inserta debe especificar un valor para la propiedad snippet.topLevelComment.snippet.textOriginal. Los comentarios no pueden estar vacíos.
badRequest (400) commentTextTooLong El recurso comment que se inserta contiene demasiados caracteres en la propiedad snippet.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se pudo crear la conversación de comentarios porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se utiliza para autorizar la solicitud de la API se debe combinar con la cuenta de Google del usuario para insertar un comentario o una conversación de comentarios.
notFound (404) channelNotFound No se encontró el canal especificado. Comprueba el valor de la propiedad snippet.channelId para asegurarte de que sea correcto.
notFound (404) videoNotFound No se pudo encontrar el video especificado. Comprueba el valor de la propiedad snippet.videoId para asegurarte de que sea correcto.

comments

Ya no se admite el método comments.markAsSpam.

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos comments. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

comments.list

Tipo de error Detalle del error Descripción
badRequest (400) operationNotSupported El filtro de ID solo es compatible con los comentarios basados en Google+.
forbidden (403) forbidden No se pueden recuperar uno o más de los comentarios solicitados porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se encontraron uno o más de los comentarios especificados. Verifica los valores de los parámetros id y parentId de la solicitud para asegurarte de que sean correctos.

comments.setModerationStatus

Tipo de error Detalle del error Descripción
badRequest (400) banWithoutReject El parámetro banAuthor solo se puede usar si el valor del parámetro moderationStatus es rejected.
badRequest (400) operationNotSupported Los comentarios que no se basan en Google+ solo ofrecen una funcionalidad de moderación limitada.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se puede establecer el estado de moderación de uno o más comentarios debido a permisos insuficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se pueden encontrar uno o más de los comentarios que la solicitud intenta actualizar. Verifica los valores del parámetro id de la solicitud para asegurarte de que sean correctos.

comments.insert

Tipo de error Detalle del error Descripción
badRequest (400) commentTextRequired El recurso comment que se inserta debe especificar un valor para la propiedad snippet.textOriginal. Los comentarios no pueden estar vacíos.
badRequest (400) commentTextTooLong El recurso comment que se inserta contiene demasiados caracteres en la propiedad snippet.textOriginal.
badRequest (400) invalidCommentMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) operationNotSupported El usuario de la API no puede insertar un comentario en respuesta al comentario de nivel superior identificado por la propiedad snippet.parentId. En un recurso commentThread, la propiedad snippet.canReply indica si el lector actual puede responder al subproceso.
badRequest (400) parentCommentIsPrivate El comentario principal especificado es privado. La API no admite respuestas a comentarios privados.
badRequest (400) parentIdMissing El comentario que se inserta debe estar vinculado a un comentario principal. Sin embargo, el recurso comment en el cuerpo de la solicitud a la API no especificó un valor para la propiedad snippet.parentId.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso comment en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se puede crear el comentario porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se utiliza para autorizar la solicitud de la API se debe combinar con la cuenta de Google del usuario para insertar un comentario o una conversación de comentarios.
notFound (404) parentCommentNotFound No se encontró el comentario principal especificado. Comprueba el valor de la propiedad snippet.parentId en el cuerpo de la solicitud para asegurarte de que sea correcto.

comments.delete

Tipo de error Detalle del error Descripción
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se pudo borrar el comentario porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se pudo encontrar el comentario especificado. Comprueba el valor del parámetro id de la solicitud para asegurarte de que sea correcto.

comments.update

Tipo de error Detalle del error Descripción
badRequest (400) commentTextTooLong El recurso comment que se está actualizando contiene demasiados caracteres en la propiedad snippet.textOriginal.
badRequest (400) invalidCommentMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) operationNotSupported Solo se pueden actualizar los comentarios basados en Google+.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, generalmente indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso comment en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se pudo actualizar el comentario porque no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se utiliza para autorizar la solicitud de la API debe combinarse con la cuenta de Google del usuario para actualizar un comentario o una conversación de comentarios.
notFound (404) commentNotFound No se pudo encontrar el comentario especificado. Comprueba el valor de la propiedad id en el cuerpo de la solicitud para asegurarte de que sea correcto.

miembros.

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos members. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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 del canal.
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 venció el token de la página utilizado en la solicitud.
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.

Niveles de membresía

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos members. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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 del canal.

playlistItems

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos playlistItems. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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 lista de reproducción identificado con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de eliminar videos de la lista de reproducción especificada. Por ejemplo, no puedes borrar un video de la lista de reproducción de videos que subiste.

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 está debidamente autorizada para insertar el elemento de la lista de reproducción especificado.
invalidValue (400) invalidContentDetails La propiedad contentDetails de la solicitud no es válida. Un posible motivo es que el campo contentDetails.note supera los 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 se admite en esta operación. El ID de recurso identifica el elemento que se agrega a la lista de reproducción, por ejemplo, youtube#video.
invalidValue (400) manualSortRequired La solicitud intenta establecer la posición del elemento de la lista de reproducción, pero la lista de reproducción no utiliza la clasificación manual. (Por ejemplo, los elementos de una lista de reproducción pueden ordenarse por fecha o popularidad). Para solucionar el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la lista de reproducción tenga una posición determinada en la lista, primero debes actualizar la opción Orden de la lista de reproducción a Manual en la configuración de la lista de reproducción. Esta configuración se puede ajustar en el Administrador de videos de YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist El video que intentas agregar a la lista de reproducción ya está en otra lista de reproducción de series.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de insertar videos en la lista de reproducción especificada. Por ejemplo, no puedes insertar un video en la lista de reproducción de videos que subiste.
notFound (404) playlistNotFound No se puede encontrar la lista de reproducción 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. Comprueba 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 requerida.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId requerida.
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 lista de reproducción 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 requerida.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de mostrar videos en la lista de reproducción especificada. Por ejemplo, no puedes incluir un video en la lista de reproducción Ver más tarde.

playlistItems.update

Tipo de error Detalle del error Descripción
forbidden (403) playlistItemsNotAccessible La solicitud no está debidamente autorizada para actualizar el elemento de la lista de reproducción 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 se admite en esta operación. El ID de recurso identifica el elemento que se agrega a la lista de reproducción, por ejemplo, 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 lista de reproducción, pero la lista de reproducción no utiliza la clasificación manual. (Por ejemplo, los elementos de una lista de reproducción pueden ordenarse por fecha o popularidad). Para solucionar el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la lista de reproducción tenga una posición determinada en la lista, primero debes actualizar la opción Orden de la lista de reproducción a Manual en la configuración de la lista de reproducción. Esta configuración se puede ajustar en el Administrador de videos de YouTube.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de actualizar videos en la lista de reproducción especificada. Por ejemplo, no puedes actualizar un video en la lista de reproducción de videos que subiste.
notFound (404) playlistItemNotFound No se puede encontrar el elemento de la lista de reproducción identificado con la propiedad id de la solicitud.
notFound (404) playlistNotFound No se puede encontrar la lista de reproducción identificada con el parámetro playlistId de la solicitud.
required (400) channelIdRequired La solicitud no especifica un valor para la propiedad channelId requerida.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId requerida.
required (400) playlistItemIdRequired El recurso del elemento de la lista de reproducción especificado en la solicitud debe usar la propiedad id para identificar el elemento de la lista de reproducción que se está actualizando.

playlists

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos playlists. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

playlists.delete

Tipo de error Detalle del error Descripción
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está debidamente autorizada.
notFound (404) playlistNotFound No se puede encontrar la lista de reproducción identificada con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de eliminar la lista de reproducción especificada. Por ejemplo, no puedes borrar la lista de reproducción 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 lista de reproducción identificada con el parámetro id de la solicitud no la admite o esta no está debidamente autorizada.
notFound (404) channelNotFound No se puede encontrar el canal especificado en el parámetro channelId.
notFound (404) playlistNotFound No se puede encontrar la lista de reproducción identificada con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de mostrar la lista de reproducción especificada. Por ejemplo, no puedes agregar tu lista de reproducción 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 Se produjo un error en la validación de uno de los valores del objeto de localización. Utiliza el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo las pautas indicadas en la documentación de recursos de las listas de reproducción.
badRequest (400) maxPlaylistExceeded No se puede crear la lista de reproducción porque el canal ya tiene la cantidad máxima permitida de listas de reproducción.
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está debidamente autorizada.
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 Se produjo un error en la validación de uno de los valores del objeto de localización. Utiliza el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo las pautas indicadas en la documentación de recursos de las listas de reproducción.
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está debidamente autorizada.
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 lista de reproducción especificada. Por ejemplo, no puedes actualizar las propiedades de la lista de reproducción de videos que subiste.
notFound (404) playlistNotFound No se puede encontrar la lista de reproducción 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.

subscriptions

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos subscriptions. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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. 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 (400) subscriptionDuplicate La suscripción que intentas crear ya existe.
badRequest (400) subscriptionForbidden Alcanzaste la cantidad máxima de suscripciones.
badRequest (400) subscriptionForbidden Hay demasiadas suscripciones recientes. Vuelva a intentarlo en unas horas.
badRequest (400) subscriptionForbidden No es posible suscribirse 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 te estás suscribiendo.

subscriptions.list

Tipo de error Detalle del error Descripción
forbidden (403) accountClosed Las suscripciones no se pudieron recuperar porque la cuenta del suscriptor está cerrada.
forbidden (403) accountSuspended Las suscripciones no se pudieron recuperar porque la cuenta del suscriptor está suspendida.
forbidden (403) subscriptionForbidden El solicitante no está autorizado a acceder a las suscripciones solicitadas.
notFound (404) subscriberNotFound No se puede encontrar el suscriptor identificado con la solicitud.

thumbnails

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos thumbnails. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

thumbnails.set

Tipo de error Detalle del error Descripción
badRequest (400) invalidImage El contenido de la imagen proporcionado 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. Comprueba 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 realizar la solicitud más tarde.

videoAbuseReportMotivos

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con los recursos videoAbuseReportReasons. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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 los recursos videoCategories. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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. Utiliza 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 los recursos videos. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

videos.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSet La solicitud intenta agregar detalles 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 compatibles.
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 de los metadatos de la solicitud especifica detalles de registro 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 y 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á debidamente autorizada para acceder al archivo de video ni para procesar información. Ten en cuenta que las partes fileDetails, processingDetails y suggestions solo están disponibles para el propietario de ese 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á debidamente autorizada para usar el parámetro myRating.
notFound (404) videoNotFound No se puede encontrar el video que intentas recuperar. Comprueba 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. 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 (400) defaultLanguageNotSet La solicitud a la API intenta agregar detalles 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 compatibles.
badRequest (400) invalidDefaultBroadcastPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para la transmisión predeterminada.
badRequest (400) invalidDescription Los metadatos de la solicitud especifican una descripción del video no válida.
badRequest (400) invalidPublishAt Los metadatos de la solicitud especifican una hora de publicación programada no válida.
badRequest (400) invalidRecordingDetails El objeto recordingDetails de los metadatos de la solicitud especifica detalles de registro 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 y 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. Ten en cuenta que es posible que algunos canales no tengan permiso para ofrecer reproductores incorporados en transmisiones en vivo. Consulta el Centro de ayuda de YouTube para obtener más información.
forbidden (403) forbiddenLicenseSetting La solicitud intenta establecer una licencia no válida para el video.
forbidden (403) forbiddenPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para el video.
notFound (404) videoNotFound El vídeo que intentas actualizar no se puede encontrar. Comprueba el valor del campo id en el cuerpo de la solicitud para asegurarte de que sea correcto.

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 Los videos en alquiler solo pueden ser evaluados por los usuarios que los alquilaron.
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 de este.
notFound (404) 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.

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 sobre 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 los recursos watermarks. Estos métodos también pueden mostrar errores indicados en la sección Errores comunes.

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é debidamente autorizada o que el valor establecido del parámetro channelId no sea 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é debidamente autorizada o que el valor establecido del parámetro channelId no sea válido.