Los fallos de Gmail OAuth en WordPress son problemas de estado de autorización, no de contraseña. Los objetos clave son proyecto de Google Cloud, cliente OAuth, consentimiento, redirect URI, scopes concedidos y refresh token del plugin.
Haz coincidir redirect URI exactamente
Esquema, host, path y callback del plugin deben coincidir con el cliente OAuth. Una migración puede invalidar una integración correcta.
Lee el código de error de consentimiento
redirect_uri_mismatch, access_denied, invalid_grant e insufficient_scope indican fases distintas. Conserva el código, no el token.
Confirma estado de publicación/test users
Una pantalla en testing puede limitar usuarios autorizados y comportamiento del token según configuración.
Usa scopes mínimos
Concede solo acceso documentado para envío/identidad. Si cambian scopes, reautoriza; el refresh token antiguo no gana permisos solo.
Comprueba salud del refresh token
Una autorización inicial puede fallar después por revocación, rotación de secret o cambios de seguridad. Reconecta de forma deliberada y retira credenciales antiguas.
Envía por la ruta real de WordPress
Prueba desde el plugin/formulario, no solo desde consola Google, y revisa logs de mensaje/proveedor.
Tras autorizar, verifica transporte con logs seguros y entrega con la traza al buzón.
Registra el estado OAuth sin guardar secretos
Conserva identificador de proyecto/cliente, redirect URI, cuenta, modo de la pantalla de consentimiento, scopes solicitados, hora de autorización y código de error. No copies access ni refresh tokens. Este registro basta para comparar staging/producción y ver si un cambio de dominio, scopes o revocación invalidó la autorización.