如何将Gmail API访问令牌有效期延长至1周？服务账户相关疑问

一、令牌有效期的关键说明 #

Google OAuth 2.0的访问令牌默认就是1小时有效期，这是官方标准限制，没法直接改成1周。你说的“延长到1周”，实际是通过服务账户实现无需人工干预的长期授权——服务账户生成的访问令牌还是1小时，但可以用密钥自动刷新，相当于持续有效；单次令牌持续1周的需求，在Google OAuth体系里是不支持的。

另外你提到刷新令牌也只有1小时，这肯定有问题：正常情况下，个人Gmail账户的刷新令牌是长期有效的，大概率是你授权时没加access_type=offline参数，导致没拿到长期刷新令牌。

二、服务账户的常见疑问 #

• 是否必须用服务账户？
  如果你是Google Workspace（原G Suite）域内用户，想要后台自动访问Gmail API，服务账户+域范围委派是最优解；但如果是普通个人Gmail账户，服务账户没法直接使用，先把刷新令牌的问题解决即可。
• 创建服务账户要花钱吗？
  完全免费，只要你有Google Cloud账号就能创建，没有额外费用。
• 为什么需要管理员权限？
  只有当你要给服务账户开启域范围委派（让服务账户模拟域内任意用户操作）时，才需要Workspace管理员权限。单纯创建服务账户，普通Google Cloud账号就能操作，不需要管理员权限。

三、修复刷新令牌有效期短的问题（个人账户） #

检查你的OAuth授权流程：

• 必须在授权请求里添加access_type=offline参数，这样Google才会返回长期刷新令牌。
• 不要每次授权都加prompt=consent，否则会生成新的刷新令牌，旧的直接失效。
• 正常情况下，刷新令牌不会过期，除非你主动撤销授权、修改密码，或者Google检测到异常操作。

四、服务账户使用步骤（Workspace用户） #

1. 在Google Cloud控制台创建服务账户，下载JSON格式的密钥文件。
2. 联系Workspace管理员，在Admin控制台给这个服务账户开启域范围委派，同时授权Gmail API的所需权限（比如只读、全权限等）。
3. 用服务账户密钥，通过Google官方客户端库生成模拟用户的访问令牌，令牌1小时到期后会自动刷新，实现长期后台访问。

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