Google Sheets API查找替换如何同时更新单元格文本与链接

我之前也碰到过这个一模一样的问题！确实Google Sheets API自带的FindReplaceRequest没有对应GUI里的「Also search within links」选项，直接用它的话，只能更新单元格显示的文本内容，链接里的URL完全不会被触动。要同时搞定文本和链接的更新，得换个思路——直接操作单元格的富文本格式，因为自动生成的链接本质是富文本的一部分。

下面是具体的实现步骤，我自己亲测有效：

• 第一步：先获取目标单元格范围的详细数据，重点要拿到userEnteredFormat.textFormatRuns（这就是存储富文本格式和链接信息的地方）。
• 第二步：遍历每个单元格的富文本运行项，逐个检查显示文本和链接URL里是否包含你要替换的内容。如果有，就分别替换文本内容和URL中的目标字符串。
• 第三步：把修改后的富文本数据通过UpdateCellsRequest写回对应的单元格。

举个简单的Python代码示例（用Google Sheets API的batchUpdate）：

from googleapiclient.discovery import build

def replace_text_and_link(service, spreadsheet_id, range_name, old_str, new_str):
    # 获取目标范围的单元格数据
    result = service.spreadsheets().get(
        spreadsheetId=spreadsheet_id,
        ranges=range_name,
        fields="sheets(data(rowData(values(userEnteredValue,userEnteredFormat.textFormatRuns))))"
    ).execute()
    
    update_requests = []
    rows = result['sheets'][0]['data'][0]['rowData']
    
    for row_idx, row in enumerate(rows):
        for col_idx, cell in enumerate(row.get('values', [])):
            # 跳过空单元格
            if not cell.get('userEnteredValue') or not cell.get('userEnteredFormat'):
                continue
            
            text_runs = cell['userEnteredFormat']['textFormatRuns']
            updated_runs = []
            
            for run in text_runs:
                # 获取当前运行项的文本内容
                start_idx = run.get('startIndex', 0)
                end_idx = text_runs[text_runs.index(run)+1]['startIndex'] if text_runs.index(run)+1 < len(text_runs) else len(cell['userEnteredValue']['stringValue'])
                text_segment = cell['userEnteredValue']['stringValue'][start_idx:end_idx]
                
                # 替换文本内容
                new_text_segment = text_segment.replace(old_str, new_str)
                
                # 替换链接URL（如果有链接的话）
                updated_format = run.get('format', {})
                if updated_format.get('link'):
                    updated_url = updated_format['link']['url'].replace(old_str, new_str)
                    updated_format['link']['url'] = updated_url
                
                updated_runs.append({
                    'startIndex': start_idx,
                    'format': updated_format
                })
            
            # 更新单元格的显示文本和富文本格式
            new_cell_value = cell['userEnteredValue']['stringValue'].replace(old_str, new_str)
            update_requests.append({
                'updateCells': {
                    'rows': [{
                        'values': [{
                            'userEnteredValue': {'stringValue': new_cell_value},
                            'userEnteredFormat': {'textFormatRuns': updated_runs}
                        }]
                    }],
                    'range': {
                        'sheetId': result['sheets'][0]['properties']['sheetId'],
                        'startRowIndex': row_idx,
                        'endRowIndex': row_idx + 1,
                        'startColumnIndex': col_idx,
                        'endColumnIndex': col_idx + 1
                    },
                    'fields': 'userEnteredValue,userEnteredFormat.textFormatRuns'
                }
            })
    
    # 批量更新单元格
    if update_requests:
        service.spreadsheets().batchUpdate(
            spreadsheetId=spreadsheet_id,
            body={'requests': update_requests}
        ).execute()

需要注意的是：

• 这个方法会处理单元格内的所有富文本片段，不管是带链接还是不带的，确保文本和链接都被替换。
• 如果你的单元格里有多个不同的富文本片段（比如部分文本带链接，部分不带），这个逻辑也能精准处理每个片段。

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