C#中使用Gmail API为个人账户创建标签报403权限错误如何解决

核心说明 #

私人Gmail账号无需GSuite/Workspace服务账号全域授权，即可通过OAuth 2.0调用Gmail API创建标签，你遇到的403权限不足错误属于授权配置问题，按以下步骤排查即可解决：

• 第一步：确认代码中配置的权限作用域正确
  列举标签仅需只读权限即可完成，但创建标签必须使用修改级别的作用域，你需要确认代码中声明的scope为GmailService.Scope.GmailLabels或更高权限的GmailService.Scope.GmailModify，不能使用只读类型的作用域。
• 第二步：清除本地缓存的旧授权凭据
  .NET官方快速入门的示例代码默认会将授权成功的token缓存到项目目录下的token.json文件夹中，如果你之前使用低权限scope完成过授权，就算后续修改了代码里的scope配置，程序依然会优先读取本地缓存的旧token，不会触发新的授权流程，导致权限不足。直接删除项目目录下的token.json文件夹，重新运行程序触发重新授权即可。
• 第三步：验证创建标签的代码逻辑正确
  参考示例代码如下：

  // 已完成授权初始化的GmailService实例
  GmailService service = GetGmailService();
  
  Label newLabel = new Label()
  {
      Name = "自定义标签名称",
      LabelListVisibility = "labelShow",
      MessageListVisibility = "show"
  };
  
  Label createdLabel = service.Users.Labels.Create(newLabel, "me").Execute();
  Console.WriteLine($"标签创建成功，ID：{createdLabel.Id}");
  

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