如何在无界面树莓派上通过Python授权Google API？

针对你在无界面树莓派Docker环境中遇到的Google API授权问题，以下几种方案无需在设备上搭建网页，且适配用户自主认证的需求：

方案1：桌面授权后迁移凭据文件 #

这是最快速的临时适配方法，适合初期测试：

• 在带GUI的电脑上，搭建和树莓派Docker环境一致的Python环境（安装相同版本的google-auth-oauthlib、google-api-python-client等依赖）
• 运行你的Google Calendar程序，按提示完成本地授权，此时会生成token.json（或token.pickle，取决于库版本）凭据文件
• 通过SCP命令或文件传输工具，将这个凭据文件传到树莓派的Docker容器中，放在程序能读取的路径下（比如和credentials.json同目录）
• 后续树莓派上的程序会自动读取该凭据，且因你设置了access_type=offline，令牌过期时会自动刷新

方案2：使用OAuth 2.0设备授权流（推荐，适配用户自主认证） #

这是Google官方为无界面设备设计的授权流程，完美支持用户自主完成认证：

• 修改你的Python代码，将原Web服务器流替换为设备授权流，核心代码示例：

  from google_auth_oauthlib.flow import InstalledAppFlow
  from google.auth.transport.requests import Request
  import os
  import pickle
  
  # 你的Calendar权限范围
  SCOPES = ['https://www.googleapis.com/auth/calendar.readonly']
  
  creds = None
  # 检查是否已有保存的凭据
  if os.path.exists('token.pickle'):
      with open('token.pickle', 'rb') as token:
          creds = pickle.load(token)
  # 凭据无效或过期时处理
  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)
          # 使用run_console触发设备授权流程
          creds = flow.run_console()
          # 保存凭据供后续使用
          with open('token.pickle', 'wb') as token:
              pickle.dump(creds, token)
  # 后续初始化Calendar服务...
  

• 运行程序后，终端会输出类似内容：

  Please go to https://www.google.com/device and enter code XYZ789
  

• 用户在任意带GUI的设备（手机、电脑）上打开该URL，输入验证码即可完成授权，树莓派上的程序会自动获取并保存令牌

方案3：服务账号凭据（仅适用于自有资源访问） #

如果你不需要用户自主认证，只是访问你自己的Google Calendar资源，可以用服务账号：

• 在Google Cloud控制台创建服务账号，下载密钥文件（service-account-key.json）
• 在Google Calendar设置中，将日历共享给服务账号的邮箱地址
• 使用服务账号凭据初始化API客户端：

  from google.oauth2 import service_account
  from googleapiclient.discovery import build
  
  SCOPES = ['https://www.googleapis.com/auth/calendar.readonly']
  SERVICE_ACCOUNT_FILE = 'service-account-key.json'
  
  creds = service_account.Credentials.from_service_account_file(
      SERVICE_ACCOUNT_FILE, scopes=SCOPES)
  
  service = build('calendar', 'v3', credentials=creds)
  

• 此方法无需任何用户交互，但无法支持用户自主访问他们自己的Calendar，仅适合你控制的资源场景

注意事项 #

• 确保你的Google Cloud项目已启用Google Calendar API
• 使用设备授权流时，需在OAuth同意屏幕中添加测试用户（你已提到使用测试用户，符合要求）
• 所有凭据文件需保证Docker容器内的Python进程有读取权限

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