YouTube Data API - Errors

En este documento, se identifican los diferentes tipos de errores que pueden mostrar 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 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 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 es un 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 compatible.
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. Un usuario que tiene una cuenta de Gmail o un dispositivo Android seguramente tiene una Cuenta de Google, pero es posible que aún no la haya vinculado a un canal de YouTube.

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

En la entrada de blog de la API de YouTube en la que se presenta la compatibilidad con Cuentas de Google, también se 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

YouTube dejó de ofrecer la función de boletines del canal. Ya no se admite el método activities.insert.

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de activities. Estos métodos también pueden mostrar los errores que se indican 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 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 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 muestra la API en respuesta a llamadas relacionadas con recursos de captions. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de solicitud.

captions.delete

Tipo de error Detalle del error Descripción
forbidden (403) forbidden Los permisos asociados con la solicitud no son suficientes para borrar la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada.
notFound (404) captionNotFound No se pudo encontrar la pista de subtítulos. Verifica 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.
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 snippet.status de la pista de subtítulos solicitada no sea failed.
notFound (404) captionNotFound No se pudo encontrar la pista de subtítulos. Verifica 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 una pista de subtítulos con los snippet.language y snippet.name proporcionados. Un video puede tener varias pistas para el mismo idioma, pero cada una debe tener un nombre diferente.

Existen varias formas de corregir el error. Puedes borrar la pista existente y, luego, insertar una nueva, o bien cambiar el nombre de la nueva pista antes de insertarla.
forbidden (403) forbidden Los permisos asociados con la solicitud no son suficientes para subir la pista de subtítulos. Puede que la solicitud no esté debidamente autorizada.
invalidValue (400) invalidMetadata La solicitud contiene valores de metadatos no válidos, lo que impide que se cree la pista. Confirma que la solicitud especifique valores válidos para las propiedades snippet.language, snippet.name y snippet.videoId. También se puede incluir la propiedad snippet.isDraft, pero no es obligatoria.
notFound (404) videoNotFound No se pudo encontrar el video identificado por el parámetro videoId.
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 pudieron recuperar uno o más segmentos 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 pudieron encontrar 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 pista de subtítulos que no existen o IDs de pista que están asociados con otros videos. Verifica los valores de los parámetros id y videoId de la solicitud para asegurarte de que sean correctos.
notFound (404) videoNotFound No se pudo encontrar el video identificado por el parámetro videoId.

captions.update

Tipo de error Detalle del error Descripción
badRequest (400) contentRequired La solicitud no subió un archivo de subtítulos actualizado. El contenido real de la pista es obligatorio si 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 pudo encontrar la pista de subtítulos especificada. Verifica 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 recursos de channelBanners. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 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 recursos de channelSections. Estos métodos también pueden mostrar los errores que se indican 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 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 La propiedad snippet.defaultLanguage del recurso channelSection se debe configurar para insertar o actualizar correctamente el objeto localizations de 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 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[] 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 insertes 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 se 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 un valor de singlePlaylist, la propiedad contentDetails.playlists[] debe especificar exactamente una playlist.
invalidValue (400) ownChannelInChannels No puedes incluir tu propio canal en una sección de canal que aparezca en ese canal.
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 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 puede 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 del canal solicitadas.
invalidValue (400) idInvalid La solicitud especifica un ID de sección de canal no válido.
invalidValue (400) invalidCriteria No se pudo completar la solicitud porque los criterios de filtro no son válidos.
notFound (404) channelNotFound No se puede encontrar el canal asociado con la solicitud.
notFound (404) channelSectionNotFound No se puede encontrar la sección del canal asociada con la solicitud.

channelSections.update

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError La propiedad snippet.defaultLanguage del recurso channelSection se debe configurar para insertar o actualizar correctamente el objeto localizations de 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 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[] 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 de canal no válido.
invalidValue (400) idRequired La propiedad id debe especificar un valor que identifique la sección del canal que se actualizará.
invalidValue (400) inValidPosition La propiedad snippet.position contiene un valor no válido.
invalidValue (400) maxChannelsExceeded La solicitud falló porque se 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 un valor de singlePlaylist, la propiedad contentDetails.playlists[] debe especificar exactamente una playlist.
invalidValue (400) ownChannelInChannels No puedes incluir tu propio canal en una sección de canal que aparezca en ese canal.
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 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 puede 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 recursos de channels. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 puede 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. Usa 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 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 la propiedad 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 omitir la propiedad. La API muestra un error si cambias el valor de la propiedad.
badRequest (400) defaultLanguageNotSetError Se debe configurar defaultLanguage para actualizar localizations.
badRequest (400) invalidBrandingOption Una de las configuraciones del desarrollo de la marca que especificaste no existe. Usa el método channels.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo 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 desfase 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. 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 Uno de los valores del objeto localizations no pasó la validació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 permitida de elementos promocionados en la parte de 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 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 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 de 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 artículo 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 desfase 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 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 recursos de commentThreads. Estos métodos también pueden mostrar los errores que se indican 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 entender la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) commentsDisabled El video identificado por el parámetro videoId tiene inhabilitados los comentarios.
forbidden (403) forbidden No se pueden recuperar una o más de las conversaciones de comentarios solicitadas debido a que no tienes 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 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. Asegúrate de que el recurso especifique valores para las propiedades snippet.channelId y snippet.videoId. Aparece un comentario en un video en la página de reproducción.
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 correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso commentThread en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden Es posible que no se haya creado el subproceso 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 a la API debe combinarse con la Cuenta de Google del usuario para insertar un comentario o una conversación.
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

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 recursos de comments. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 entender la solicitud.
forbidden (403) forbidden No se pueden recuperar uno o más de los comentarios solicitados debido a que no tienes los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se puede encontrar 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 entender la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se puede establecer el estado de moderación de uno o más comentarios debido a que no tienes los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se puede encontrar uno o más de los comentarios que la solicitud intenta actualizar. Verifica los valores del parámetro id de la solicitud para asegurarte de que sean correctos.

comments.insert

Tipo de error Detalle del error Descripción
badRequest (400) commentTextRequired El recurso comment que se inserta debe especificar un valor para la propiedad snippet.textOriginal. Los comentarios no pueden estar vacíos.
badRequest (400) commentTextTooLong El recurso comment que se inserta contiene demasiados caracteres en la propiedad snippet.textOriginal.
badRequest (400) invalidCommentMetadata Los metadatos de la solicitud no son válidos.
badRequest (400) operationNotSupported El usuario de la API no puede insertar un comentario en respuesta al comentario de nivel superior identificado por la propiedad snippet.parentId. En un recurso commentThread, la propiedad snippet.canReply indica si el usuario actual puede responder la conversación.
badRequest (400) parentCommentIsPrivate El comentario superior 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 superior. 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 correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso comment en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se puede crear el comentario 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 a la API debe combinarse con la Cuenta de Google del usuario para insertar un comentario o una conversación.
notFound (404) parentCommentNotFound No se pudo encontrar el comentario superior 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 correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida.
forbidden (403) forbidden No se pudo borrar el comentario debido a que no se tienen los permisos suficientes. Puede que la solicitud no esté debidamente autorizada.
notFound (404) commentNotFound No se pudo encontrar el comentario especificado. Verifica 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 entender la solicitud.
badRequest (400) processingFailure El servidor de la API no pudo procesar correctamente la solicitud. Si bien este puede ser un error transitorio, por lo general, indica que la entrada de la solicitud no es válida. Verifica la estructura del recurso comment en el cuerpo de la solicitud para asegurarte de que sea válida.
forbidden (403) forbidden No se pudo actualizar el comentario 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 actualizar un comentario o una conversación.
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 muestra la API en respuesta a llamadas relacionadas con recursos de members. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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.
badRequest (400) invalidMode El valor del parámetro mode no es válido. Este error puede ocurrir si el parámetro pageToken especifica un token que se recuperó con un modo diferente al especificado.
badRequest (400) invalidPageToken El valor del parámetro pageToken no es válido. Este error se produce si el token de página que se usó 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 muestra la API en respuesta a llamadas relacionadas con recursos de members. Estos métodos también pueden mostrar los errores que se indican 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.

playlistItems

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de playlistItems. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 la 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 tiene la autorización adecuada para insertar el elemento de playlist especificado.
invalidValue (400) invalidContentDetails La propiedad contentDetails de la solicitud no es válida. Una posible razón 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 de recurso no es compatible con esta operación. El ID de recurso identifica el elemento que se agregará 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 ordenación manual. (por ejemplo, los elementos de una playlist se pueden ordenar por fecha o popularidad). Para corregir 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 en particular en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar esta 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 la playlist de videos subidos.
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. 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 channelId obligatoria.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId obligatoria.
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 obligatoria.
invalidValue (400) playlistOperationUnsupported La API no admite la capacidad de mostrar una lista de videos en la playlist especificada. Por ejemplo, no puedes incluir un video en tu playlist de Ver más tarde.

playlistItems.update

Tipo de error Detalle del error Descripción
forbidden (403) playlistItemsNotAccessible La solicitud no tiene la autorización adecuada 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 de recurso no es compatible con esta operación. El ID de recurso identifica el elemento que se agregará 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 ordenación manual. (por ejemplo, los elementos de una playlist se pueden ordenar por fecha o popularidad). Para corregir 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 en particular en la lista, primero debes actualizar la opción Orden de la playlist a Manual en la configuración de la playlist. Puedes ajustar esta configuración en el Administrador de videos de YouTube.
invalidValue (400) playlistOperationUnsupported La API no admite la actualización de videos en la playlist especificada. Por ejemplo, no puedes actualizar un video en la playlist de videos subidos.
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 obligatoria.
required (400) playlistIdRequired La solicitud no especifica un valor para la propiedad playlistId obligatoria.
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 actualizará.

playlists

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de playlists. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 puede encontrar 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 es compatible con la solicitud o la solicitud no está autorizada correctamente.
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 playlist especificada. Por ejemplo, no puedes mostrar tu playlist de Ver más tarde.

playlists.insert

Tipo de error Detalle del error Descripción
badRequest (400) defaultLanguageNotSetError Se debe configurar defaultLanguage para actualizar localizations.
badRequest (400) localizationValidationError Uno de los valores del objeto localizations no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos de playlists.
badRequest (400) maxPlaylistExceeded No se puede crear la playlist porque el canal ya tiene la cantidad máxima permitida.
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 Se debe configurar defaultLanguage para actualizar localizations.
badRequest (400) localizationValidationError Uno de los valores del objeto localizations no pasó la validación. Usa el método playlists.list para recuperar valores válidos y asegúrate de actualizarlos siguiendo los lineamientos de la documentación de recursos 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 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 recursos de subscriptions. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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. Verifica 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 la cuenta del suscriptor está cerrada.
forbidden (403) accountSuspended No se pudieron recuperar las suscripciones porque la cuenta del suscriptor está suspendida.
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 muestra la API en respuesta a llamadas relacionadas con recursos de thumbnails. Estos métodos también pueden mostrar los errores que se indican 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. Verifica 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 intentar 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 recursos de videoAbuseReportReasons. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 muestra la API en respuesta a llamadas relacionadas con recursos de videoCategories. Estos métodos también pueden mostrar los errores que se indican 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 muestra la API en respuesta a llamadas relacionadas con recursos de videos. Estos métodos también pueden mostrar los errores que se indican 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 de 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 ni 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 ni 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. Verifica 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. Verifica 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 de 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 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 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 ni snippet.categoryId.
forbidden (403) forbidden Acceso prohibido Puede que la solicitud no esté debidamente autorizada.
forbidden (403) forbiddenEmbedSetting La solicitud intenta establecer una configuración de incorporación no válida para el video. Es posible que algunos canales no tengan permiso para ofrecer reproductores incorporados en 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. Verifica 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 los 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. Verifica 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.

marcas de agua

En las siguientes tablas, se identifican los mensajes de error que muestra la API en respuesta a llamadas relacionadas con recursos de watermarks. Estos métodos también pueden mostrar los errores que se indican en la sección Errores comunes de la 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 tenga 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 tenga un valor no válido.