使用 Aspose.Cells Cloud API 向 Excel 工作表添加形状

此 REST API 可向 Excel 工作表添加形状。
该端点属于 API 版本 v3.0；请确保您使用通过 Aspose Cloud OAuth2 流程（client-id/client-secret）获取的 JWT 访问令牌，并将其包含在 Authorization: Bearer <token> 请求头中。

安全与身份验证

Aspose.Cells Cloud API 采用安全机制，需要 基于 JWT 令牌的身份验证。

PutWorksheetShape API

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/shapes

请求参数

参数名 类型 位置 描述
name string path 文档名称。
sheetName string path 工作表名称。
shapeDTO object body 描述待添加形状的 JSON 对象（完整架构请参见 OpenAPI 规范）。
drawingType string query 形状对象类型（如 arc、line、rectangle）。
upperLeftRow integer query 形状左上角所在的行索引。
upperLeftColumn integer query 形状左上角所在的列索引。
top integer query 形状顶部边缘与其起始位置之间的垂直偏移量（单位：像素）。
left integer query 形状左侧边缘与其起始位置之间的水平偏移量（单位：像素）。
width integer query 形状宽度（单位：像素）。
height integer query 形状高度（单位：像素）。
folder string query 包含该文档的文件夹路径。
storageName string query 存储空间名称。

OpenAPI 规范 定义了一个公开可访问的编程接口，允许您直接通过网页浏览器执行 REST 交互。

您可使用 cURL 命令行工具轻松访问 Aspose.Cells Web 服务。以下示例展示了如何使用 cURL 调用云 API。

HTTP 状态码

状态码 含义 描述
200 OK（成功） 筛选器应用成功；响应包含操作详情。
400 Bad Request 参数缺失或无效（如不支持的文件类型）。
401 Unauthorized JWT 令牌无效或缺失。
413 Payload Too Large 上传文件超出大小限制。
500 Internal Server Error 服务器内部意外错误。

典型错误响应包括：

  • 400 Bad Request – 参数缺失或无效。
  • 401 Unauthorized – JWT 令牌无效或缺失。
  • 404 Not Found – 指定的工作表或文档不存在。

每个错误均以 JSON 对象形式返回，包含 Code 和 Message 字段。

云 SDK 家族

使用 SDK 是加快开发速度的最佳方式。SDK 会处理底层细节，让您专注于项目任务本身。如需了解 Aspose.Cells Cloud SDK 的完整列表，请查看 GitHub 仓库。

以下代码示例展示了如何使用不同语言的 SDK 调用 Aspose.Cells Web 服务：

从 Excel 工作表中按索引获取形状 更新 Excel 工作表中的图形