如何检测Google Sheet单元格是否含超链接？gspread报错解决

问题说明 #

需要编写代码检查Google Sheet某列单元格，筛选出包含超链接的行，但原本地Excel适用的has_hyperlink函数在gspread中报错：AttributeError: 'Cell' object has no attribute 'hyperlink'。

原因分析 #

gspread库的Cell对象结构与本地Excel操作库不同，单元格的超链接信息并非直接通过cell.hyperlink属性访问，而是存储在cell._properties字典的'hyperlink'键中。

解决方案 #

1. 调整超链接检测逻辑，直接检查单元格_properties中是否存在'hyperlink'键
2. 访问超链接内容时，从cell._properties['hyperlink']中获取，而非直接调用cell.hyperlink
3. 遍历目标列的所有单元格，筛选出包含超链接的行

修正后的完整代码 #

import gspread
from oauth2client.service_account import ServiceAccountCredentials

def has_hyperlink(cell):
    """检查单元格是否包含超链接"""
    return 'hyperlink' in cell._properties

# 配置认证信息
scope = ['https://spreadsheets.google.com/feeds', 'https://www.googleapis.com/auth/drive']
credentials = ServiceAccountCredentials.from_json_keyfile_name('path/to/your/credentials.json', scope)
gc = gspread.authorize(credentials)

# 打开目标表格
spreadsheet = gc.open('Your Google Sheet Title')
worksheet = spreadsheet.sheet1

# 指定要检查的列（示例为第2列，即B列）
target_column = 2
# 获取该列所有单元格数据
column_cells = worksheet.col_values(target_column)
row_count = len(column_cells)

# 筛选包含超链接的行
rows_with_hyperlink = []
for row_num in range(1, row_count + 1):
    cell = worksheet.cell(row_num, target_column)
    if has_hyperlink(cell):
        row_data = worksheet.row_values(row_num)
        rows_with_hyperlink.append({
            'row_number': row_num,
            'hyperlink': cell._properties['hyperlink'],
            'row_data': row_data
        })

# 输出结果
if rows_with_hyperlink:
    print("包含超链接的行：")
    for item in rows_with_hyperlink:
        print(f"行号：{item['row_number']}，超链接：{item['hyperlink']}，行内容：{item['row_data']}")
else:
    print("未找到包含超链接的行")

关键修改点 #

• 简化has_hyperlink函数，直接判断_properties中是否存在'hyperlink'
• 访问超链接时使用cell._properties['hyperlink']替代报错的cell.hyperlink
• 添加整列遍历筛选逻辑，满足筛选目标列所有含超链接行的需求

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