如何使用gspread API获取谷歌表格（Google Sheets）的工作表名称

前置准备 #

• 已完成gspread安装，未安装可执行命令：pip install gspread
• 已配置谷歌云服务账号密钥，且该服务账号已被添加到目标谷歌表格的协作者列表，拥有至少查看权限

步骤1：提取目标表格的文件ID #

你提供的链接格式中，d/ 和 /edit 中间的字符串就是表格的唯一文件ID，对应你的案例，文件ID为：1dprQgvpy-qHNU5eHDoOUf9qXi6EqwBbsYPKHB_3c

步骤2：通过文件ID打开目标表格 #

示例代码如下：

import gspread

# 初始化认证客户端，替换为你的服务账号密钥文件路径
gc = gspread.service_account(filename="你的服务账号密钥.json")
# 用提取到的文件ID打开表格
spreadsheet = gc.open_by_key("1dprQgvpy-qHNU5eHDoOUf9qXi6EqwBbsYPKHB_3c")

步骤3：获取工作表名称 #

方案1：获取该表格下所有工作表的名称 #

# 直接生成所有工作表名称的列表
all_sheet_names = [sheet.title for sheet in spreadsheet.worksheets()]
print(all_sheet_names)

方案2：获取链接中指定gid对应的工作表名称 #

你的链接末尾gid=1139845333对应单个工作表的唯一ID，可通过如下代码匹配对应的工作表名称：

target_gid = 1139845333
# 匹配对应gid的工作表
target_sheet = next(sheet for sheet in spreadsheet.worksheets() if sheet.id == target_gid)
print(f"对应工作表名称为：{target_sheet.title}")

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