login-customer-id
login-customer-id es una cabecera de solicitud HTTP en la API de Google Ads que lleva el ID de cliente de la cuenta de administrador a través de la cual opera, indicando a Google qué cuenta de la jerarquía autoriza la llamada en nombre de la cuenta de destino.
Cada solicitud a la API de Google Ads apunta a un ID de cliente, la cuenta cuyas campañas está leyendo o cambiando. Cuando esa cuenta se alcanza a través de una cuenta de administrador (MCC), la API también necesita conocer el camino que tomó para llegar. Ese es el trabajo de login-customer-id: nombra la cuenta de administrador cuya autorización está ejerciendo, y se envía como diez dígitos sin guiones (1234567890, no 123-456-7890).
La regla general: si tus credenciales de OAuth pertenecen a un usuario que accede directamente a la cuenta de destino, normalmente puede omitir la cabecera. Si el acceso llega a través de una cuenta de administrador, el caso normal para agencias y para cualquiera que use un developer token emitido a un MCC, la cabecera es obligatoria. Omitirla es una de las causas más comunes de errores USER_PERMISSION_DENIED en desarrolladores que ven la cuenta perfectamente en la interfaz web, porque la UI realiza la misma resolución en silencio mientras que la API no.
Hay un segundo uso, más sutil. En jerarquías profundas la cabecera decide qué contexto de administrador se aplica, y ese contexto afecta a lo que puede ver y hacer: los presupuestos compartidos, las acciones de conversión entre cuentas y los ajustes a nivel de cuenta se resuelven todos en relación con el administrador con el que inició sesión. Enviar el MCC equivocado en una estructura anidada puede producir datos parciales en vez de un error rotundo, lo que es mucho más difícil de detectar.
Esta es exactamente la clase de fontanería que Opus Growth elimina. Como operamos el conector como un servicio alojado, el contexto de administrador se resuelve por ti en cada llamada, se conecta una vez con el inicio de sesión de Google y nunca maneja tú mismo un developer token, una cabecera de ID de cliente ni un bucle de refresco de OAuth.
Preguntas frecuentes
Siempre que acceda a una cuenta a través de una cuenta de administrador en vez de directamente, lo que cubre prácticamente todas las configuraciones de agencia y cualquier integración que use un developer token emitido a un MCC. Las cuentas de acceso directo normalmente pueden omitirla.
Lo más común es USER_PERMISSION_DENIED, a veces CUSTOMER_NOT_ENABLED o un error de autorización general, aunque el mismo usuario pueda abrir la cuenta con normalidad en la interfaz web de Google Ads.
Diez dígitos con los guiones quitados. Una cuenta mostrada como 123-456-7890 en la interfaz se envía como 1234567890 en la cabecera.