Actualizar propiedades del gráfico – Aspose.Cells Cloud REST API
Esta API REST actualiza las propiedades del gráfico.
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
API PostWorksheetChart
POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/charts/{chartIndex}
Parámetros de la solicitud
| Nombre del parámetro | Tipo | Ruta / Cadena de consulta / Cuerpo HTTP | Descripción |
|---|---|---|---|
| name | string | ruta | Nombre del archivo de Excel. |
| sheetName | string | ruta | Nombre de la hoja de cálculo que contiene el gráfico. |
| chartIndex | integer | ruta | Índice basado en cero del gráfico que se va a actualizar. |
| chart | object | cuerpo | Objeto JSON que define las propiedades del gráfico que se modificarán. |
| folder | string | consulta | Carpeta en el almacenamiento donde se encuentra el archivo. |
| storageName | string | consulta | Nombre del servicio de almacenamiento. |
Esquema del cuerpo de la solicitud
El objeto chart contiene las propiedades que puede modificar. A continuación se muestra un ejemplo representativo en JSON que incluye varios campos comúnmente utilizados:
{
"Title": {
"Text": "Ventas trimestrales"
},
"ShowLegend": true,
"Type": "Line",
"DataLabels": {
"ShowValue": true,
"ShowPercentage": false
},
"ChartArea": {
"BorderColor": "Blue",
"FillColor": "White"
}
}
Nota: Solo es necesario proporcionar los campos que se desean cambiar. Las propiedades omitidas conservan sus valores actuales.
La Especificación OpenAPI define una interfaz de programación accesible públicamente y le permite realizar interacciones REST directamente desde un navegador web.
Puede utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar llamadas a la API en la nube mediante cURL.
Respuesta
La API devuelve un objeto JSON que indica el resultado de la operación. Una actualización correcta produce:
{
"Code": 200,
"Status": "OK"
}
Códigos de estado de éxito
| Estado HTTP | Descripción |
|---|---|
| 200 | OK – Las propiedades del gráfico se actualizaron correctamente. |
Encabezados de respuesta
| Encabezado | Descripción |
|---|---|
Content-Type |
application/json – Indica que el cuerpo de la respuesta está en formato JSON. |
X-RequestId |
Identificador único de la solicitud (útil para la resolución de problemas). |
Las respuestas de error posibles incluyen:
| Estado HTTP | Descripción |
|---|---|
| 400 | Solicitud incorrecta – parámetros o cuerpo no válidos |
| 401 | No autorizado – token faltante o no válido |
| 404 | No encontrado – archivo, hoja de cálculo o gráfico no hallado |
| 500 | Error interno del servidor |
Para otras operaciones relacionadas con gráficos, consulte los temas relacionados, como Actualizar el título del gráfico y Actualizar la leyenda del gráfico.
Familia de SDK en la nube
Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK se encarga de los detalles de bajo nivel y le permite centrarse en las tareas de su proyecto. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK: