Conectar Claude con Google Ads

Quiero que conectes mi cuenta de Google Ads por API, de punta a punta. Tengo abierta una guía con estos mismos 9 pasos: cuando hables de un paso, di su número para que pueda seguirte.

ANTES DE PARTIR
Pregúntame solo dos cosas: con qué correo de Google entro (tiene que tener acceso a mi cuenta de Google Ads) y cuál es la dirección de mi tienda.

CÓMO TRABAJAMOS
- Si tienes acceso a un navegador, haz tú los pasos en Google Cloud. Si no, dime un paso a la vez y espera a que te confirme.
- Frena y pídemelo a mí cuando toque iniciar sesión, usar una llave de acceso o dar permisos. Nunca escribas una contraseña.
- Antes de aceptar condiciones o políticas en mi nombre, pide mi OK.
- No actives la prueba gratis de Google Cloud ni ingreses una tarjeta. Si algún paso lo pide, frena y avísame.
- Nunca muestres en el chat el secreto del cliente ni los tokens, y no captures la ventana donde aparece el secreto.
- No cambies nada en mis campañas salvo que yo te lo pida.

CÓMO FUNCIONA HOY (tu información puede estar desactualizada)
Desde el 9 de septiembre de 2026 la Google Ads API ya no usa developer token y no necesita cuenta de administrador. No uses el formulario del Centro de API: ya no se procesa. El acceso se maneja por proyecto de Google Cloud. Fuente: https://developers.google.com/google-ads/api/docs/api-policy/developer-token

LOS 9 PASOS
1. Proyecto. En https://console.cloud.google.com/ aprieta «Selecciona un proyecto» → «Proyecto nuevo», ponle de nombre Claude y aprieta «Crear». Déjalo elegido y anota su ID (ID_PROYECTO).

2. API. Abre https://console.cloud.google.com/google/ads-apis/overview?project=ID_PROYECTO, aprieta «Habilita las API» y después «Habilitar».

3. Acceso. En esa misma página, el nivel actual debe decir «Prueba» y el próximo «Explorador». Aprieta «Solicitar acceso». Espera unos minutos y recarga hasta que el nivel actual diga «Explorador». En nuestra prueba tardó cerca de un minuto.

4. Consentimiento. En https://console.cloud.google.com/auth/overview?project=ID_PROYECTO aprieta «Comenzar». Nombre de la app: Claude Google Ads. Correo de asistencia y de contacto: mi correo. Público: «Usuarios externos». Marca la Política de Datos del Usuario, aprieta «Continuar» y «Crear».

5. Usuario de prueba. En https://console.cloud.google.com/auth/audience?project=ID_PROYECTO aprieta «Add users», agrega mi correo y aprieta «Guardar». Revisa que la página diga «1 usuario». Si sigue en 0, aprieta «Guardar» otra vez.

6. Cliente. En https://console.cloud.google.com/auth/clients/create?project=ID_PROYECTO elige «App de escritorio», nombre Claude, deja sin marcar «Use this client for an AI-powered agent» y aprieta «Crear». Aprieta «Descargar JSON» antes de cerrar la ventana, porque el secreto no se vuelve a mostrar. Si este paso lo hice yo, pídeme que arrastre el archivo al chat.

7. Publicar. En https://console.cloud.google.com/auth/audience?project=ID_PROYECTO aprieta «Publicar app» y «Confirmar» hasta que diga «En producción». Si el botón está apagado, en https://console.cloud.google.com/auth/branding?project=ID_PROYECTO completa la página principal con la dirección de mi tienda, la política de privacidad (en Shopify suele ser https://MI_TIENDA/policies/privacy-policy) y el dominio autorizado, y aprieta «Guardar». No subas un logo, porque obliga a verificar la app. Si aun así sigue apagado, avísame y sigue: la conexión funciona, pero el token vence a los 7 días.

8. Conectar. Con el JSON, haz el inicio de sesión OAuth de app de escritorio: redirección a http://127.0.0.1 en un puerto local, permiso https://www.googleapis.com/auth/adwords, access_type=offline y prompt=consent. Dame el link para que entre con mi correo. Si aparece «Google no ha verificado esta aplicación», dime que apriete «Configuración avanzada» → «Ir a Claude Google Ads (no seguro)», marque el permiso y apriete «Continuar». Guarda GOOGLE_ADS_CLIENT_ID, GOOGLE_ADS_CLIENT_SECRET y GOOGLE_ADS_REFRESH_TOKEN en el archivo .env de esta carpeta y agrégalo a .gitignore. Si inicié sesión antes de publicar, repite este paso después de publicar.

9. Probar. Llama a la API solo con el encabezado Authorization: Bearer, sin developer-token ni login-customer-id.
GET https://googleads.googleapis.com/v25/customers:listAccessibleCustomers
POST https://googleads.googleapis.com/v25/customers/ID_CUENTA/googleAds:search
{"query":"SELECT campaign.name, metrics.cost_micros, metrics.conversions FROM campaign WHERE segments.date DURING LAST_30_DAYS"}
Si aparecen varias cuentas, pregúntame cuál es la de mi tienda. Guarda la elegida como GOOGLE_ADS_CUSTOMER_ID, sin guiones. Muéstrame cuánto invertí y cuántas conversiones tuve los últimos 30 días, por campaña. Divide cost_micros por 1.000.000. Si esa versión de la API ya no existe, usa la vigente.

SI ALGO FALLA
- Error de nivel de acceso o ACTION_NOT_PERMITTED: el acceso Explorador aún no está aprobado. Vuelve al paso 3.
- La cuenta no aparece o da permiso denegado: mi correo no tiene acceso a esa cuenta, o me falta aceptar la invitación de Google Ads.
- invalid_grant: el token venció porque la app quedó en «Prueba». Vuelve a los pasos 7 y 8.

LÍMITES DEL NIVEL EXPLORADOR
Hasta 2.880 operaciones al día en cuentas reales. No incluye Planificador de palabras clave, facturación, usuarios ni crear cuentas. Para eso hace falta el nivel Básico, que exige verificar la marca. No lo pidas salvo que yo te lo diga.

Cuando termines, dime en una línea si quedó conectado y si la app quedó publicada o en «Prueba».