如何用Google Sheets API Ruby客户端创建年度新工作表并检查存在性？

我特意针对你使用的Google::Apis::SheetsV4::SheetsService类整理了完整的代码方案，刚好解决你按年份创建新工作表的需求——先检查目标标题的工作表是否存在，不存在就创建，之后还能继续执行你原本的单元格更新操作。

核心步骤说明 #

• 先通过get_spreadsheet获取电子表格的所有工作表信息，对比标题判断是否存在
• 若不存在，用batch_update_spreadsheet发送创建工作表的批量请求（这是Sheets V4 API创建工作表的标准方式）
• 完成工作表检查/创建后，就能正常执行你的单元格区域更新逻辑

完整代码示例 #

首先确保你已经安装了依赖的gem：

gem install google-api-client googleauth

然后是实现代码：

require 'google/apis/sheets_v4'
require 'googleauth'

# 初始化Sheets服务（根据你的授权方式调整，这里用服务账号示例）
def init_sheets_service
  service = Google::Apis::SheetsV4::SheetsService.new
  service.client_options.application_name = 'Your App Name'

  # 授权配置：替换成你的服务账号密钥路径和所需权限
  scopes = [Google::Apis::SheetsV4::AUTH_SPREADSHEETS]
  credentials = Google::Auth::ServiceAccountCredentials.make_creds(
    json_key_io: File.open('path/to/your/service-account-key.json'),
    scope: scopes
  )
  service.authorization = credentials
  service
end

# 检查指定标题的工作表是否存在
def sheet_exists?(service, spreadsheet_id, target_title)
  spreadsheet = service.get_spreadsheet(spreadsheet_id)
  # 遍历所有工作表的属性，对比标题
  spreadsheet.sheets.any? { |sheet| sheet.properties.title == target_title }
end

# 创建新工作表
def create_new_sheet(service, spreadsheet_id, sheet_title)
  # 构建创建工作表的请求
  add_sheet_req = Google::Apis::SheetsV4::AddSheetRequest.new(
    properties: Google::Apis::SheetsV4::SheetProperties.new(title: sheet_title)
  )
  # 批量更新请求（Sheets API要求用批量请求创建工作表）
  batch_req = Google::Apis::SheetsV4::BatchUpdateSpreadsheetRequest.new(
    requests: [add_sheet_req]
  )
  # 发送请求
  service.batch_update_spreadsheet(spreadsheet_id, batch_req)
end

# 主逻辑：检查+创建工作表，然后执行单元格更新
def main
  spreadsheet_id = 'YOUR_SPREADSHEET_ID' # 替换成你的电子表格ID
  target_year = Time.now.year.to_s # 动态获取当前年份，也可以手动指定
  sheet_title = "#{target_year} 年度数据" # 自定义工作表标题

  service = init_sheets_service

  # 检查并创建工作表
  unless sheet_exists?(service, spreadsheet_id, sheet_title)
    puts "正在创建新工作表：#{sheet_title}"
    create_new_sheet(service, spreadsheet_id, sheet_title)
  else
    puts "工作表 #{sheet_title} 已存在"
  end

  # 这里添加你原本的单元格更新逻辑，示例：更新A1:B2区域
  update_range = "#{sheet_title}!A1:B2"
  update_values = [
    ['项目', '数值'],
    ['销售额', '10000']
  ]
  value_range = Google::Apis::SheetsV4::ValueRange.new(range: update_range, values: update_values)
  service.update_spreadsheet_value(
    spreadsheet_id,
    update_range,
    value_range,
    value_input_option: 'RAW' # 按原始值写入，也可以选'USER_ENTERED'模拟手动输入
  )
end

main

关键细节提示 #

• 授权方式：如果不是用服务账号，你可以调整为OAuth2授权流程，核心逻辑不变
• 工作表标题对比是严格匹配的，如果你需要模糊匹配，可以修改sheet_exists?方法里的判断逻辑
• 批量更新请求还可以添加更多配置，比如设置工作表的行数、列数，只需在SheetProperties里添加对应的参数即可

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