Copiar un rango en una hoja de cálculo con opciones de pegado – API de Aspose.Cells Cloud

Esta API REST copia un rango en una hoja de cálculo de un libro de Excel. Para operaciones relacionadas, consulte la documentación sobre Obtener rango y Actualizar rango.

Requisitos previos: Para usar este endpoint, debe tener un token válido de OAuth 2.0 / JWT y asegurarse de que su versión de API coincida con la URL de la solicitud.

API REST

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

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	El nombre del libro de cálculo.
sheetName	string	path	El nombre de la hoja de cálculo.
rangeOperate	string	body	La operación a realizar: `copydata`, `copystyle`, `copyto` o `copyvalue`.
folder	string	query	La carpeta que contiene el libro de cálculo.
storageName	string	query	El nombre del servicio de almacenamiento.

Notas: El campo rangeOperate determina qué se copia. Use copydata para copiar únicamente los valores de las celdas, copystyle para el formato, copyto para ambos (datos y formato), y copyvalue para copiar valores sin fórmulas. La API admite rangos de hasta 1 millón de celdas; rangos más grandes podrían provocar un tiempo de espera.

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 mediante cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/ranges" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "Operate": "string",
        "Source": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "Target": {
          "ColumnCount": 0,
          "ColumnWidth": 0,
          "FirstColumn": 0,
          "FirstRow": 0,
          "Name": "string",
          "RefersTo": "string",
          "RowCount": 0,
          "RowHeight": 0,
          "Worksheet": "string"
        },
        "PasteOptions": {
          "OnlyVisibleCells": true,
          "PasteType": "string",
          "SkipBlanks": true,
          "Transpose": true
        }
      }'

Respuesta

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

La respuesta correcta devuelve un código de estado 200 OK. En caso de error, la API puede devolver cargas útiles como:

{
  "Code": 400,
  "Message": "Bad Request – parámetros no válidos."
}

{
  "Code": 401,
  "Message": "Unauthorized – token de autenticación faltante o no válido."
}

Estos objetos de error incluyen un código de estado HTTP y un mensaje descriptivo para ayudar a diagnosticar problemas.

Puede descargar un libro de cálculo de ejemplo para probar la operación de copia aquí.

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 ver 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 diversos SDK: