向工作表添加图表 – Aspose.Cells Cloud API 指南

此 REST API 可向工作表添加新图表。

前置条件
调用此操作前，请先获取有效的 JWT 访问令牌，并确保目标工作簿已存储在指定文件夹或存储位置中。

PutWorksheetAddChart API

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

安全与身份验证

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

请求参数

参数名称 类型 位置 描述
name string 路径 工作簿名称。
sheetName string 路径 工作表名称。
chartType string 查询 图表类型（参见图表资源中的 Type 属性）。支持的图表类型包括 Bar（柱状图）、Column（条形图）、Line（折线图）、Pie（饼图）、Scatter（散点图）、Area（面积图）、Doughnut（圆环图）、Radar（雷达图）等。
upperLeftRow integer 查询 图表区域左上角行索引（从 0 开始）。
upperLeftColumn integer 查询 图表区域左上角列索引（从 0 开始）。
lowerRightRow integer 查询 图表区域右下角行索引（从 0 开始）。
lowerRightColumn integer 查询 图表区域右下角列索引（从 0 开始）。
area string 查询 提供绘图数据的单元格范围（例如 A1:B5）。
isVertical boolean 查询 指示图表方向是否为纵向。
categoryData string 查询 类别轴数据范围（例如 D1:E10）。
isAutoGetSerialName boolean 查询 若为 true，则自动生成系列名称。
title string 查询 图表标题。
folder string 查询 包含工作簿的文件夹。
storageName string 查询 存储名称。
dataLabels boolean 查询 为 true 时显示数据标签。
dataLabelsPosition string 查询 数据标签位置（例如 Above）。
pivotTableSheet string 查询 包含数据透视表的工作表名称。
pivotTableName string 查询 数据透视表名称。

响应

{
    "Status":"OK",
    "Code":200
}

HTTP 状态码

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

如何使用 PutWorksheetAddChart API 及 SDK

PutWorksheetAddChart API 规范

OpenAPI 规范 定义了一个公开可访问的编程接口，可让您直接通过网页浏览器发起 REST 请求。

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

使用 Aspose.Cells Cloud SDK

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

以下代码示例展示了如何使用多种 SDK 调用 Aspose.Cells Web 服务：

Aspose.Cells Cloud API – 更新图表数值轴（POST /valueaxis） Aspose.Cells Cloud API – 在 Excel 工作表中设置图表标题