Cómo subir videos a YouTube automáticamente con la API oficial: Shorts desde un programa
Lo esencial
- Se hace con la API oficial de YouTube: el programa no conoce tu contraseña y solo tiene permiso para subir videos.
- Los videos que sube un proyecto sin verificar ya no quedan obligatoriamente en privado, según la referencia de la API.
- La app de Google tiene que estar «En producción»: en «Prueba», el permiso caduca a los 7 días.
- Un video vertical o cuadrado de hasta 3 minutos se trata como Short. No hace falta nada especial al subirlo.
- Cuesta cero. Límite de la API: 100 llamadas al día para subir videos.
Si ya tienes tus videos verticales, subirlos a YouTube a mano cada día es la parte más aburrida. Esta guía explica cómo hacerlo desde un programa con la API oficial de YouTube. Es el método que usa Ctrl+IA para que cada Reel salga también como Short, sin que nadie abra YouTube.
Hay dos cosas que hacen perder días: creer que lo que sube una app sin auditar se queda en privado, que ya no es cierto, y dejar la app en un estado en el que el permiso caduca a los 7 días. Las dos están explicadas abajo.
Qué necesitas
- Un canal de YouTube y la cuenta de Google que lo administra.
- Un proyecto en Google Cloud, gratuito, con la API de YouTube activada.
- Python 3. El programa no usa ninguna biblioteca externa.
- Un equipo con navegador para autorizar el canal una sola vez. Después, el programa puede ejecutarse en cualquier sitio.
- Tiempo: unos 45 minutos la primera vez, casi todos en la consola de Google Cloud.
- Dinero: nada. La API no cobra por subir videos.
Si también publicas en Instagram, allí la API oficial permite además responder por mensaje directo a quien comenta.
Lo que ya no es cierto: “se queda en privado”
Durante años, la norma de YouTube fue que los videos subidos por un proyecto de la API que no hubiera pasado una auditoría quedaban bloqueados en privado. Muchas guías y resúmenes lo siguen repitiendo. A nosotros nos pasó: dimos por buena esa norma a partir de resúmenes del buscador.
La referencia oficial de videos.insert, leída directamente el 12 de octubre de 2026, dice hoy lo contrario: “Videos uploaded from unverified API projects are not restricted to private viewing mode”. Es decir, los videos de un proyecto sin verificar no se limitan al modo privado. La misma página fija la cuota: 100 llamadas al día para subir videos.
La lección sirve para cualquier API: lee la referencia oficial, no el resumen.
Lo que sí hace falta: la app “En producción”
En Google Cloud, la pantalla de consentimiento de tu app tiene un estado de publicación: “Prueba” o “En producción”. La documentación de OAuth de Google, consultada el 12 de octubre de 2026, dice que si está en “Prueba” el permiso duradero (refresh token) caduca a los 7 días, salvo que solo pidas nombre, correo y perfil. Subir videos no entra en esa excepción.
Con la app en “Prueba”, todo funciona una semana y luego falla sin motivo aparente. Pásala a “En producción”.
¿Hace falta enviarla a verificación? Según la ayuda de Google Cloud sobre apps sin verificar, consultada el mismo día, una app sin verificar puede mostrar una pantalla de aviso antes de pedir el permiso, y queda limitada a 100 usuarios nuevos. Para una app que solo usas tú con tu canal, ese límite no importa. La ayuda no habla del uso personal de forma expresa: nosotros no la enviamos a verificar y funciona.
Paso 1 · Prepara Google Cloud
- Entra en console.cloud.google.com y crea un proyecto.
- En la biblioteca de APIs, activa YouTube Data API v3.
- Configura la pantalla de consentimiento: tipo externo, con tu correo como contacto. Añade el permiso
youtube.upload. - Cambia su estado a “En producción”.
- Crea un ID de cliente de OAuth de tipo “App de escritorio”. Te da dos valores: el ID de cliente y el secreto del cliente.
Guarda los dos en variables de entorno: YOUTUBE_CLIENT_ID y YOUTUBE_CLIENT_SECRET. Nunca los escribas en el código ni los subas a un repositorio.
Paso 2 · El programa
Guárdalo como subir_short.py. Pide solo el permiso youtube.upload: puede subir videos, pero no borrar ni cambiar nada de tu canal.
"""Sube un Short a tu canal de YouTube desde tu equipo, con la API oficial de YouTube."""
import http.server, json, os, secrets, sys, urllib.error, urllib.parse, urllib.request, webbrowser
CLIENTE = os.environ["YOUTUBE_CLIENT_ID"] # de Google Cloud, cliente de tipo "App de escritorio"
SECRETO = os.environ["YOUTUBE_CLIENT_SECRET"]
FICHAS = "https://oauth2.googleapis.com/token"
SUBIDAS = "https://www.googleapis.com/upload/youtube/v3/videos"
PERMISO = "https://www.googleapis.com/auth/youtube.upload" # solo subir videos: no puede borrar nada
RETORNO = "http://127.0.0.1:8765"
ENSAYO = os.environ.get("ENSAYO") == "1" # con ENSAYO=1 el video se sube como privado
def llamar(url, cuerpo=None, cabeceras=None, metodo=None):
try:
peticion = urllib.request.Request(url, cuerpo, cabeceras or {}, method=metodo)
return urllib.request.urlopen(peticion, timeout=600)
except urllib.error.HTTPError as error:
sys.exit(f"Google respondió con el error {error.code}: {error.read().decode()}")
def conectar():
"""Abre el navegador para que autorices tu canal y muestra el permiso duradero."""
marca, recibido = secrets.token_urlsafe(16), {}
class Receptor(http.server.BaseHTTPRequestHandler):
def do_GET(self):
recibido.update(urllib.parse.parse_qs(urllib.parse.urlparse(self.path).query))
self.send_response(200)
self.send_header("Content-Type", "text/plain; charset=utf-8")
self.end_headers()
self.wfile.write("Listo. Ya puedes cerrar esta pestaña.".encode())
consulta = urllib.parse.urlencode({
"client_id": CLIENTE, "redirect_uri": RETORNO, "response_type": "code", "scope": PERMISO,
"access_type": "offline", "prompt": "consent", "state": marca})
servidor = http.server.HTTPServer(("127.0.0.1", 8765), Receptor)
webbrowser.open(f"https://accounts.google.com/o/oauth2/v2/auth?{consulta}")
servidor.handle_request()
if recibido.get("state", [""])[0] != marca or "code" not in recibido:
sys.exit("No llegó la autorización.")
campos = {"grant_type": "authorization_code", "code": recibido["code"][0], "client_id": CLIENTE,
"client_secret": SECRETO, "redirect_uri": RETORNO}
fichas = json.load(llamar(FICHAS, urllib.parse.urlencode(campos).encode()))
print("Guárdalo como YOUTUBE_REFRESH_TOKEN:", fichas["refresh_token"])
def subir(video, titulo, descripcion):
# El permiso duradero se cambia por una clave que vale una hora.
campos = {"grant_type": "refresh_token", "client_id": CLIENTE, "client_secret": SECRETO,
"refresh_token": os.environ["YOUTUBE_REFRESH_TOKEN"]}
acceso = json.load(llamar(FICHAS, urllib.parse.urlencode(campos).encode()))["access_token"]
ficha = {
"snippet": {"title": titulo, "description": descripcion, "categoryId": "27"},
"status": {"privacyStatus": "private" if ENSAYO else "public", "selfDeclaredMadeForKids": False}}
with open(video, "rb") as archivo:
contenido = archivo.read()
# 1. Abrir la subida: YouTube responde con la dirección a la que hay que enviar el archivo.
inicio = llamar(f"{SUBIDAS}?uploadType=resumable&part=snippet,status", json.dumps(ficha).encode(), {
"Authorization": f"Bearer {acceso}", "Content-Type": "application/json; charset=UTF-8",
"X-Upload-Content-Type": "video/mp4", "X-Upload-Content-Length": str(len(contenido))})
# 2. Enviar el archivo a esa dirección.
respuesta = llamar(inicio.headers["Location"], contenido,
{"Authorization": f"Bearer {acceso}", "Content-Type": "video/mp4"}, "PUT")
enlace = "https://youtube.com/shorts/" + json.load(respuesta)["id"]
print("Subido como privado:" if ENSAYO else "Publicado:", enlace)
if sys.argv[1] == "conectar":
conectar()
else:
subir(sys.argv[1], sys.argv[2], sys.argv[3])
Paso 3 · Autoriza tu canal, una sola vez
python3 subir_short.py conectar
Se abre el navegador. Elige la cuenta del canal y acepta. Puede aparecer el aviso de app sin verificar que describe la ayuda de Google: es tu propia app, y puedes continuar. Google devuelve la autorización a una dirección de tu propio equipo (127.0.0.1), que el programa escucha solo durante ese momento; es el método que la guía de Google para apps de escritorio recomienda.
El programa muestra el permiso duradero. Guárdalo como YOUTUBE_REFRESH_TOKEN y trátalo como una contraseña: con él se pueden subir videos a tu canal.
Paso 4 · Sube el primer Short en ensayo
ENSAYO=1 python3 subir_short.py short.mp4 "Título del video" "Descripción del video"
Con ENSAYO=1, el video sube como privado: lo ves en tu canal y nadie más. Si todo está bien, bórralo desde YouTube Studio y repite sin ENSAYO=1 para publicarlo.
No hace falta marcar nada para que sea un Short. Según la ayuda de YouTube, consultada el 12 de octubre de 2026, los videos subidos desde el 15 de octubre de 2024 con proporción cuadrada o vertical y hasta tres minutos de duración se tratan como Shorts.
Dos detalles del programa: la categoría 27 es la de Educación (cámbiala por la tuya), y selfDeclaredMadeForKids declara que el video no está dirigido a niños. Si el tuyo lo está, cambia ese valor: es una declaración que YouTube te pide a ti.
Paso 5 · Que se ejecute solo
Como con cualquier publicación automática, el programa sube en el momento en que se ejecuta. Para programar, lánzalo a su hora con el programador de tareas de tu sistema o con una tarea en la nube. Si usas una tarea programada, el secreto del cliente y el permiso duradero van en sus secretos, no en el código.
Nosotros lo ejecutamos justo después de publicar el Reel en Instagram, y con dos cuidados:
- No subir dos veces. Anotamos el identificador de cada video subido y no subimos lo que ya está anotado. Además, antes de subir, comprobamos que el canal no tenga ya un video con el mismo título.
- Si YouTube falla, lo demás sigue. Que no se suba el Short no frena la publicación en Instagram.
Si la parte que quieres automatizar es escribir el contenido y no subirlo, mira las rutinas de Claude Code.
Qué se comprobó
- Probado en producción, desde el 9 de octubre de 2026: la subida de Shorts con la API oficial, desde un proyecto de Google Cloud “En producción” y sin enviar a verificación. Primero un ensayo en privado y después, desde una tarea programada, cinco Shorts en público. El 12 de octubre de 2026 comprobamos con la consulta pública de YouTube (oEmbed) que esos cinco se pueden ver sin iniciar sesión.
- El programa de esta página, tal cual, se ejecutó el 12 de octubre de 2026 contra el servidor real de Google con un cliente falso, que respondió que el cliente no existe (la petición llegó bien formada), y contra un servidor de prueba en el propio equipo, donde recorrió la subida completa en ensayo y en público. No se subió ningún video con él. Hace las mismas llamadas que el programa del proyecto, que además pide permiso para leer los datos del canal y así comprobar que sube al canal correcto.
- No se probó la subida de videos largos ni la reanudación de una subida cortada. La guía de subida reanudable explica cómo continuar desde el último byte recibido; este programa corto empieza de cero si falla.
- El aviso de app sin verificar se describe según la ayuda de Google; no guardamos captura de lo que se vio al autorizar.
Errores comunes
- El permiso deja de funcionar a la semana. La app sigue en “Prueba”. Pásala a “En producción” y vuelve a ejecutar
conectar. - “No llegó la autorización”. Se rechazó el permiso en el navegador o la autorización no volvió al programa. Repite
conectar. - No aparece el permiso duradero. Google lo entrega la primera vez que autorizas, o cuando se vuelve a pedir el consentimiento, que es lo que hace el programa. Si aun así no llega, quita el acceso de la app en tu cuenta de Google y repite.
- Sube al canal equivocado. Si tu cuenta tiene varios canales, elige el correcto al autorizar.
- Usar un programa que pide tu contraseña de Google. No es la API oficial y pone tu cuenta en riesgo.
Esta guía es independiente: Ctrl+IA no tiene relación con Google ni con YouTube. Lo que configures en tu cuenta lo haces bajo tu responsabilidad.