从 Excel 工作表中按索引获取形状 – Aspose.Cells Cloud 文档

此 REST API 用于从 Excel 工作表中检索形状（包括其图像数据或元数据）。

GetWorksheetShape API

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

前提条件

  • 有效的 Aspose Cloud 访问令牌（Bearer JWT）。
  • 工作簿必须存储在您的 Aspose Cloud 存储中或指定的文件夹中。

安全与身份验证

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

请求参数

参数名 类型 位置 描述
name string path Excel 文档的名称。
sheetName string path 包含该形状的工作表名称。
shapeindex integer path 形状在工作表中的从零开始的索引。
folder string query 存储文档的文件夹路径。
storageName string query 存储服务的名称。

注意： shapeindex 为从零开始的索引，第一个形状的索引为 0。如果您未使用默认存储，请确保工作簿已存储在指定的 folder 和 storageName 中。

OpenAPI 规范定义了一个公开可访问的编程接口，允许您直接从 Web 浏览器发起 REST 交互。

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

可能的 HTTP 状态码

状态码 描述
200 OK 成功检索到该形状。
400 Bad Request 请求格式错误或缺少必需参数。
401 Unauthorized 身份验证失败或令牌缺失/无效。
404 Not Found 指定的工作簿、工作表或形状索引不存在。
500 Internal Server Error 发生了意外的服务器错误。

常见错误： 使用错误的基础域名（api.aspose.com）或已弃用的 /autoshapes/ 路径段会导致 404 错误。请始终使用 /shapes/ 路径段和 api.aspose.cloud 域名。

云 SDK 开发工具包

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

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

有关相关操作，请参阅 添加形状 和 更新形状 的文档。

获取 Excel 工作表中的所有形状 向 Excel 工作表添加形状