Google Sheets API 4：如何获取含前置单引号的单元格原始字符串值？

在Google Sheets中，某单元格输入了'0123（前置单引号用于强制将数字转为文本格式），但通过Sheets API获取该单元格值时，返回的是0123，前置单引号被省略。尝试了所有ValueRenderOption（包括UNFORMATTED_VALUE和FORMULA），都无法获取带单引号的原始内容。

可行解决方案：通过fields参数获取userEnteredValue #

Google Sheets API默认不会返回前置单引号——因为这个单引号是Sheets的格式前缀，不属于单元格的"显示值"或"计算值"，但可以通过指定fields参数，直接获取用户输入的原始内容：

1. 调用spreadsheets.get或spreadsheets.values.get接口时，在请求中添加字段范围参数，精准获取userEnteredValue
2. 响应结果里的userEnteredValue.stringValue字段，会完整返回用户输入的'0123

请求示例（HTTP接口）

GET https://sheets.googleapis.com/v4/spreadsheets/{你的表格ID}?ranges={目标单元格范围}&fields=sheets(data(rowData(values(userEnteredValue))))&key={你的API密钥}

Python客户端库示例

from googleapiclient.discovery import build

# 初始化服务
service = build('sheets', 'v4', credentials=你的认证凭证)

# 发起请求
result = service.spreadsheets().get(
    spreadsheetId='你的表格ID',
    ranges='Sheet1!A1',  # 替换为目标单元格范围
    fields='sheets(data(rowData(values(userEnteredValue))))'
).execute()

# 提取原始值
raw_value = result['sheets'][0]['data'][0]['rowData'][0]['values'][0]['userEnteredValue']['stringValue']
print(raw_value)  # 输出结果：'0123'

为什么ValueRenderOption无法解决问题？ #

ValueRenderOption的所有选项都是针对单元格的显示/计算结果设计的：

• FORMATTED_VALUE：返回单元格最终显示的内容（即去掉单引号的0123）
• UNFORMATTED_VALUE：返回单元格的原始数据类型值（这里识别为文本0123）
• FORMULA：仅返回公式内容，而'0123不属于公式，因此仍返回0123

只有userEnteredValue会直接返回用户输入的完整原始内容，包括用于格式控制的前置单引号。

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