Aspose.Cells Cloud API – 合并单元格区域

此 REST API 可将 Excel 工作表中的单元格区域合并为单个单元格。

概述：合并区域会将所选单元格合并为一个单元格，保留左上角单元格的值，并丢弃其余单元格。当您需要创建跨多列或多行的标题，或希望简化工作表布局时，可使用此操作。

REST API

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/merge

请求参数

参数名称	类型	位置	描述
name	string	path	工作簿名称。
sheetName	string	path	工作表名称。
range	object	body	指定待合并单元格的区域对象。
folder	string	query	存储工作簿的文件夹。
storageName	string	query	存储名称。

请求体架构

Range 对象必须包含以下字段（其余字段均为可选）：

属性	类型	必需	描述
FirstRow	integer	是	区域中首行的从零开始的索引。
FirstColumn	integer	是	区域中首列的从零开始的索引。
RowCount	integer	是	区域中包含的行数。
ColumnCount	integer	是	区域中包含的列数。
Name	string	否	区域的可选名称。
RefersTo	string	否	区域所引用的公式。
Worksheet	string	否	工作表名称（若与路径参数不同）。
RowHeight	number	否	区域内行高（像素）。
ColumnWidth	number	否	区域内列宽（像素）。

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

请求

curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/merge" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "FirstRow": 9,
        "FirstColumn": 0,
        "RowCount": 1,
        "ColumnCount": 7
      }'

响应

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

响应详情

HTTP 状态码	描述	示例 JSON
200 OK	区域已成功合并。	`{ "Code": 200, "Status": "OK" }`
400 Bad Request	区域参数无效（例如索引越界）。	`{ "Code": 400, "Message": "Invalid range." }`
401 Unauthorized	缺少或无效的 JWT 令牌。	`{ "Code": 401, "Message": "Authentication failed." }`
404 Not Found	工作簿或工作表未找到。	`{ "Code": 404, "Message": "Resource not found." }`
500 Internal Server Error	服务器内部错误。	`{ "Code": 500, "Message": "Internal server error." }`

云 SDK 开发工具包

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

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