创建浮动图片

根据传入的参数创建一张浮动图片。Float_image_token （上传图片至表格后得到）和range（只支持一个单元格）必填。Float_image_id 可选，不填的话会默认生成，长度为10，由 0-9、a-z、A-Z 组合生成。表格内不重复的图片（浮动图片+单元格图片）总数不超过4000。width 和 height 为图片展示的宽高，可选，不填的话会使用图片的真实宽高。offset_x 和 offset_y 为图片左上角距离所在单元格左上角的偏移，可选，默认为 0。
浮动图片的设置参考：浮动图片指南

错误码

HTTP状态码	错误码	描述	排查建议
400	1310229	Wrong URL Param	检查 url 参数
400	1310217	Too Many Request	检查请求是否发送过于频繁
400	1310235	Retry Later	稍后重试
500	1315201	Server Error	服务内部错误，详询客服
400	1310214	SpreadSheet Not Found	检查表格 token
400	1310213	Permission Fail	没有文档相应权限
400	1310215	Sheet Id Not Found	检查 sheet_id
400	1310202	Wrong Range	区域范围错误
400	1310245	Wrong Float Image Token	检查 Float Image Token
400	1310244	Exist Float Image Id	检查 Float Image Id
400	1310243	Wrong Float Image Id	检查 Float Image Id
400	1310211	Wrong Sheet Id	检查 sheet_id
400	1310247	Image Excess	图片总数超出限制
400	1310246	Wrong Float Image Value	图片宽高或者偏移错误
400	1310218	Locked Cell	检查操作的是否为保护范围
400	1310226	Excess Limit	超出限制，参考响应体中的错误提示
400	1310242	In Mix state	Retey Later
500	1315203	Server Error	服务内部错误，详询客服
400	1310249	Spreadsheet Deleted	恢复表格后重试

curl --location --request POST 'https://open.feishu.cn/open-apis/sheets/v3/spreadsheets/shtcnmBA*****yGehy8/sheets/0b**12/float_images' \ --header 'Authorization;' \ --header 'Content-Type: application/json' \ --data-raw '{ "float_image_id": "ye06SS14ph", "float_image_token": "boxbcbQsaSqIXsxxxxx1HCPJFbh", "range": "0b**12!A1:A1", "width": 100, "height": 100, "offset_x": 0, "offset_y": 0 }'

{ "code": 0, "msg": "success", "data": { "float_image": { "float_image_id": "ye06SS14ph", "float_image_token": "boxbcbQsaSqIXsxxxxx1HCPJFbh", "range": "0b**12!A1:A1", "width": 100, "height": 100, "offset_x": 0, "offset_y": 0 } } }

请求参数

Path 参数

spreadsheet_token

string

必需

表格 token 示例值："shtcnmBA*****yGehy8"

示例值:

shtcnmBA*****yGehy8

sheet_id

string

必需

子表 id 示例值："0b**12"

示例值:

0b**12

Header 参数

Authorization

string

必需

tenant_access_token 或 user_access_token 值格式："Bearer access_token" 示例值："Bearer u-7f1bcd13fc57d46bac21793a18e560"

默认值:

Bearer {{access_token}}

Content-Type

string

必需

固定值："application/json; charset=utf-8"

默认值:

application/json; charset=utf-8

Body 参数application/json

float_image_id

string

可选

浮动图片 id 示例值："ye06SS14ph"

float_image_token

string

可选

【更新时不用传，创建需要】浮动图片 token，需要先上传图片到表格获得此 token 之后再进行浮动图片的相关操作示例值："boxbcbQsaSqIXsxxxxx1HCPJFbh"

range

string

可选

浮动图片的左上角单元格定位，只支持一个单元格示例值："0b**12!A1:A1"

width

integer

可选

height

integer

可选

offset_x

integer

可选

offset_y

integer

可选

示例

application/json

Body

code

integer

必需

错误码，非 0 表示失败

msg

string

错误描述

必需

data

object

必需

float_image

object

浮动图片返回值

必需

错误码#

请求参数

返回响应

错误码