YouTube Data API - Errors

En este documento, se identifican los diferentes tipos de errores que pueden devolver las operaciones de 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 actúe en nombre de otra Cuenta de Google, este error se refiere a esta última.
forbidden (403) authenticatedUserAccountSuspended La cuenta de YouTube del usuario autenticado está suspendida. En caso de que el usuario autenticado actúe en nombre de otra Cuenta de Google, este error se refiere a esta última.
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 establecer 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 permisos 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 en la solicitud.
badRequest (400) invalidMine El parámetro mine no se puede usar en solicitudes en las que el usuario autenticado sea socio de YouTube. Debes quitar el parámetro mine, autenticarte como usuario de YouTube quitando el parámetro onBehalfOfContentOwner o actuar como uno de los canales del socio proporcionando el parámetro onBehalfOfContentOwnerChannel si está disponible para el método llamado.
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 admitido.
badRequest (400) unsupportedRegionCode El parámetro regionCode especifica un código de región no admitido.
unauthorized (401) authorizationRequired La solicitud usa el parámetro mine, pero no está autorizada correctamente.
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 agregarlos 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. Es seguro que un usuario que tiene una cuenta de Gmail o un dispositivo Android tenga una Cuenta de Google, pero es posible que aún no la haya vinculado a un canal de YouTube.

Este error suele aparecer 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, recibirás este error.

La entrada del blog de la API de YouTube en la que se presenta la compatibilidad con las Cuentas de Google también analiza el error youtubeSignupRequired con 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

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos activities. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 configuras el parámetro home como true en una solicitud no autorizada.
forbidden (403) forbidden La solicitud no está autorizada correctamente.
notFound (404) channelNotFound No se encuentra el ID de canal identificado por el parámetro channelId de la solicitud.
notFound (404) homeChannelNotFound No se puede encontrar un feed de la página principal de YouTube para el usuario autenticado actualmente.
unauthorized (401) authorizationRequired La solicitud usa el parámetro home, pero no está autorizada correctamente.

subtítulos

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

captions.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden Los permisos asociados a la solicitud no son suficientes para borrar el segmento de subtítulos. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se pudo encontrar 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 a la solicitud no son suficientes para descargar el segmento de subtítulos. Puede que la solicitud no esté debidamente autorizada.
invalidValue (400) couldNotConvert No se pudieron convertir los datos de la pista de subtítulos al idioma o formato solicitados. Asegúrate de que los valores de tfmt y tlang solicitados sean válidos y de que el valor de snippet.status del segmento de subtítulos solicitado no sea failed.
notFound (404) captionNotFound No se pudo encontrar 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 contiene el contenido de la pista de subtítulos.
conflict (409) captionExists El video especificado ya tiene un segmento de subtítulos con los valores de snippet.language y snippet.name proporcionados. Un video puede tener varias pistas para el mismo idioma, pero cada pista debe tener un nombre diferente.

Hay varias formas de solucionar el error. Puedes borrar el segmento existente y, luego, insertar uno nuevo o cambiar el nombre del segmento nuevo antes de insertarlo.
forbidden (403) forbidden Los permisos asociados a la solicitud no son suficientes para subir el segmento 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 el segmento. Confirma que la solicitud especifica 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 se pudo recuperar una o más pistas de subtítulos porque los permisos asociados a la solicitud no son suficientes para recuperar los recursos solicitados. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se encontraron uno o más de los segmentos de subtítulos especificados. Este error se produce 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 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 del segmento es obligatorio si el parámetro sync se establece en true.
forbidden (403) forbidden Los permisos asociados a la solicitud no son suficientes para actualizar el segmento de subtítulos. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se pudo encontrar 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos channelBanners. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

channelBanners.insert

Tipo de error Detalle del error Descripción
badRequest (400) bannerAlbumFull Tu álbum de diseño del canal de YouTube tiene demasiadas imágenes. Ve a http://photos.google.com, navega a la página de álbumes y quita algunas 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos channelSections. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 del 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 encuentra la sección del canal que intentas actualizar.

channelSections.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError La propiedad snippet.defaultLanguage del recurso channelSection debe establecerse para insertar o actualizar correctamente el objeto localizations para ese recurso.
badRequest (400) invalidLanguage Una de las claves de idioma del objeto localizations no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según 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 del canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry Uno de los valores de la lista targeting.countries no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Uno de los valores de la lista targeting.languages no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Uno de los valores de la lista targeting.regions no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según 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 se admite para 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 el valor 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 canal.
invalidValue (400) contentDetailsNeeded El recurso que insertas debe contener un objeto contentDetails para este tipo de sección del 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 se 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 de canales que aparezca en él.
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 se especificaron 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 del 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 encontró uno o más de los canales especificados.
notFound (404) playlistNotFound No se encontró 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 del canal solicitadas.
invalidValue (400) idInvalid La solicitud especifica un ID de sección del 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 a 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 La propiedad snippet.defaultLanguage del recurso channelSection debe establecerse para insertar o actualizar correctamente el objeto localizations para ese recurso.
badRequest (400) invalidLanguage Una de las claves de idioma del objeto localizations no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según 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 del canal.
badRequest (400) styleRequired El recurso channelSection debe especificar un valor para el campo snippet.style.
badRequest (400) targetInvalidCountry Uno de los valores de la lista targeting.countries no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidLanguage Uno de los valores de la lista targeting.languages no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según los lineamientos de la documentación del recurso a href="/youtube/v3/docs/channelSections#resource">channelSections.
badRequest (400) targetInvalidRegion Uno de los valores de la lista targeting.regions no pasó la validación. Usa el método channelSections.list para recuperar valores válidos y actualizarlos según 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 se admite para 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 el valor 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 canal.
invalidValue (400) contentDetailsNeeded El recurso que actualizas debe contener un objeto contentDetails para este tipo de sección del canal.
invalidValue (400) idInvalid La propiedad id especifica un ID de sección del 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 se 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 de canales que aparezca en él.
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 se especificaron 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 del 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 encontró uno o más de los canales especificados.
notFound (404) channelSectionNotFound No se encuentra la sección del canal que intentas actualizar.
notFound (404) playlistNotFound No se encontró una o más de las playlists especificadas.

canales

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

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 y forUsername. En el caso de la autenticación del propietario del contenido con el 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á autorizada correctamente.
notFound (404) categoryNotFound No se puede encontrar la categoría identificada por el parámetro categoryId.
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 Uno de los valores del objeto brandingSettings no pasó la validación. Usa el método channels.list para recuperar la configuración existente del canal y actualizar los valores de las propiedades según los lineamientos de la documentación del recurso channels.
badRequest (400) channelTitleUpdateForbidden Cuando actualices el brandingSettings part de un canal, debes establecer el valor de la propiedad brandingSettings.channel.title en el título actual del canal o bien omitir la propiedad. La API devuelve un error si cambias el valor de la propiedad.
badRequest (400) defaultLanguageNotSetError El defaultLanguage debe configurarse para actualizar 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. Comprueba 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. Comprueba 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. Comprueba 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 desplazamiento de tiempo no válido en la parte de 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. Comprueba 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. Comprueba el valor de la propiedad invideoPromotion.timing.type en el recurso que envió la solicitud.
badRequest (400) localizationValidationError Uno de los valores del objeto de localizaciones no pasó la validación. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos según los lineamientos que se indican en la documentación del recurso channels.
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á autorizada correctamente.
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 al que se 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 No se puede encontrar el canal especificado por el parámetro id o no tiene opciones de desarrollo de la marca.
notFound (404) channelNotFound No se puede encontrar el canal especificado en el parámetro id.
notFound (404) unknownChannelId No se encontró el ID de canal especificado.
notFound (404) unknownChannelId No se encontró el ID de canal recentlyUploadedBy 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 elemento en la parte invideoPromotion.
required (400) requiredTimingOffset Los metadatos de la solicitud deben especificar un desplazamiento de tiempo predeterminado 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 la URL de un 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos commentThreads. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

commentThreads.list

Tipo de error Detalle del error Descripción
badRequest (400) operationNotSupported La solicitud a la API no es válida o no está formulada correctamente. Por lo tanto, el servidor de la API no pudo interpretar la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, suele indicar 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 tiene inhabilitados los comentarios.
forbidden (403) forbidden No se puede recuperar uno o más de los subprocesos de comentarios solicitados debido a que no hay permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) channelNotFound No se pudo encontrar el canal identificado por el parámetro allThreadsRelatedToChannelId.
notFound (404) commentThreadNotFound No se puede encontrar uno o más de los hilos de comentarios especificados. Verifica los valores del parámetro id de la solicitud para asegurarte de que sean correctos.
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. Asegúrate de que el recurso especifique valores para las propiedades snippet.channelId y snippet.videoId. Aparece un comentario en la página de reproducción de un 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, suele indicar 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 el hilo de comentarios debido a que no se tienen los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se usa para autorizar la solicitud de la API debe combinarse con la Cuenta de Google del usuario para insertar un comentario o un hilo 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.

comentarios

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

comments.list

Tipo de error Detalle del error Descripción
badRequest (400) operationNotSupported La solicitud a la API no es válida o no está formulada correctamente. Por lo tanto, el servidor de la API no pudo interpretar la solicitud.
forbidden (403) forbidden No se puede recuperar uno o más de los comentarios solicitados debido a que no se tienen los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se encontró 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 La solicitud a la API no es válida o no está formulada correctamente. Por lo tanto, el servidor de la API no pudo interpretar la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, suele indicar 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 que no se tienen los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se encontró 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 usuario actual puede responder el hilo.
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 de 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, suele indicar 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 debido a que no se tienen los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se usa para autorizar la solicitud de la API debe combinarse con la Cuenta de Google del usuario para insertar un comentario o un hilo de comentarios.
notFound (404) parentCommentNotFound No se pudo encontrar el comentario principal especificado. Verifica 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, suele indicar que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se pudo borrar el comentario debido a que no hay permisos suficientes. 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 La solicitud a la API no es válida o no está formulada correctamente. Por lo tanto, el servidor de la API no pudo interpretar la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar la solicitud correctamente. Si bien puede ser un error transitorio, suele indicar 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 debido a que no tienes los permisos necesarios. Puede que la solicitud no esté debidamente autorizada.
forbidden (403) ineligibleAccount La cuenta de YouTube que se usa para autorizar la solicitud de la API debe combinarse con la Cuenta de Google del usuario para actualizar un comentario o un hilo de comentarios.
notFound (404) commentNotFound No se pudo encontrar el comentario especificado. Verifica 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos members. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 del especificado.
badRequest (400) invalidPageToken El valor del parámetro pageToken no es válido. Este error se produce si el token de página que se usa en la solicitud venció.
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 devuelve la API en respuesta a las llamadas relacionadas con los recursos members. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 devuelve la API en respuesta a las llamadas relacionadas con los recursos playlistItems. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 borrar videos de la playlist especificada. Por ejemplo, no puedes borrar un video de tu playlist de videos subidos.

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á autorizada correctamente para insertar el elemento de playlist especificado.
invalidValue (400) invalidContentDetails La propiedad contentDetails de la solicitud no es válida. Un posible motivo es que el campo contentDetails.note tiene más de 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 del recurso no es compatible con esta operación. El ID del recurso identifica el elemento que se agrega a la playlist, como youtube#video.
invalidValue (400) manualSortRequired La solicitud intenta establecer la posición del elemento de la playlist, pero esta no usa la clasificación manual. (por ejemplo, los elementos de la playlist se pueden ordenar 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 playlist tenga una posición específica en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar estos parámetros de configuración 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 tu playlist de videos subidos.
notFound (404) playlistNotFound No se encontró 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. Verifica el valor de la propiedad videoId para asegurarte de que sea correcto.
required (400) channelIdRequired La solicitud no especifica un valor para la propiedad obligatoria channelId.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad obligatoria playlistId.
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 encontró la playlist identificada con el parámetro playlistId de la solicitud.
notFound (404) videoNotFound No se pudo 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 obligatoria playlistId.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de enumerar videos en la playlist especificada. Por ejemplo, no puedes incluir un video en tu playlist Ver más tarde.

playlistItems.update

Tipo de error Detalle del error Descripción
forbidden (403) playlistItemsNotAccessible La solicitud no está autorizada correctamente para actualizar el elemento de playlist 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 del recurso no es compatible con esta operación. El ID del recurso identifica el elemento que se agrega a la playlist, como 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 playlist, pero esta no usa la clasificación manual. (por ejemplo, los elementos de la playlist se pueden ordenar 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 playlist tenga una posición específica en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar estos parámetros de configuración 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 tu playlist de videos subidos.
notFound (404) playlistItemNotFound No se encontró el elemento de la playlist identificado con la propiedad id de la solicitud.
notFound (404) playlistNotFound No se encontró la playlist identificada con el parámetro playlistId de la solicitud.
required (400) channelIdRequired La solicitud no especifica un valor para la propiedad obligatoria channelId.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad obligatoria playlistId.
required (400) playlistItemIdRequired El recurso de elemento de playlist especificado en la solicitud debe usar la propiedad id para identificar el elemento de playlist que se está actualizando.

playlists

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

playlists.delete

Tipo de error Detalle del error Descripción
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está autorizada correctamente.
notFound (404) playlistNotFound No se encontró la playlist identificada con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de borrar 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 Se suspendió el canal especificado en el parámetro channelId.
forbidden (403) playlistForbidden La playlist identificada con el parámetro id de la solicitud no admite la solicitud o esta no está autorizada correctamente.
notFound (404) channelNotFound No se puede encontrar el canal especificado en el parámetro channelId.
notFound (404) playlistNotFound No se encontró la playlist identificada con el parámetro id de la solicitud.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de enumerar la playlist especificada. Por ejemplo, no puedes mostrar tu playlist Ver más tarde.

playlists.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError El defaultLanguage debe configurarse para actualizar localizations.
badRequest (400) localizationValidationError Uno de los valores del objeto de localizaciones no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos según los lineamientos que se indican en la documentación del recurso de playlists.
badRequest (400) maxPlaylistExceeded No se puede crear la playlist porque el canal ya tiene la cantidad máxima de playlists permitidas.
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está autorizada correctamente.
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 El defaultLanguage debe configurarse para actualizar localizations.
badRequest (400) localizationValidationError Uno de los valores del objeto de localizaciones no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos según los lineamientos que se indican en la documentación del recurso de playlists.
forbidden (403) playlistForbidden Esta operación está prohibida o la solicitud no está autorizada correctamente.
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 encontró 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos subscriptions. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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 Tienes demasiadas suscripciones recientes. Vuelve a intentarlo en unas horas.
badRequest (400) subscriptionForbidden No se admite la suscripción 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 se suscribe.

subscriptions.list

Tipo de error Detalle del error Descripción
forbidden (403) accountClosed No se pudieron recuperar las suscripciones porque se cerró la cuenta del suscriptor.
forbidden (403) accountSuspended No se pudieron recuperar las suscripciones porque se suspendió la cuenta del suscriptor.
forbidden (403) subscriptionForbidden El solicitante no tiene permiso para acceder a las suscripciones solicitadas.
notFound (404) subscriberNotFound No se puede encontrar el suscriptor identificado con la solicitud.

Miniaturas

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

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 Recientemente, el canal subió demasiadas miniaturas. Vuelve a intentar la solicitud más tarde.

videoAbuseReportReasons

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

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 devuelve la API en respuesta a las llamadas relacionadas con los recursos videoCategories. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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. Usa 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 devuelve la API en respuesta a las llamadas relacionadas con los recursos videos. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

videos.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSet La solicitud intenta agregar detalles del video 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 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 grabación 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á autorizada correctamente para acceder al archivo de video o a la información de procesamiento. 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á autorizada correctamente 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 del video 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 admitidas.
badRequest (400) invalidDefaultBroadcastPrivacySetting La solicitud intenta establecer un parámetro de configuración de privacidad no válido 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 grabación 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 un parámetro de configuración de incorporación no válido para el video. Es posible que algunos canales no tengan permiso para ofrecer reproductores integrados 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 calificar.
badRequest (400) invalidRating La solicitud contenía un valor inesperado para el parámetro rating.
badRequest (400) videoPurchaseRequired Solo los usuarios que alquilaron videos 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 inhabilitó las calificaciones para ese video.
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 encontró el video por el que intentas denunciar abuso.

marcas de agua

En las siguientes tablas, se identifican los mensajes de error que devuelve la API en respuesta a las llamadas relacionadas con los recursos watermarks. Estos métodos también pueden devolver los errores que se enumeran en la sección Errores comunes de solicitud.

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é autorizada correctamente 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é autorizada correctamente o que el parámetro channelId esté establecido en un valor no válido.