使用application-default credentials获取GMail标签报Insufficient Permission错误如何解决

错误原因 #

你当前的应用默认凭证（ADC）本身配置有效，否则无法正常访问Cloud Storage服务，出现Insufficient Permission错误是凭证未授予Gmail API的访问权限，或权限配置不完整导致。

解决步骤 #

• 第一步：在你的GCP项目中启用Gmail API
  进入GCP控制台的「API和服务」页面，搜索「Gmail API」后点击启用即可。
• 第二步：补全代码中的权限范围配置
  读取Gmail标签需要添加https://www.googleapis.com/auth/gmail.labels权限范围，检查你初始化Gmail客户端时的scopes参数，确保已包含该权限。
• 第三步：重新生成带Gmail权限的应用默认凭证
  之前生成的ADC仅授权了Cloud Storage相关权限，需要重新执行授权命令：

  gcloud auth application-default login --scopes=https://www.googleapis.com/auth/cloud-platform,https://www.googleapis.com/auth/gmail.labels
  

  按照页面提示完成账号授权后，新生成的凭证就会包含Gmail访问权限。
• 第四步：额外检查项（仅针对服务账号场景）
  如果你使用服务账号的ADC访问个人Gmail账号，需要先为服务账号开启全域权限委派，同时在代码中指定要模拟的用户邮箱地址。
  另外确认代码中调用Gmail接口时的用户ID参数填写为me，代表访问当前授权用户的邮箱数据。

内容的提问来源于stack exchange，提问作者C.K.