Lo que una ampliación de cuota de la API de YouTube te cuesta en papeleo

¿Qué es una ampliación de cuota de la API de YouTube?

Cada ampliación de cuota de la API de YouTube es el resultado de una auditoría y no un cambio de ajustes: la propia guía de Google afirma que "if you would like to request additional quota beyond the default allocation, you must first complete an audit to show that your project is in compliance with the YouTube API Services Terms of Service". No hay ningún control deslizante en la Cloud Console que suba un límite de la YouTube Data API. Hay un formulario, una revisión del equipo de API Services de YouTube y una decisión.

Esa es la norma desde el 1 de julio de 2021, cuando el historial de revisiones de YouTube anunció que "all developers using YouTube's API Services must complete an API Compliance Audit in order to be granted more than the default quota allocation of 10,000 units".

El único camino hacia más cuota

Cuota por defecto

Formulario de auditoría y ampliación de cuota

Revisión del equipo de API Services de YouTube

Decisión

¿Cuál es la cuota por defecto?

El valor por defecto ya no es un solo número, y esta es la parte que casi todos los artículos siguen contando mal. Desde el cambio del 1 de junio de 2026, las páginas de cuota de Google dicen:

"Projects that enable the YouTube Data API have a default quota allocation of 100 search.list calls, 100 videos.insert calls, and 10,000 units per day combined for all other endpoints."

Dos métodos ocupan ahora sus propios compartimentos. El historial de revisiones lo describe como "transitioning to a granular quota system covering smaller sets of methods, starting with videos.insert and search.list", para que YouTube pueda "more easily verify and approve requests based on specific method usage". Un tercer compartimento llegó el 3 de junio de 2026 con videos.batchGetStats, que tiene "a quota cost of 1 unit in its own granular quota bucket" y "a default quota of 10,000 units per day".

Las cuotas diarias se reinician a medianoche, hora del Pacífico.

¿Cuánto cuesta cada llamada?

Los costes salen de la Quota Calculator. Las operaciones de lectura son baratas, las de escritura no.

Método	Coste
activities.list, channels.list, videos.list, playlists.list, comments.list	1 unidad
videos.getRating	1 unidad
videos.update, videos.rate, videos.delete, videos.reportAbuse	50 unidades
playlists.insert, playlistItems.insert, subscriptions.insert	50 unidades
thumbnails.set, channels.update, watermarks.set	50 unidades
captions.insert	400 unidades
captions.update	450 unidades
search.list	100 al día, 1 unidad por llamada
videos.insert	100 al día, 1 unidad por llamada

Dos cosas estrechan el presupuesto más rápido de lo que sugiere la tabla. "All API requests, including invalid requests, incur a quota cost of at least one point", así que una llamada mal formada también te cobra. Y la paginación se acumula: si un método "returns multiple pages of results, each request to retrieve an additional page of results incurs the estimated quota cost".

¿Dónde se contradice la propia documentación de Google?

En la página de la Quota Calculator, en dos sitios a la vez.

El texto del cuerpo y la tabla dicen los dos que videos.insert tiene un límite diario por defecto de 100 y que "the quota cost is 1 per call". El Page Summary autogenerado de la parte superior de esa misma página, actualizado por última vez el 2026-09-04, dice otra cosa: "The table shows that methods like videos.insert have the highest cost of 1600 points". El resumen legible por máquina del pie de la página lo repite, y describe costes "ranging from 1 for actions such as list to 1600 for actions like videos insert".

La cifra de 1.600 es un fósil. La entrada del historial de revisiones del 4 de diciembre de 2025 registra que la documentación se "updated to reflect a change in the quota cost of a video upload from approximately 1600 units to approximately 100 units", y el cambio de compartimentos de junio de 2026 sacó las subidas del fondo común por completo. El widget de resumen nunca se puso al día. Si presupuestas a partir de la cifra de 1.600, estás presupuestando contra un coste que Google retiró hace diez meses, en una página que sigue mostrándolo.

Hay un segundo desajuste, más pequeño. La página de Quota and Compliance Audits lleva una línea de resumen que dice "with a default allocation of 10,000 units per day", mientras que el cuerpo de esa misma página enumera la asignación en tres partes. Ambas se actualizaron por última vez el 2026-09-04.

¿Qué pide en realidad el formulario?

Una sola URL cubre casi todo: https://support.google.com/youtube/contact/yt_api_form, el YouTube API Services Audit and Quota Extension Form. Google dirige tres situaciones distintas a esa misma dirección. Iniciar una auditoría, solicitar una ampliación tras haber pasado una auditoría en los últimos 12 meses y completar una auditoría periódica para la que te contactaron pasan todas por ahí. Una auditoría fallida va a otra dirección, yt_api_appeals, y un cambio de control va a yt_api_change_of_control_form.

El formulario abre pidiéndote que selecciones el motivo de la solicitud, con dos opciones: completar una auditoría de cumplimiento para pedir cuota adicional, o completar una auditoría de cumplimiento para conservar la cuota actual si te pidieron reauditarte. Después recoge, en este orden:

• Datos de organización y contacto. Nombre legal completo, nombre legal de la organización, empresa matriz, una URL de sitio web principal que tiene que empezar por https://, una dirección legal completa, una categoría de negocio, un tamaño de organización y contactos principal, técnico y comercial por separado.
• Modelo de negocio. Una descripción de tu trabajo relacionado con YouTube con un mínimo de 100 caracteres y un techo de 5.000, tu audiencia objetivo, tu modelo de monetización, preguntas sobre la colocación de anuncios y si YouTube la aprobó, y cualquier relación existente con un representante de Google.
• Panorama del cliente de API. El nombre del cliente y si contiene la palabra "YouTube", la URL de acceso principal, la URL de la política de privacidad, la URL de los términos de servicio, si el cliente es accesible públicamente y credenciales de una cuenta de demostración con usuario, contraseña y cualquier instrucción de acceso especial.
• Casos de uso y cuota. Entre uno y diez proyectos. Para cada uno: el número de proyecto de Google Cloud, las categorías de caso de uso, si se exige OAuth, el volumen diario esperado, capturas de tu política de privacidad, tu página de inicio y tus términos, capturas condicionales del flujo de OAuth, la interfaz de subida o el panel, los endpoints concretos que necesitas y una cifra total de cuota diaria con su justificación.

El bloque de credenciales de demostración es el que detiene a los equipos, aunque el formulario marque esos campos como opcionales. Una beta cerrada, una herramienta interna o un cliente cuyo único punto de entrada está detrás de un muro de pago sigue necesitando una forma de que un revisor lo vea en funcionamiento.

¿Qué no documenta Google?

Todo lo relativo al resultado.

Google publica las URLs del formulario, el requisito de auditoría, la asignación por defecto y los costes por método. No publica ningún plazo de revisión, ningún acuerdo de servicio, ningún criterio de aprobación, ninguna rúbrica de puntuación, ninguna política de aprobación parcial y ninguna fecha límite para apelaciones. El Appeals Form existe para proyectos que "recently failed an API Compliance Audit", y "recently" es el único calificador que se da.

Lo que los solicitantes cuentan en foros públicos de desarrolladores son esperas largas y variables, decisiones que conceden menos cuota de la pedida y envíos que quedan sin respuesta durante meses. Esos relatos conviene conocerlos, pero son quejas autoseleccionadas y no una distribución publicada, y ninguno es un compromiso de Google. Planifica sobre las partes documentadas y trata el resto como ilimitado.

La respuesta práctica es no necesitar la ampliación. Cachea con agresividad, usa videos.list con valores part explícitos en vez de search.list cuando ya conozcas un ID, y agrupa las lecturas. La misma disciplina aplica en todas las redes con una API medida, desde el presupuesto de escritura por puntos de Bluesky hasta los techos por endpoint de Pinterest y las 100 publicaciones por 24 horas de Instagram. Si tu carga de trabajo es publicar y no analizar, la comparativa de APIs de programación es un punto de partida más útil que una solicitud de cuota.

Preguntas frecuentes

¿Cuánta cuota de la YouTube Data API tengo por defecto?

100 llamadas a search.list, 100 llamadas a videos.insert y 10.000 unidades al día en conjunto para todos los demás endpoints. Google plantea esa asignación tanto en la Quota Calculator como en la página de Quota and Compliance Audits. Las cuotas se reinician a medianoche, hora del Pacífico.

¿videos.insert sigue costando 1.600 unidades?

No. El historial de revisiones de Google registra el cambio de aproximadamente 1.600 unidades a aproximadamente 100 unidades el 4 de diciembre de 2025, y el cambio de compartimentos de junio de 2026 movió las subidas a su propia asignación con 1 unidad por llamada y 100 llamadas al día. El resumen autogenerado de la página de la Quota Calculator sigue imprimiendo 1.600, y está obsoleto.

¿Puedo subir mi cuota de la API de YouTube sin auditoría?

No. La guía de Google afirma que la cuota adicional por encima de la asignación por defecto exige completar antes una auditoría. La Cloud Console te muestra tu uso y tus límites, pero los límites en sí los fija el equipo de API Services de YouTube tras la revisión.

¿Cuánto tarda una ampliación de cuota de la API de YouTube?

Google no publica ningún plazo. La página de Quota and Compliance Audits dice únicamente que "a member of YouTube's API Services team will contact you as soon as possible". Los reportes públicos de desarrolladores describen esperas de semanas a meses, con algunos envíos sin respuesta, pero Google no se compromete a ningún acuerdo de servicio.

¿Qué pasa si suspendo la auditoría?

Puedes enviar el Appeals Form en support.google.com/youtube/contact/yt_api_appeals, que cubre proyectos que suspendieron recientemente una auditoría de cumplimiento o a los que se les denegó un aumento de cuota. Google no publica los criterios usados ni en la decisión original ni en la apelación.

¿Qué error devuelve YouTube cuando me quedo sin cuota?

quotaExceeded, como un 403, descrito en la documentación de errores de la API como "the request cannot be completed because you have exceeded your quota". Un rateLimitExceeded aparte aparece como un 400 por enviar demasiadas peticiones en un plazo dado.

¿Cuál es la URL exacta del formulario de ampliación de cuota de la API de YouTube?

Google dirige las auditorías y las solicitudes de cuota a https://support.google.com/youtube/contact/yt_api_form, el YouTube API Services Audit and Quota Extension Form. La misma dirección cubre tres situaciones: iniciar una auditoría, solicitar una ampliación tras haber pasado una en los últimos 12 meses, y completar una reauditoría periódica.

¿Adónde va una auditoría de la API de YouTube que no se supera?

Una auditoría suspendida o una ampliación de cuota denegada va al Appeals Form en support.google.com/youtube/contact/yt_api_appeals, una dirección distinta del formulario principal. El único criterio que da Google es que el proyecto haya "suspendido recientemente una API Compliance Audit", sin plazo publicado ni criterios de evaluación para la apelación en sí.

¿Por qué una solicitud de cuota de la API de YouTube pide credenciales de una cuenta de demostración?

El formulario pide una cuenta de demostración funcional, con nombre de usuario, contraseña y cualquier instrucción de acceso especial, porque un revisor tiene que poder iniciar sesión y ver el cliente en funcionamiento antes de aprobar nada. Una beta cerrada, una herramienta interna o un cliente oculto tras un muro de pago deberían aportar igualmente una cuenta que funcione, aunque el formulario deja esos campos de credenciales como opcionales.

¿Cómo evito necesitar una ampliación de cuota de la API de YouTube?

Cachear de forma agresiva, llamar a videos.list con valores explícitos de part en vez de search.list cuando el ID ya se conoce, y agrupar las lecturas en lotes en vez de disparar una solicitud por elemento. Esa disciplina mantiene el uso diario dentro de las 100 llamadas a search.list, las 100 llamadas a videos.insert y las 10.000 unidades que reciben por defecto la mayoría de los proyectos, y evita un proceso sin plazo ni criterios de aprobación publicados.