如何使用Python获取GNOME在线账户信息（如Geary）用于邮件客户端开发

可用的Python库 #

你需要使用GNOME Online Accounts（GOA）的GObject Introspection绑定，也就是gi.repository中的Goa模块。GOA是GNOME官方的在线账户管理组件，Geary正是基于它实现的账户集成，Python可以直接通过GI调用其API。

前提准备 #

确保系统安装了必要的依赖包：

• 基础GOA组件：gnome-online-accounts（大部分GNOME桌面环境默认已安装）
• Python GI绑定：python3-gi
• GOA的GI类型库：Debian/Ubuntu系为gir1.2-goa-1.0，Fedora系为gnome-online-accounts-devel

代码示例：获取邮箱账户及凭证 #

以下是基础实现代码，用于遍历所有GNOME在线账户，筛选出邮件类型账户并获取其凭证：

from gi.repository import Gio, Goa

def get_mail_accounts():
    # 获取GOA账户管理器
    client = Goa.Client.new_sync(None)
    accounts = client.get_accounts()
    
    mail_accounts = []
    for account in accounts:
        # 获取账户核心信息对象
        account_info = account.get_account()
        # 筛选邮件类型账户（匹配GOA的账户类型标识）
        if account_info.get_account_type() in ['imap', 'exchange', 'gmail']:
            # 获取凭证对象
            credentials = account.get_credentials()
            # 提取关键信息
            account_data = {
                'name': account_info.get_display_name(),
                'email': account_info.get_identity(),
                'password': credentials.get_password() if credentials.has_password() else None,
                # OAuth类型账户（如Gmail）需获取access token
                'oauth_token': credentials.get_oauth2_access_token() if credentials.is_oauth2() else None,
                'account_type': account_info.get_account_type()
            }
            mail_accounts.append(account_data)
    return mail_accounts

if __name__ == '__main__':
    accounts = get_mail_accounts()
    for acc in accounts:
        print(f"账户名称: {acc['name']}")
        print(f"邮箱地址: {acc['email']}")
        if acc['password']:
            print(f"密码: {acc['password']}")
        if acc['oauth_token']:
            print(f"OAuth令牌: {acc['oauth_token']}")
        print("---")

关键说明 #

• 权限配置：如果应用通过Flatpak打包，需在manifest中添加GOA访问权限，否则无法调用服务。示例权限配置：

  finish-args:
    - --talk-name=org.gnome.OnlineAccounts
    - --talk-name=org.gnome.OnlineAccounts.Client
  

• 凭证类型适配：不同邮箱账户的凭证类型不同，传统IMAP账户用密码，Gmail等用OAuth2令牌，需根据账户类型做对应处理。
• 异步调用建议：GUI应用中建议使用异步版本Goa.Client.new()，避免阻塞主线程，示例中的new_sync()仅适合脚本测试场景。

内容的提问来源于stack exchange，提问作者Sonnengott