如何避免Python版Gmail API每次运行都要求获取新令牌？

核心问题 #

你搞混了客户端密钥JSON和用户令牌。客户端密钥只需下载一次，每次重新下载完全没必要——问题出在你没做好令牌的持久化存储和自动刷新逻辑。Gmail API的访问令牌（access_token）默认仅1小时有效期，但刷新令牌（refresh_token）可以长期有效（除非用户主动撤销权限），只要正确存好刷新令牌，就能自动获取新的访问令牌，不用重复授权。

具体修复步骤 #

1. 持久化存储令牌 #

别把令牌存在临时目录或只放在内存里，要写到本地文件（比如token.json），脚本启动先读这个文件，没有再触发授权。示例代码片段：

import os
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
from google.auth.transport.requests import Request

# 仅需发送邮件的权限范围
SCOPES = ['https://www.googleapis.com/auth/gmail.send']

def get_credentials():
    creds = None
    # 读取本地已保存的令牌
    if os.path.exists('token.json'):
        creds = Credentials.from_authorized_user_file('token.json', 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(
                'credentials.json', SCOPES)  # 这个就是你下载的客户端密钥，只需放一次
            creds = flow.run_local_server(port=0)
        # 把新令牌存回本地，下次启动直接用
        with open('token.json', 'w') as token:
            token.write(creds.to_json())
    return creds

2. 确保授权时拿到刷新令牌 #

桌面应用用InstalledAppFlow流程时，默认会请求offline访问权限，这样首次授权就能拿到refresh_token。如果之前没拿到，先删掉本地的token.json，重新授权一次就行。

3. 别碰客户端密钥 #

credentials.json是你的应用身份凭证，放在脚本同目录就行，永远不用重新下载——你之前每次下载它只是碰巧触发了重新授权，根本没解决本质问题。

4. 处理极端失效情况 #

如果用户在Google账户里主动撤销了应用权限，或者refresh_token长期不用过期（极少发生），脚本会自动弹出登录窗口，用户再登一次就好，不用手动操作文件。

验证方法 #

• 首次运行脚本，完成授权后，本地会生成token.json
• 等1小时以上，或者手动把token.json里的expiry改成过去的时间，再运行脚本，看是否能自动刷新令牌，不用重新授权

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