.NET Core中使用服务账户调用Google Calendar API无结果问题求助

核心检查项 #

• 确认域范围委派权限
  登录admin.google.com，检查服务账户的域范围委派是否添加了正确的Calendar API权限，比如https://www.googleapis.com/auth/calendar.readonly（只读场景），且已完成授权。空数据大概率是权限未生效导致。
• 验证日历共享设置
  确认目标私有日历已共享给服务账户的完整邮箱（格式如xxx@xxx.iam.gserviceaccount.com），且共享权限设为「查看所有事件」，而非仅忙闲状态。

正确的.NET Core实现步骤 #

1. 安装依赖NuGet包 #

Install-Package Google.Apis.Calendar.v3
Install-Package Google.Apis.Auth.AspNetCore3

2. 配置服务账户密钥 #

将下载的JSON密钥文件放入项目根目录，设置文件属性为「复制到输出目录」→「如果较新则复制」。

3. 认证与服务初始化代码 #

using Google.Apis.Auth.OAuth2;
using Google.Apis.Calendar.v3;
using Google.Apis.Calendar.v3.Data;
using Google.Apis.Services;
using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;

public class CalendarHandler
{
    private static readonly string[] Scopes = { CalendarService.Scope.CalendarReadonly };
    private static readonly string AppName = "你的Web应用名称";
    private static readonly string KeyFilePath = Path.Combine(AppContext.BaseDirectory, "service-account-key.json");

    public static CalendarService GetCalendarService(string impersonateUser)
    {
        // 加载服务账户密钥并模拟域内用户
        var credential = GoogleCredential.FromFile(KeyFilePath)
            .CreateScoped(Scopes)
            .CreateWithUser(impersonateUser);

        return new CalendarService(new BaseClientService.Initializer()
        {
            HttpClientInitializer = credential,
            ApplicationName = AppName
        });
    }

    public static List<Event> FetchCalendarEvents(string calendarId, string impersonateUser)
    {
        var service = GetCalendarService(impersonateUser);
        var request = service.Events.List(calendarId);
        
        request.TimeMin = DateTime.Now;
        request.MaxResults = 20;
        request.SingleEvents = true;
        request.OrderBy = EventsResource.ListRequest.OrderByEnum.StartTime;

        var response = request.Execute();
        return response.Items?.ToList() ?? new List<Event>();
    }
}

4. 关键注意点 #

• 必须模拟域内用户：服务账户本身无独立日历权限，域范围委派的核心是让它模拟一个域内合法用户（该用户需拥有目标日历的访问权限，要么是所有者，要么被共享权限）。
• 核对Calendar ID：确保传入的calendarId是目标私有日历的正确ID（通常为日历所有者的邮箱，或日历的专属ID）。
• 调试技巧：可以打印response的原始内容，或启用Google API日志查看请求细节，排查隐藏的权限或路径问题。

排查指南 #

• 先用模拟的用户账号登录Google Calendar，确认该用户能正常查看目标日历的事件。
• 检查服务账户JSON密钥的文件路径是否正确，确保程序有权读取该文件。

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