查询浮动图片

获取电子表格工作表内所有的浮动图片的参数信息。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/sheets/v3/spreadsheets/:spreadsheet_token/sheets/:sheet_id/float_images/query
HTTP Method	GET
接口频率限制	100 次/分钟
支持的应用类型	custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可	drive:drive 查看、评论、编辑和管理云空间中所有文件 drive:drive:readonly 查看、评论和下载云空间中所有文件 sheets:spreadsheet 查看、评论、编辑和管理电子表格 sheets:spreadsheet:read 查看电子表格 sheets:spreadsheet:readonly 查看、评论和导出电子表格

请求头

名称	类型	必填	描述
Authorization	string	是	tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token

路径参数

名称	类型	描述
spreadsheet_token	string	电子表格的 token。可通过以下两种方式获取。了解更多，参考电子表格概述。 - 电子表格的 URL：https://sample.feishu.cn/sheets/==Iow7sNNEphp3WbtnbCscPqabcef== - 调用获取文件夹中的文件清单 示例值："Iow7sNNEphp3WbtnbCscPqabcef"
sheet_id	string	电子表格工作表的 ID。调用获取工作表获取 ID。 示例值："0beg12"

cURL 请求示例

curl --location --request GET 'https://open.feishu.cn/open-apis/sheets/v3/spreadsheets/shtbchuIXPxjaYxsZzQxBqxxxxx/sheets/ea131a/float_images/query' \
--header 'Authorization: Bearer t-384c15ba0644b82caecec91553386563c814c4b9' \
--header 'Content-Type: application/json'

响应

响应体

名称	类型	描述
code	int	错误码，非 0 表示失败
msg	string	错误描述
data	\-	-
└ items	float_image\[\]	工作表的所有浮动图片信息
└ float_image_id	string	浮动图片的唯一标识。用于对图片进行增删改查操作。
└ float_image_token	string	浮动图片的 token，用于图片的上传和下载操作。你可通过该 token，调用下载素材接口下载图片。
└ range	string	浮动图片左上角所在单元格位置
└ width	number(float)	浮动图片的宽度，单位为像素。
└ height	number(float)	浮动图片的高度，单位为像素。
└ offset_x	number(float)	浮动图片左上角距离所在单元格左上角的横向偏移，单位为像素。
└ offset_y	number(float)	浮动图片左上角距离所在单元格左上角的纵向偏移，单位为像素。

响应体示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "items": [
            {
                "float_image_id": "ye06SS14ph",
                "float_image_token": "boxbcbQsaSqIXsxxxxx1HCPJFbh",
                "range": "ahgsch!A1:A1",
                "width": 100,
                "height": 100,
                "offset_x": 0,
                "offset_y": 0
            }
        ]
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1310229	Wrong URL Param	检查 URL 中的路径参数是否填写正确
400	1310213	Permission Fail	没有文档权限。参考云文档常见问题问题 3 开通文档权限
400	1310218	Locked Cell	range 参数对应的单元格位置为保护范围。你可调用删除保护范围接口为该单元格删除保护范围或重新设置 range 参数
400	1310214	SpreadSheet Not Found	电子表格 token 不存在。请检查表格 token 是否填写
400	1310215	Sheet Id Not Found	工作表 ID 不存在。请检查工作表 ID 是否填写
400	1310217	Too Many Request	请求发送过于频繁，请稍后重试
400	1310235	Retry Later	稍后重试
500	1315201	Server Error	服务内部错误，请l联系技术支持
500	1315203	Server Error	服务内部错误，请l联系技术支持
400	1310242	In Mix state	当前表格数据位于用户机房，正在将数据恢复到 SaaS 环境中，请稍后重试
400	1310249	Spreadsheet Deleted	电子表格被删除，请恢复表格后重试