Question

fileID 300

接口说明

在表格中批量插入图片（包括单元格图片、浮动图片）

备注：

1. 注意： 插入图片前需要先 上传图片，获取 imageID。
2. 向相同位置插入浮动图片时，后插入的图片会覆盖先插入的图片，两张图片都会同时存在。
3. 单次请求允许最大插入图片数量为 500

权限说明

本接口需要拥有以下任意一项权限：

• scope.sheet

请求格式:

描述	定义
Path	https://docs.qq.com/openapi/sheetbook/v2/{bookID}:batchUpdate
Method	POST
Content-Type	application/json
Accept	application/json

请求头部

详见Headers。

请求参数

路径参数:

参数名	类型	必选	描述
bookID	string	是	fileID

查询参数

无

请求体

参数名	类型	必选	描述
insertImages	object(InsertImages)	是	插入图片请求

响应参数

响应体

参数名	类型	描述
ret	integer	业务响应码，0 为成功
msg	string	业务响应信息

请求包体

POST openapi/sheetbook/v2/300000000$AAAAAAAAAAAA:batchUpdate HTTP/1.1
Host: docs.qq.com
Access-Token: ACCESS_TOKEN
Client-Id: CLIENT_ID
Open-Id: OPEN_ID
Content-Type: application/json
Content-Length: 386

{"bookID":"300000000$XXXXXXXXXXXX","insertImages":{"sheetID":"BBAAAA","images":[{"type":1,"url":"https://docs.qq.com/images/example-url","width":100,"height":100,"row":1,"col":1,"offsetX":null,"offsetY":null,"clip_info":null},{"type":2,"url":"https://docs.qq.com/images/example-url","width":80.5,"height":70.5,"row":5,"col":5,"offsetX":10.0,"offsetY":8.0,"clip_info":{"bottom":10.0}}]}}

示例

本示例批量插入了两个图片，分别为单元格图片和浮动图片。

curl --location --request POST 'https://docs.qq.com/openapi/sheetbook/v2/300000000$LsFqFleMBoXg:batchUpdate' \
--header 'Access-Token: ACCESS_TOKEN' \
--header 'Client-Id: CLIENT_ID' \
--header 'Open-Id: OPEN_ID' \
--header 'Content-Type: application/json' \
--data-raw '{
    "bookID":"300000000$XXXXXXXXXXXX",
    "insertImages": {
        "sheetID": "BBAAAA",
        "images": [
            {
                "type": 1,
                "url": "https://docs.qq.com/images/example-url",
                "width": 100,
                "height": 100,
                "row": 1,
                "col": 1,
                "offsetX": null,
                "offsetY": null,
                "clip_info": null
            },
            {
                "type": 2,
                "url": "https://docs.qq.com/images/example-url",
                "width": 80.5,
                "height": 70.5,
                "row": 5,
                "col": 5,
                "offsetX": 10.0,
                "offsetY": 8.0,
                "clip_info": {
                    "bottom": 10.0
                }
            }
        ]
    }
}'

响应包体

HTTP/1.1 200 OK
Date: Thu, 28 Jul 2022 15:34:46 GMT
Content-Type: text/plain; charset=utf-8
Content-Length: 2
Connection: keep-alive

{"ret":0,"msg":"Succeed"}

错误码

错误码	错误说明	排查建议
10313	Access-Token 为空	HTTP Header 里 Access-Token 校验失败，请参考示例中的携带方式，检查相应字段。详情请见Headers。
10303	Open-Id 错误	HTTP Header 里 Open-Id 与预期不符，可能的原因有： - Open-Id为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - Open-Id与Access-Token不匹配，请检查Header内容和获取Token接口回包是否一致。
10302	Client-Id 错误	HTTP Header 里 Client-Id 与预期不符，可能的原因有： - Client-Id为空。请参考示例中的携带方式，检查相应字段。详情请见Headers。 - Client-Id与Access-Token不匹配，请检查Header内容和调用获取Token接口接口时参数中的Client-Id是否一致。
37019	Token校验失败，错误或过期	检查位于HTTP Header 中的 Access-Token 是否正确，获取Token的方式请查阅授权流程以及获取Token接口

查询更多业务返回码