Android Studio中Kotlin应用集成Google Sheets API遇阻，求有效资源

当然可以实现，Google Sheets API并未放弃对Android的支持，只是官方文档结构做了调整——原有的Android专属板块被整合到通用文档中，适配Kotlin的实现逻辑和Java核心一致，只需结合Kotlin语法特性做优化即可。

以下是经过验证的有效学习资源和实操要点：

一、官方核心参考 #

• Google Sheets API通用文档：直接查阅官方最新文档，右上角可切换语言为Kotlin（若没有Kotlin选项，Java示例可通过Android Studio的「Convert Java to Kotlin」功能一键转译）。重点关注「快速入门」「读取数据」章节，以及spreadsheets.values.get这类核心接口的参数说明。
• Google Identity Services for Android：这是当前Android上Google服务授权的标准方案，替代了旧版Google Sign-In库，也是多数过时教程失效的核心原因。务必掌握如何通过该库获取合法的OAuth 2.0令牌，这是调用Sheets API的前提。

二、关键实操步骤（避坑指南） #

1. 依赖配置：在Module级build.gradle中添加最新依赖：

   implementation 'com.google.apis:google-api-services-sheets:v4-rev20240514-2.0.0'
   implementation 'com.google.android.gms:play-services-auth:20.7.0'
   implementation 'com.google.oauth-client:google-oauth-client-android:1.34.1'
   

2. 初始化Sheets服务：获取授权令牌后，创建API客户端实例：

   val transport = AndroidHttp.newCompatibleTransport()
   val jsonFactory = GsonFactory.getDefaultInstance()
   val credential = GoogleCredential().setAccessToken(yourAccessToken)
   val sheetsService = Sheets.Builder(transport, jsonFactory, credential)
       .setApplicationName("你的应用名称")
       .build()
   

3. 读取表格数据：调用API读取指定范围的数据，注意在协程中执行网络请求：

   lifecycleScope.launch(Dispatchers.IO) {
       val spreadsheetId = "你的Google表格ID"
       val range = "Sheet1!A1:B10" // 自定义读取范围
       try {
           val response = sheetsService.spreadsheets().values().get(spreadsheetId, range).execute()
           val values = response.values
           if (!values.isNullOrEmpty()) {
               // 处理数据，比如切换到主线程更新UI
               withContext(Dispatchers.Main) {
                   values.forEach { row ->
                       Log.d("SheetsData", "行内容: ${row.joinToString(", ")}")
                   }
               }
           }
       } catch (e: Exception) {
           e.printStackTrace()
           // 处理异常，比如授权失效、网络错误等
       }
   }
   

三、社区实用资源 #

• Stack Overflow标签搜索：检索[android] [google-sheets-api] [kotlin]下的最新问题，很多开发者会分享最新的踩坑解决方案，尤其是关于授权流程适配Android 13+的细节。
• Android官方安全文档：查阅Google Play服务中关于OAuth 2.0授权的规范，确保你的实现符合Android最新的隐私和安全要求，比如避免在主线程执行网络操作、正确处理令牌过期等。

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