如何从Google Sheets单个单元格提取多个超链接（含Python API实现问题）

我太懂你这种挫败感了！之前我用普通的Sheets API取值，也只能拿到单元格显示的纯文本，完全摸不到里面藏的多个超链接——你之前的代码问题就出在这儿：spreadsheets().values().get()这个方法只会返回单元格的纯文本内容，根本不会包含超链接这类富文本格式的元数据，不管你怎么调参数或者用公式，都拿不到想要的结果。

别着急，咱们换个API调用方式就能解决，直接获取单元格的富文本格式信息就行，下面是具体的Python实现步骤：

核心思路 #

要提取单个单元格里的多个超链接，必须调用spreadsheets().get()（或者batchGet()），通过指定fields参数，让API返回单元格的富文本分段格式信息——每个超链接对应富文本里的一个格式分段，我们只需要遍历这些分段就能把链接捞出来。

完整代码示例 #

from googleapiclient.discovery import build
from google.oauth2.credentials import Credentials

# 这里是你的认证代码，和之前保持一致
creds = Credentials.from_authorized_user_file('token.json', ['https://www.googleapis.com/auth/spreadsheets.readonly'])
service = build('sheets', 'v4', credentials=creds)

SAMPLE_SPREADSHEET_ID = "你的表格ID"
SAMPLE_RANGE_NAME = "要提取的单元格范围，比如Sheet1!A1"

# 调用spreadsheets.get，指定要获取的范围和需要的格式字段
result = service.spreadsheets().get(
    spreadsheetId=SAMPLE_SPREADSHEET_ID,
    ranges=SAMPLE_RANGE_NAME,
    # 只请求我们需要的富文本链接字段，减少返回数据量
    fields='sheets(data(rowData(values(textFormatRuns,userEnteredValue.stringValue))))'
).execute()

# 解析结果，提取所有超链接
extracted_links = []
# 逐层遍历返回的嵌套结构
for sheet in result.get('sheets', []):
    for data_block in sheet.get('data', []):
        for row in data_block.get('rowData', []):
            for cell in row.get('values', []):
                # 可选：获取单元格的完整文本，方便对应链接的文本片段
                cell_full_text = cell.get('userEnteredValue', {}).get('stringValue', '')
                # 获取单元格的富文本格式分段列表
                format_runs = cell.get('textFormatRuns', [])
                # 遍历每个格式分段，提取链接
                for idx, run in enumerate(format_runs):
                    # 获取当前分段的起始索引
                    start_idx = run.get('startIndex', 0)
                    # 获取下一个分段的起始索引，用来截取对应文本（可选）
                    end_idx = format_runs[idx+1].get('startIndex', len(cell_full_text)) if idx+1 < len(format_runs) else len(cell_full_text)
                    # 提取当前分段的超链接
                    link_uri = run.get('format', {}).get('textRun', {}).get('link', {}).get('uri')
                    if link_uri:
                        # 可以选择只存链接，或者把文本片段和链接一起存
                        extracted_links.append({
                            'text': cell_full_text[start_idx:end_idx],
                            'link': link_uri
                        })

# 打印结果
print("提取到的超链接：")
for item in extracted_links:
    print(f"文本：{item['text']} → 链接：{item['link']}")

关键注意事项 #

• 权限问题：确保你的认证凭据有https://www.googleapis.com/auth/spreadsheets.readonly（只读）或者https://www.googleapis.com/auth/spreadsheets（读写）的权限，不然会被拒绝访问格式信息。
• fields参数优化：上面的fields参数只请求了我们需要的字段，避免返回整个表格的冗余数据，如果你需要更多信息，可以调整这个参数。
• 空链接过滤：单元格里可能有部分文本没有超链接，这时候link_uri会是None，所以我们加了判断再添加到列表里。

另外补充一句：你之前尝试用公式也没用，是因为Google Sheets的普通公式无法读取单元格的富文本格式，只能处理单个链接的情况，这种多链接的场景必须靠API或者Google Apps Script来解决。

备注：内容来源于stack exchange，提问作者Decard Cain