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 usa el parámetro de delegación onBehalfOfContentOwner, también debes configurar el parámetro onBehalfOfContentOwnerChannel.
forbidden (403) channelClosed El canal identificado en la solicitud se cerró.
forbidden (403) channelNotFound No se puede encontrar el canal identificado en la solicitud.
forbidden (403) channelSuspended El canal identificado en la solicitud se suspendió.
forbidden (403) cmsUserAccountNotFound No se permite al usuario de CMS actuar en nombre del propietario de contenido especificado.
forbidden (403) insufficientCapabilities El usuario CMS tiene capacidades insuficientes.
forbidden (403) insufficientPermissions El token de OAuth 2.0 proporcionado para la solicitud especifica los alcances que no son suficientes 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 bien 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. Esos usuarios pueden acceder a muchas funciones que dependen de la autorización del usuario, como calificar videos o agregar videos a una playlist de watch_later. Sin embargo, a modo de ejemplo, el usuario necesitaría un canal de YouTube para poder subir un video. Un usuario que tiene una cuenta de Gmail o un dispositivo Android tiene certeza de que tiene una Cuenta de Google, pero puede que aún no la haya vinculado a un canal de YouTube.

Este error se suele ver si intentas 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 asistencia para cuentas 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 ha dejado de usar la función de boletín de canales. 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 podrían 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 de 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 podrían 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 ha encontrado 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. Puede que la solicitud no esté debidamente autorizada o que el orden 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 ha encontrado 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 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 solucionar 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 la creación de la pista. Confirma que la solicitud especifique valores válidos para las propiedades snippet.language, snippet.name y snippet.videoId. También se puede incluir la propiedad snippet.isDraft, pero no es obligatoria.
notFound (404) videoNotFound No se pudo encontrar el video identificado por el parámetro videoId.
invalidValue (400) nameTooLong El snippet.name especificado en la solicitud es demasiado largo. La longitud máxima admitida es de 150 caracteres.

captions.list

Tipo de error Detalle del error Descripción
forbidden (403) forbidden No fue posible 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 ocurre si el parámetro videoId identifica un video real, pero el parámetro id identifica IDs de pistas de subtítulos que no existen o IDs de pistas asociados con otros videos. Comprueba los valores de los parámetros id y videoId de la solicitud para asegurarte de que sean correctos.
notFound (404) videoNotFound No se pudo encontrar el video identificado por el parámetro videoId.

captions.update

Tipo de error Detalle del error Descripción
badRequest (400) contentRequired La solicitud no subió un archivo de subtítulos actualizado. El contenido real de la pista es obligatorio si el parámetro sync se establece en true.
forbidden (403) forbidden Los permisos asociados con la solicitud no son suficientes para actualizar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se 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 podrían 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.

channelSections

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 podrían 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 del canal.
forbidden (403) channelSectionForbidden La solicitud no se autenticó correctamente o no es compatible con este canal.
invalidValue (400) idInvalid La propiedad id especifica un ID de sección de canal no válido.
invalidValue (400) idRequired La propiedad id debe especificar un valor que identifique la sección del canal que se borrará.
notFound (404) channelNotFound No se encontró el canal.
notFound (404) channelSectionNotFound No se puede encontrar la sección del canal que intentas actualizar.

channelSections.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError Se debe configurar la propiedad snippet.defaultLanguage del recurso channelSection para insertar o actualizar correctamente el objeto localizations de ese recurso.
badRequest (400) invalidLanguage No se pudo validar una de las claves de lenguaje del objeto localizations. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable No se puede crear esta sección del canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry No se pudo validar uno de los valores de la lista targeting.countries. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage No se pudo validar uno de los valores de la lista targeting.languages. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion No se pudo validar uno de los valores de la lista targeting.regions. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired El recurso channelSection debe especificar un valor para el campo snippet.type.
forbidden (403) channelSectionForbidden La solicitud no se autenticó correctamente o no es compatible con este canal.
invalidValue (400) channelNotActive Al menos uno de los canales especificados no está activo.
invalidValue (400) channelsDuplicated La solicitud falló porque especificó canales duplicados.
invalidValue (400) channelsNeeded Si la propiedad snippet.type tiene un valor de multipleChannels, se debe especificar la propiedad contentDetails.channels[], que debe especificar 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 alcanzó 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 playlists en la sección del canal.
invalidValue (400) onePlaylistNeeded Si la propiedad snippet.type tiene el valor singlePlaylist, la propiedad contentDetails.playlists[] debe especificar exactamente una playlist.
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 playlists especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal.
invalidValue (400) playlistsDuplicated La solicitud falló porque especificó playlists duplicadas.
invalidValue (400) playlistsNeeded Si la propiedad snippet.type tiene un valor de singlePlaylist o multiplePlaylists, se debe especificar la propiedad contentDetails.playlists[].
invalidValue (400) playlistsNotExpected El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.playlists[], pero no se esperan playlists para este tipo de sección 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 pudo encontrar uno o más de los canales especificados.
notFound (404) playlistNotFound No se puede encontrar una o más de las playlists especificadas.

channelSections.list

Tipo de error Detalle del error Descripción
forbidden (403) channelSectionForbidden El solicitante no tiene permiso para acceder a las secciones de los canales solicitados.
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 correctamente el objeto localizations de ese recurso.
badRequest (400) invalidLanguage No se pudo validar una de las claves de lenguaje del objeto localizations. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) notEditable No se puede editar esta sección del canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry No se pudo validar uno de los valores de la lista targeting.countries. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage No se pudo validar uno de los valores de la lista targeting.languages. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion No se pudo validar uno de los valores de la lista targeting.regions. Utiliza el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso de a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) typeRequired El recurso channelSection debe especificar un valor para el campo snippet.type.
forbidden (403) channelSectionForbidden La solicitud no se autenticó correctamente o no es compatible con este canal.
invalidValue (400) channelNotActive Al menos uno de los canales especificados no está activo.
invalidValue (400) channelsDuplicated La solicitud falló porque especificó canales duplicados.
invalidValue (400) channelsNeeded Si la propiedad snippet.type tiene un valor de multipleChannels, se debe especificar la propiedad contentDetails.channels[], que debe especificar 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 del canal que se está actualizando.
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 playlists en la sección del canal.
invalidValue (400) onePlaylistNeeded Si la propiedad snippet.type tiene el valor singlePlaylist, la propiedad contentDetails.playlists[] debe especificar exactamente una playlist.
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 playlists especificadas son privadas y, por lo tanto, no se pueden incluir en la sección del canal.
invalidValue (400) playlistsDuplicated La solicitud falló porque especificó playlists duplicadas.
invalidValue (400) playlistsNeeded Si la propiedad snippet.type tiene un valor de singlePlaylist o multiplePlaylists, se debe especificar la propiedad contentDetails.playlists[].
invalidValue (400) playlistsNotExpected El recurso proporcionado con la solicitud especificó un valor para la propiedad contentDetails.playlists[], pero no se esperan playlists para este tipo de sección 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 pudo encontrar uno o más de los canales especificados.
notFound (404) channelSectionNotFound No se puede encontrar la sección del canal que intentas actualizar.
notFound (404) playlistNotFound No se puede encontrar una o más de las playlists especificadas.

canales

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con 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
badRequest (400) invalidCriteria Se puede especificar un máximo de uno de los siguientes filtros:id, mySubscribers, categoryId, mine, managedByMe, 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 en 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 No se pudo validar uno de los valores del objeto brandingSettings. Usa el método channels.list para recuperar la configuración existente del canal y actualiza los valores de las propiedades según los lineamientos de la documentación del recurso channels.
badRequest (400) channelTitleUpdateForbidden Cuando actualizas 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 que actualice localizations.
badRequest (400) invalidBrandingOption Una de las configuraciones del desarrollo de la marca que especificaste no existe. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos según los lineamientos de la documentación del recurso channels.
badRequest (400) invalidCustomMessage Los metadatos de la solicitud especifican un mensaje personalizado no válido. Verifica el valor de la propiedad invideoPromotion.items[].customMessage en el recurso que envió la solicitud.
badRequest (400) invalidDuration Los metadatos de la solicitud especifican una duración no válida en la parte invideoPromotion.
badRequest (400) invalidDuration Los metadatos de la solicitud especifican un tipo de posición no válido para determinar cómo el elemento promovido se ubica en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.position.type en el recurso que envió la solicitud.
badRequest (400) invalidRecentlyUploadedBy Los metadatos de la solicitud especifican un ID de canal no válido. Verifica el valor de la propiedad invideoPromotion.items[].id.recentlyUploadedBy en el recurso que envió la solicitud.
badRequest (400) invalidTimingOffset Los metadatos de la solicitud especifican un intervalo de tiempo no válido en la parte invideoPromotion.
badRequest (400) invalidTimingOffset Los metadatos de la solicitud especifican una equidistancia de sincronización no válida para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.timing.offsetMs en el recurso que envió la solicitud.
badRequest (400) invalidTimingType Los metadatos de la solicitud especifican un método de sincronización no válido para determinar cuándo el elemento promovido debe mostrarse en el reproductor de video. Verifica el valor de la propiedad invideoPromotion.timing.type en el recurso que envió la solicitud.
badRequest (400) localizationValidationError Falló la validación de uno de los valores del objeto de localización. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos de canales.
badRequest (400) tooManyPromotedItems Se superó la cantidad de elementos promocionados permitidos en la parte invideoPromotion.
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 recientemente subido por 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 invideoPromotion.
required (400) requiredItemId Los metadatos de la solicitud deben especificar un ID de elemento en la parte invideoPromotion.
required (400) requiredTimingOffset Los metadatos de la solicitud deben especificar una compensación de tiempo predeterminada para que YouTube pueda determinar cuándo mostrar el elemento promocionado. Establece el valor de la propiedad invideoPromotion.defaultTiming.offsetMs en el recurso que envía la solicitud.
required (400) requiredTimingOffset Los metadatos de la solicitud deben especificar una equidistancia de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.timing.offsetMs en el recurso que envía la solicitud.
required (400) requiredTimingType Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.defaultTiming.type en el recurso que envía la solicitud.
required (400) requiredTimingType Los metadatos de la solicitud deben especificar un método de sincronización para que YouTube pueda determinar cuándo mostrar el elemento promovido. Establece el valor de la propiedad invideoPromotion.timing.type en el recurso que envía la solicitud.
required (400) requiredTiming Los metadatos de la solicitud deben especificar un tiempo para cada elemento de la parte invideoPromotion.
required (400) requiredVideoId Los metadatos de la solicitud deben especificar una identificación de video para identificar el elemento promocionado.
required (400) requiredWebsiteUrl Los metadatos de la solicitud deben especificar una URL de sitio web en la parte invideoPromotion. Establece el valor de la propiedad invideoPromotion.items[].id.websiteUrl en el recurso que envía la solicitud.

commentThreads

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 podrían 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 de 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álido.
forbidden (403) commentsDisabled Se inhabilitaron los comentarios en el video identificado por el parámetro videoId.
forbidden (403) forbidden No se pueden recuperar una o más 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 relacionados con un canal aparecen 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 está insertando 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álido.
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 utilizada para autorizar la solicitud a la API debe combinarse con la cuenta de Google del usuario para insertar un comentario o una conversación de comentarios.
notFound (404) channelNotFound No se pudo encontrar el canal especificado. Verifica el valor de la propiedad snippet.channelId para asegurarte de que sea correcto.
notFound (404) videoNotFound No se pudo encontrar el video especificado. Verifica 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 podrían 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 de 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 pueden encontrar uno o más de los comentarios especificados. Comprueba 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+ 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 porque no tienes los permisos necesarios. 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. Comprueba 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 está insertando 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 visualizador 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 insertará 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álido.
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 utilizada para autorizar la solicitud a la API debe combinarse con la cuenta de Google del usuario para insertar un comentario o una conversación de comentarios.
notFound (404) parentCommentNotFound No se pudo encontrar 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álido.
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 utilizada para autorizar la solicitud a la API debe combinarse con la cuenta de Google del usuario para actualizar un comentario o una conversación.
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 podrían mostrar errores indicados en la sección Errores comunes.

members.list

Tipo de error Detalle del error Descripción
badRequest (400) channelMembershipsNotEnabled El canal 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 que se especificó.
badRequest (400) invalidPageToken El valor del parámetro pageToken no es válido. Este error ocurre si el token de la página utilizado en la solicitud caducó.
badRequest (400) invalidHasAccessToLevel El valor del parámetro hasAccessToLevel no es válido. No hay ningún nivel con el id especificado.
badRequest (400) invalidFilterByMemberChannelId El valor del parámetro filterByMemberChannelId no es válido. Este error se produce si el valor del parámetro filterByMemberChannelId especifica más de 100 canales.

membershipsLevels

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

membershipsLevels.list

Tipo de error Detalle del error Descripción
badRequest (400) channelMembershipsNotEnabled El canal 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 podrían 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 playlist identificado con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de eliminar videos de la playlist especificada. Por ejemplo, no puedes borrar un video de la playlist 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 playlist 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 playlist; 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 ordenación manual. (Por ejemplo, los elementos de las listas de reproducción pueden ordenarse por fecha o popularidad). Para abordar el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la playlist tenga una posición determinada en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Esta configuración se puede ajustar en el Administrador de videos de YouTube.
invalidValue (400) videoAlreadyInAnotherSeriesPlaylist El video que intentas agregar a la playlist ya está en otra playlist de series.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de insertar videos en la playlist especificada. Por ejemplo, no puedes insertar un video en la playlist de videos que subiste.
notFound (404) playlistNotFound No se puede encontrar la playlist identificada con el parámetro playlistId de la solicitud.
notFound (404) videoNotFound El video que intentas agregar a la lista de reproducción no se puede encontrar. 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 playlist identificada con el parámetro playlistId de la solicitud.
notFound (404) videoNotFound No se puede encontrar el video identificado con el parámetro videoId de la solicitud.
required (400) playlistIdRequired La solicitud de suscripción no especifica un valor para la propiedad playlistId requerida.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de mostrar videos en la playlist especificada. Por ejemplo, no puedes incluir un video en la playlist 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 playlist especificada.
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 playlist; 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 ordenación manual. (Por ejemplo, los elementos de las listas de reproducción pueden ordenarse por fecha o popularidad). Para abordar el error, quita el elemento snippet.position del recurso que inserta la solicitud. Si quieres que el elemento de la playlist tenga una posición determinada en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. 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 playlist especificada. Por ejemplo, no puedes actualizar un video en la playlist de videos que subiste.
notFound (404) playlistItemNotFound No se puede encontrar el elemento de la playlist identificado con la propiedad id de la solicitud.
notFound (404) playlistNotFound No se puede encontrar la playlist identificada con el parámetro playlistId de la solicitud.
required (400) channelIdRequired La solicitud no especifica un valor para la propiedad channelId requerida.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId requerida.
required (400) playlistItemIdRequired El recurso del elemento de la playlist especificado en la solicitud debe utilizar la propiedad id para identificar el elemento de la playlist que se actualiza.

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 podrían 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 playlist identificada con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de eliminar la playlist especificada. Por ejemplo, no puedes borrar la playlist de videos que subiste.

playlists.list

Tipo de error Detalle del error Descripción
forbidden (403) channelClosed Se cerró el canal especificado en el parámetro channelId.
forbidden (403) channelSuspended El canal especificado en el parámetro channelId se suspendió.
forbidden (403) playlistForbidden La playlist identificada con el parámetro id de la solicitud no admite la solicitud 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 playlist 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 la playlist Ver más tarde.

playlists.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError Se debe configurar defaultLanguage para que actualice localizations.
badRequest (400) localizationValidationError Falló 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 en la documentación de recursos de las playlists.
badRequest (400) maxPlaylistExceeded No se puede crear la playlist porque el canal ya alcanzó el número máximo de playlists permitidas.
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 que actualice localizations.
badRequest (400) localizationValidationError Falló 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 en la documentación de recursos de las playlists.
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 playlist especificada. Por ejemplo, no puedes actualizar las propiedades de la playlist de videos que subiste.
notFound (404) playlistNotFound No se puede encontrar la playlist identificada con el parámetro id de la solicitud.
required (400) playlistTitleRequired La solicitud debe especificar un título para la lista de reproducción.

suscripciones

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 podrían 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 utilizar la propiedad snippet.resourceId para identificar el canal al que te estás sucribiendo.

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 podrían 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 proporcionada no es válido.
badRequest (400) mediaBodyRequired La solicitud no incluye el contenido de la imagen.
forbidden (403) forbidden La miniatura no se puede establecer para el video especificado. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) forbidden El usuario autenticado no tiene permiso para subir y establecer miniaturas de video personalizadas.
notFound (404) videoNotFound No se puede encontrar el video al que intentas insertar una imagen en miniatura. 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.

videoAbuseReportReasons

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 podrían 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 podrían 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 podrían 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 del video sin especificar el idioma predeterminado de los detalles del video.
badRequest (400) invalidCategoryId La propiedad snippet.categoryId especifica un ID de categoría no válido. Usa el método videoCategories.list para recuperar las categorías admitidas.
badRequest (400) invalidDescription Los metadatos de la solicitud especifican una descripción del video no válida.
badRequest (400) invalidFilename El nombre de archivo de video especificado en el encabezado Slug no es válido.
badRequest (400) invalidPublishAt Los metadatos de la solicitud especifican una hora de publicación programada no válida.
badRequest (400) invalidRecordingDetails El objeto recordingDetails en los metadatos de la solicitud especifica detalles de 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 vacío o no válido.
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 ocurre 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 o procesar la información. Ten en cuenta que las partes fileDetails, processingDetails y suggestions solo están disponibles para el propietario del video.
forbidden (403) forbidden La solicitud no puede acceder a la información de calificación del usuario. Este error puede ocurrir porque la solicitud no está 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 del video sin especificar el idioma predeterminado de los detalles del video.
badRequest (400) invalidCategoryId La propiedad snippet.categoryId especifica un ID de categoría no válido. Usa el método videoCategories.list para recuperar las categorías admitidas.
badRequest (400) invalidDefaultBroadcastPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para la transmisión predeterminada.
badRequest (400) invalidDescription Los metadatos de la solicitud especifican una descripción del video no válida.
badRequest (400) invalidPublishAt Los metadatos de la solicitud especifican una hora de publicación programada no válida.
badRequest (400) invalidRecordingDetails El objeto recordingDetails en los metadatos de la solicitud especifica detalles de 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 vacío o no válido.
badRequest (400) invalidVideoMetadata Los metadatos de la solicitud no son válidos. Este error ocurre 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 inserción no válida para el video. Ten en cuenta que es posible que algunos canales no tengan permiso para ofrecer reproductores incorporados para las transmisiones en vivo. Consulta el Centro de ayuda de YouTube para obtener más información.
forbidden (403) forbiddenLicenseSetting La solicitud intenta establecer una licencia no válida para el video.
forbidden (403) forbiddenPrivacySetting La solicitud intenta establecer una configuración de privacidad no válida para el video.
notFound (404) videoNotFound El vídeo que intentas actualizar no se puede encontrar. 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 la calificación.
badRequest (400) invalidRating La solicitud contenía un valor inesperado para el parámetro rating.
badRequest (400) videoPurchaseRequired Sólo los usuarios que han alquilado los videos en alquiler pueden calificarlos.
forbidden (403) forbidden El video que intentas calificar no se puede clasificar. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) videoRatingDisabled El propietario del video que intentas calificar ha inhabilitado las calificaciones para 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 por el que intentas denunciar un abuso.

watermarks

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 podrían 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 parámetro channelId esté establecido en un valor no válido.

watermarks.unset

Tipo de error Detalle del error Descripción
forbidden (403) forbidden La marca de agua no se puede desactivar para el canal especificado. Es posible que la solicitud no esté debidamente autorizada o que el parámetro channelId esté establecido en un valor no válido.