如何集成Google登录并基于谷歌账号实现日历内容展示

• Google Identity Services (GIS)：安卓平台官方Google登录SDK，负责账号授权、身份校验，已替代旧版Google Sign-In API，合规性和稳定性更高
• Google Calendar API：谷歌官方提供的日历数据操作接口，支持读写账号下的日历、事件数据，满足你读取已添加事件的需求
• 可选网络库（OkHttp/Retrofit）：如果不想使用谷歌官方提供的API客户端封装，可自行通过REST请求调用Calendar API接口，需自行处理鉴权签名逻辑，更推荐直接用官方客户端降低开发成本

1. 前期配置准备 #

• 在Google Cloud Console创建项目，搜索并启用Google Calendar API
• 配置OAuth同意屏幕，填写应用名称、联系方式等必填信息，添加calendar.readonly作为申请的敏感权限
• 创建安卓端OAuth 2.0凭据，填写你的应用包名、签名文件的SHA1指纹，生成的凭据会自动内置到后续SDK调用逻辑中，无需额外在代码里填写

2. 添加项目依赖 #

在应用级build.gradle文件中添加如下依赖：

// Google身份服务
implementation 'com.google.android.gms:play-services-auth:20.7.0'
// Google Calendar API客户端
implementation 'com.google.apis:google-api-services-calendar:v3-rev20220715-2.0.0'
implementation 'com.google.oauth-client:google-oauth-client-android:1.34.1'

3. 实现Google登录逻辑 #

• 初始化登录客户端，配置登录请求时额外声明日历只读权限：

val signInOptions = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
    .requestScopes(Scope("https://www.googleapis.com/auth/calendar.readonly"))
    .requestEmail()
    .build()
val signInClient = GoogleSignIn.getClient(context, signInOptions)

• 触发登录流程，调用signInClient.signInIntent唤起系统登录弹窗，在onActivityResult中接收登录结果，拿到GoogleSignInAccount对象即为登录成功的账号信息

4. 拉取日历事件 #

使用登录成功返回的账号凭证构建Calendar服务实例，调用接口拉取事件：

// 构建Calendar服务
val credential = GoogleAccountCredential.usingOAuth2(
    context,
    listOf("https://www.googleapis.com/auth/calendar.readonly")
).setSelectedAccount(signInAccount.account)

val calendarService = Calendar.Builder(
    AndroidHttp.newCompatibleTransport(),
    GsonFactory.getDefaultInstance(),
    credential
).setApplicationName("你的应用名称")
 .build()

// 异步拉取事件，注意不要在主线程执行
val events = calendarService.events().list("primary")
    .setMaxResults(20) // 最多拉取20条
    .setTimeMin(DateTime(System.currentTimeMillis())) // 只拉取当前时间之后的事件，可按需调整
    .setSingleEvents(true)
    .setOrderBy("startTime")
    .execute()
    .items

• 拿到返回的events列表后，可直接读取每个事件的summary（标题）、start/end（起止时间）、location（地点）等字段，渲染到你的应用UI中即可

注意事项 #

• 申请日历权限时需明确向用户说明权限用途，否则Google Play审核、OAuth应用验证都会被驳回
• 如果应用要对外发布，需要完成Google Cloud的OAuth同意屏幕验证，否则用户登录时会看到应用未验证的警告
• GIS SDK会自动处理token刷新逻辑，无需你自行维护鉴权有效期

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