Agregar una imagen a una hoja de cálculo de Excel – API de Aspose.Cells Cloud
Esta API REST agrega una nueva imagen a una hoja de cálculo de Excel.
Requisitos previos: Debe tener un token de autenticación válido de Aspose Cloud, un libro existente almacenado en un almacenamiento admitido y los permisos adecuados para modificar la hoja de cálculo.
API PutWorksheetAddPicture
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures
Seguridad y autenticación
Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.
Parámetros de solicitud
| Nombre del parámetro | Tipo | Ubicación | Descripción |
|---|---|---|---|
| name | string | path | Nombre del libro. |
| sheetName | string | path | Nombre de la hoja de cálculo. |
| picture | object | body | Objeto de imagen (datos binarios). |
| upperLeftRow | integer | query | Índice de base cero de la fila superior izquierda donde se colocará la imagen. |
| upperLeftColumn | integer | query | Índice de base cero de la columna superior izquierda donde se colocará la imagen. |
| lowerRightRow | integer | query | Índice de base cero de la fila inferior derecha del área de la imagen. |
| lowerRightColumn | integer | query | Índice de base cero de la columna inferior derecha del área de la imagen. |
| picturePath | string | query | Ruta al archivo de imagen; si se omite, los datos de la imagen deben suministrarse en el cuerpo de la solicitud. |
| folder | string | query | Carpeta que contiene el libro. |
| storageName | string | query | Nombre del servicio de almacenamiento. |
Nota sobre el cuerpo de la solicitud: Cuando se omite picturePath, envíe los datos binarios de la imagen en el cuerpo de la solicitud utilizando multipart/form-data.
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 faltantes o no válidos (por ejemplo, tipo de archivo no admitido). |
| 401 | No autorizado | Token JWT inválido o faltante. |
| 413 | Carga útil demasiado grande | El archivo cargado excede el límite de tamaño. |
| 500 | Error interno del servidor | Error inesperado del servidor. |
Ejemplo de esquema de respuesta 200
{
"Code": 200,
"Status": "OK",
"PictureUrl": "https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/pictures/1"
}
Nota: El tamaño máximo de la imagen es de 10 MB; los archivos más grandes se rechazarán con una respuesta 400 Bad Request.
La Especificación OpenAPI define una interfaz de programación pública accesible 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 con cURL.
Familia de SDK en la nube
Utilizar un SDK es la mejor forma 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 realizar llamadas a los servicios web de Aspose.Cells mediante diversos SDK:
Nota: Los formatos de imagen admitidos incluyen PNG, JPEG, BMP y GIF. El tamaño máximo de la imagen es de 10 MB; los archivos más grandes se rechazarán con una respuesta 400 Bad Request.