Obtener objeto OLE de una hoja de cálculo de Excel – Aspose.Cells Cloud API

Esta API REST recupera un objeto OLE de una hoja de cálculo de Excel.

Seguridad y autenticación

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

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}

Parámetros de 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.
objectNumber	integer	path	Número del objeto dentro de la hoja de cálculo.
format	string	query	Formato de exportación deseado para el objeto (p. ej., `png`, `jpeg`).
folder	string	query	Carpeta que contiene el documento.
storageName	string	query	Nombre del almacenamiento a utilizar.

Opciones de almacenamiento

folder – especifica la subcarpeta en el almacenamiento predeterminado donde se encuentra el libro.
storageName – anula el nombre predeterminado del almacenamiento si el libro se encuentra en otra ubicación.

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 llamar al servicio web de Aspose.Cells. El ejemplo siguiente muestra cómo solicitar un objeto OLE como imagen PNG.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

Respuesta con imagen binaria

Cuando format se establece en un tipo de imagen (p. ej., png), la API devuelve los datos binarios de la imagen con el encabezado:

Content-Type: image/png

(El archivo de imagen se transmite directamente al cliente.)

Respuesta con metadatos en JSON

Si se omite format o se establece en json, la API devuelve una carga útil en JSON que describe el objeto OLE:

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Name": "Object1",
    "Width": 200,
    "Height": 150,
    "Left": 10,
    "Top": 20,
    "IsLocked": false,
    "FileFormat": "png"
  }
}

Respuestas de error

Estado HTTP	Código de error	Descripción
400	BadRequest	Parámetros ausentes o no válidos.
401	Unauthorized	Token JWT no válido o ausente.
404	NotFound	Libro, hoja de cálculo u objeto OLE no encontrado.
500	ServerError	Error inesperado del servidor.

Ejemplo de respuesta 404

{
  "Code": 404,
  "Status": "NotFound",
  "Message": "No se encontró el objeto OLE solicitado con número 0 en la hoja 'Sheet1'."
}

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de integrar la API. Los SDK gestionan los detalles de bajo nivel para que usted pueda centrarse en su lógica de negocio. 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 llamar a los servicios web de Aspose.Cells con distintos SDK:

Agregar un objeto OLE en una hoja de cálculo de Excel