如何通过googlesheets4包API上传本地/R绘图图片至Google Sheets

直接答复核心疑问：

• Google Sheets内置的=IMAGE()函数不支持传入本地文件路径，仅能加载可被谷歌服务器公开访问的网络URL，本地路径无论怎么写都无法被Sheets服务端读取，不存在绕过方法。
• 没有专门用于上传图片到Sheets的独立API端点，组合使用现有Google Sheets API + Google Drive API即可完成所有操作，不需要申请特殊接口权限。

不管是本地磁盘存储的图片，还是R环境中生成的绘图对象，都可以通过R实现插入到已有Google表格，具体实现方案如下。

先安装需要的R包，完成账号授权，两个包共用同一套谷歌账号凭证，授权一次即可：

install.packages(c("googlesheets4", "googledrive", "ggplot2"))
library(googlesheets4)
library(googledrive)
# 替换为你自己的谷歌账号
gs4_auth(email = "your_google_account@gmail.com")
drive_auth(email = "your_google_account@gmail.com")

1. 插入本地磁盘存储的图片 #

核心逻辑是先把本地图片上传到你的个人谷歌云盘，生成可被Sheets访问的资源链接，再写入目标单元格，不需要把图片上传到公网图床：

# 替换为你自己的参数
gs_id <- "你的目标Google表格ID，从表格URL里获取"
local_img_path <- "./test.png" # 本地图片的存储路径
target_range <- "工作表1!A2" # 图片要插入的单元格位置

# 上传本地图片到个人谷歌云盘的指定文件夹
img_file <- drive_upload(
  media = local_img_path,
  path = "~/sheets_temp/", # 你云盘里专门存临时素材的文件夹
  type = "image/png",
  overwrite = TRUE
)
# 给图片开读取权限，保证Sheets服务端可以加载
drive_share(img_file, role = "reader", type = "anyone")
# 生成IMAGE公式写入指定单元格
img_formula <- paste0('=IMAGE("https://drive.google.com/uc?export=download&id=', img_file$id, '")')
gs4_formula(ss = gs_id, formula = img_formula, range = target_range)

如果需要插入浮动在单元格上方、不占用单元格内容的图片，直接调用Sheets API的AddSheetImageRequest方法，传入刚才上传得到的云盘图片ID，指定锚定的单元格位置即可。

2. 插入R环境内生成的绘图对象 #

和本地图片的逻辑完全一致，只多一步临时存图的操作，不需要额外接口：

# 以ggplot对象为例，base R绘图逻辑相同
library(ggplot2)
# 假设p是你在R环境中生成的绘图对象
p <- ggplot(iris, aes(Sepal.Length, Sepal.Width, color = Species)) + geom_point()
# 生成临时文件路径保存绘图
temp_file <- tempfile(fileext = ".png")
ggsave(temp_file, plot = p, width = 7, height = 5, dpi = 150)

# 后续操作和本地图片插入完全一致
img_file <- drive_upload(media = temp_file, path = "~/sheets_temp/", type = "image/png", overwrite = T)
drive_share(img_file, role = "reader", type = "anyone")
gs4_formula(ss = gs_id, formula = paste0('=IMAGE("https://drive.google.com/uc?export=download&id=', img_file$id, '")'), range = target_range)

# 操作完成后删除本地临时文件即可
unlink(temp_file)

• 不要尝试直接把本地文件路径传入IMAGE()函数，谷歌的Sheets服务器无法访问你本地磁盘的文件，所有这类尝试都会返回加载错误。
• 上传到云盘的图片如果显示无权限加载，检查权限设置是否为「持有链接的用户可查看」，不要设置为仅个人可见。
• 如果不需要保留云盘里的临时图片，插入完成后可以调用drive_rm(img_file)删除云盘临时文件，不影响表格内已经插入的图片显示。

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