如何用Python在Google Sheets单个单元格添加多个可点击超链接？

问题背景 #

需要通过Python脚本调用Google Sheets API，在单个单元格内添加两个带自定义说明文本的可点击超链接（如Google Drive指向对应网址、Amazon Drive指向对应网址）。尝试使用HYPERLINK函数配合CHAR(10)换行或&拼接文本后，单元格仅显示纯文本，超链接无法点击。

问题原因 #

直接用&拼接HYPERLINK函数的执行结果，会将公式转换为纯文本字符串，而非保留公式的可交互状态；即使使用CHAR(10)换行，若未配置单元格自动换行或公式解析异常，也会导致链接失效。

可行解决方案 #

方案1：使用富文本格式（推荐） #

通过Google Sheets API的富文本功能，给单元格内的不同文本片段单独设置超链接属性，这是最稳定可靠的实现方式，能直接生成可点击的带格式内容。

修改后的Python代码示例（基于gspread库）：

def list_problems(percentage_difference, asin, col_name, message="OK"):
    LIST_PROBLEMS = 'List Problems'

    worksheet = gc.open_by_key(spreadsheet_id).worksheet(LIST_PROBLEMS)
    cell = worksheet.find(asin)
    cell_address = f"{ColumnsRange[col_name]}{cell.row}"

    hyperlink_url1 = "https://drive.google.com/"
    hyperlink_url2 = "https://www.amazon.com"
    text1 = "Google Drive"
    text2 = "Amazon Drive"

    # 定义富文本片段，每个片段对应一个带链接的文本
    rich_text_parts = [
        {
            "text": f"{text1}\n",
            "link": {"url": hyperlink_url1}
        },
        {
            "text": text2,
            "link": {"url": hyperlink_url2}
        }
    ]

    cell_format = {
        "backgroundColor": {
            "red": 183/255,
            "green": 225/255,
            "blue": 205/255
        },
        "wrapStrategy": "WRAP"  # 开启自动换行，让两个链接分两行显示
    }

    # 获取目标单元格并设置富文本
    target_cell = worksheet.range(cell_address)
    target_cell[0].rich_text = rich_text_parts
    worksheet.update_cells(target_cell, value_input_option='USER_ENTERED')

    # 应用单元格背景色等格式
    worksheet.format(cell_address, cell_format)

关键说明：

• 利用rich_text属性定义每个文本片段的内容和对应超链接，每个片段独立可点击。
• 添加wrapStrategy": "WRAP"确保换行生效，实现两行显示的需求。
• 使用update_cells方法而非update，因为后者不支持直接配置富文本属性。

方案2：修正HYPERLINK公式写法（备选） #

若坚持使用公式，需确保公式格式正确，并配置单元格自动换行：

def list_problems(percentage_difference, asin, col_name, message="OK"):
    LIST_PROBLEMS = 'List Problems'

    worksheet = gc.open_by_key(spreadsheet_id).worksheet(LIST_PROBLEMS)
    cell = worksheet.find(asin)
    cell_address = f"{ColumnsRange[col_name]}{cell.row}"

    hyperlink_url1 = "https://drive.google.com/"
    hyperlink_url2 = "https://www.amazon.com"
    text1 = "Google Drive"
    text2 = "Amazon Drive"

    cell_format = {
        "backgroundColor": {
            "red": 183/255,
            "green": 225/255,
            "blue": 205/255
        },
        "wrapStrategy": "WRAP"
    }

    # 修正公式写法，用CHAR(10)实现换行
    cell_data = f'=HYPERLINK("{hyperlink_url1}", "{text1}") & CHAR(10) & HYPERLINK("{hyperlink_url2}", "{text2}")'

    worksheet.update(cell_address, cell_data, value_input_option='USER_ENTERED')
    worksheet.format(cell_address, cell_format)

注意事项：

• 需确保value_input_option='USER_ENTERED'正确传递，让API将内容解析为公式而非纯文本。
• 部分情况下，API对公式的解析可能存在延迟或异常，富文本方案稳定性更高。

内容的提问来源于stack exchange，提问作者Roni Jack Vituli