Gmail API自动认证流程问题：如何实现无需手动授权发邮件？

可以实现Gmail API的自动认证，无需每次手动选择账户，以下两种方案可满足需求：

方案1：利用持久化刷新令牌实现自动续期 #

你的现有代码已具备基础凭证持久化能力，只需确保首次认证时获取到长期有效的刷新令牌，后续即可自动完成认证，无需手动干预：

优化后的代码示例 #

from google.oauth2.credentials import Credentials
from google.auth.transport.requests import Request
import os
import pickle

# 定义Gmail API权限范围
SCOPES = ['https://www.googleapis.com/auth/gmail.send']
CLIENT_SECRET_FILE = 'credentials.json'

creds = None
# 读取已保存的凭证文件
if os.path.exists('token.pickle'):
    with open('token.pickle', 'rb') as token:
        creds = Credentials.from_authorized_user_file(token, SCOPES)

# 自动处理凭证过期/无效情况
if not creds or not creds.valid:
    if creds and creds.expired and creds.refresh_token:
        # 自动刷新凭证，无需手动操作
        creds.refresh(Request())
    else:
        # 首次运行需手动完成一次认证，之后无需再操作
        flow = InstalledAppFlow.from_client_secrets_file(CLIENT_SECRET_FILE, SCOPES)
        # 若运行环境无GUI，可改用run_console()实现命令行认证
        # creds = flow.run_console()
        creds = flow.run_local_server(port=0)
    # 保存更新后的凭证，供下次使用
    with open('token.pickle', 'wb') as token:
        pickle.dump(creds, token)

关键说明 #

• 首次运行时需手动完成一次认证（弹出谷歌页面选择账户），认证完成后token.pickle会保存包含刷新令牌的凭证
• 后续运行时，代码会自动检查凭证有效性，过期时通过刷新令牌自动获取新的访问令牌，完全无需手动操作
• 若运行环境无图形界面（如服务器），将run_local_server()替换为run_console()，通过命令行完成首次认证

方案2：使用服务账号（适用于Google Workspace域内账户） #

如果你的邮箱属于Google Workspace（原G Suite）域，可使用服务账号实现完全无手动交互的认证，无需任何用户介入：

代码示例 #

from google.oauth2 import service_account
from googleapiclient.discovery import build

# 定义权限范围
SCOPES = ['https://www.googleapis.com/auth/gmail.send']
# 服务账号密钥文件路径
SERVICE_ACCOUNT_FILE = 'service-account-key.json'

# 创建服务账号凭证，并指定要模拟的域内用户邮箱
credentials = service_account.Credentials.from_service_account_file(
    SERVICE_ACCOUNT_FILE, scopes=SCOPES,
    subject='user@your-domain.com'  # 替换为域内实际发送邮件的用户邮箱
)

# 构建Gmail API服务
service = build('gmail', 'v1', credentials=credentials)

关键说明 #

1. 需在Google Cloud控制台创建服务账号，并为其开启域范围授权（仅Google Workspace管理员可操作）
2. 需将服务账号授权为可模拟目标域内用户发送邮件
3. 此方案完全无需用户手动认证，适合自动化脚本或服务使用

注：个人Gmail账户无法使用服务账号进行域范围授权，只能采用方案1实现自动认证

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