Google Sheets API 读取单元格内容并保存至变量的实现方法

1. 前置准备 #

• 先完成Google Cloud平台的Sheets API启用，生成服务账号密钥JSON文件，把服务账号邮箱添加到目标Sheets的共享列表，授予只读权限，这步和控制台教程的准备逻辑完全一致。
• 你的表单项目需要先安装Google Sheets API的官方客户端库：.NET环境用NuGet安装Google.Apis.Sheets.v4，Java环境用Maven引入对应依赖，JS前端环境直接引入官方客户端SDK即可。

2. 核心逻辑实现（以.NET WinForm为例，其他框架逻辑通用） #

首先在表单类的作用域声明存储读取结果的变量，方便各个控件全局调用：

// 表单类内声明全局变量存储单元格内容，需读取多个单元格可替换为List或Dictionary类型
private string _sheetCellContent = string.Empty;

封装异步读取Sheets的方法，避免网络请求阻塞UI线程导致表单卡死：

private async Task<string> ReadSingleCellFromSheets(string spreadsheetId, string range)
{
    // 加载服务账号密钥
    GoogleCredential credential;
    using (var stream = new FileStream("你的服务账号密钥文件路径.json", FileMode.Open, FileAccess.Read))
    {
        credential = GoogleCredential.FromStream(stream)
            .CreateScoped(SheetsService.Scope.SpreadsheetsReadonly);
    }

    // 初始化Sheets服务
    var service = new SheetsService(new BaseClientService.Initializer()
    {
        HttpClientInitializer = credential,
        ApplicationName = "你的表单应用名称",
    });

    // 发起读取请求
    var request = service.Spreadsheets.Values.Get(spreadsheetId, range);
    var response = await request.ExecuteAsync();
    var values = response.Values;

    if (values != null && values.Count > 0)
    {
        // 读取目标单元格内容转为字符串返回
        return values[0][0].ToString();
    }
    return string.Empty;
}

3. 赋值到表单文本框 #

在触发读取的逻辑位置（比如表单加载事件、按钮点击事件）调用上述方法，将返回结果赋值给变量后直接绑定到文本框即可：

private async void btnLoadSheetContent_Click(object sender, EventArgs e)
{
    // 替换为你自己的Sheets ID和单元格范围，例："Sheet1!A1"对应第一个工作表的A1单元格
    _sheetCellContent = await ReadSingleCellFromSheets("你的表格ID", "Sheet1!A1");
    // 赋值到文本框
    txtSheetOutput.Text = _sheetCellContent;
}

其他框架适配说明 #

• 若为Web前端表单，将读取逻辑改为JS异步请求，拿到结果后用document.getElementById('你的文本框ID').value = 读取到的内容赋值即可
• 若为Java Swing/JavaFX表单，在子线程执行API请求，拿到结果后切换到UI线程更新文本框内容即可

注意：所有涉及网络请求的操作不要放在UI主线程执行，否则会导致表单无响应。API返回的单元格内容默认是object类型，直接调用ToString()方法即可转为文本框支持的字符串格式，无需额外转换。

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