Agregar una forma a una hoja de cálculo de Excel mediante la API de Aspose.Cells Cloud

Esta API REST agrega una forma a una hoja de cálculo de Excel.
El punto de conexión pertenece a la versión de la API v3.0; asegúrese de utilizar un token de acceso JWT obtenido a través del flujo OAuth2 de Aspose Cloud (client-id/client-secret) e incluirlo en el encabezado Authorization: Bearer <token>.

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

API PutWorksheetShape

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del documento.
sheetName	string	path	Nombre de la hoja de cálculo.
shapeDTO	object	body	Objeto JSON que describe la forma a agregar (consulte la especificación OpenAPI para el esquema completo).
drawingType	string	query	Tipo de objeto de forma (por ejemplo, `arc`, `line`, `rectangle`).
upperLeftRow	integer	query	Índice de fila superior izquierdo de la forma.
upperLeftColumn	integer	query	Índice de columna superior izquierdo de la forma.
top	integer	query	Desplazamiento vertical de la forma desde su borde superior, en píxeles.
left	integer	query	Desplazamiento horizontal de la forma desde su borde izquierdo, en píxeles.
width	integer	query	Ancho de la forma, en píxeles.
height	integer	query	Alto de la forma, en píxeles.
folder	string	query	Carpeta que contiene el documento.
storageName	string	query	Nombre del almacenamiento.

La Especificación OpenAPI define una interfaz de programación públicamente accesible y 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 una llamada a la API en la nube con cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/shapes?DrawingType=arc&upperLeftRow=1&upperLeftColumn=1&top=1&left=1&width=100&height=100" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

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

La respuesta correcta devuelve el código de estado HTTP, un texto de estado y el identificador de la forma recién creada (ShapeId).

Códigos de estado HTTP

Código	Significado	Descripción
200	OK	Filtro aplicado correctamente; la respuesta contiene los detalles de la operación.
400	Solicitud incorrecta	Parámetros ausentes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT no válido o ausente.
413	Carga útil demasiado grande	El archivo subido excede el límite de tamaño.
500	Error interno del servidor	Error inesperado del servidor.

Las respuestas de error típicas incluyen:

400 Solicitud incorrecta – parámetros ausentes o no válidos.
401 No autorizado – token JWT no válido o ausente.
404 No encontrado – la hoja de cálculo o el documento especificados no existen.

Cada error se devuelve como un objeto JSON que contiene los campos Code y Message.

Familia de SDK en la nube

Utilizar un SDK es la mejor manera de acelerar el desarrollo. Un SDK gestiona los detalles de bajo nivel para que usted pueda 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 invocar los servicios web de Aspose.Cells mediante varios SDK:

Obtener una forma por índice en una hoja de cálculo de Excel Actualizar una forma en una hoja de cálculo de Excel