Копирование диапазона в листе с параметрами вставки – Aspose.Cells Cloud API

Этот REST API копирует диапазон в листе книги Excel. Для смежных операций см. документацию Получить диапазон и Обновить диапазон.

Необходимые условия: Для использования этого конечного узла необходимо иметь действительный маркер OAuth 2.0 / JWT и убедиться, что версия API соответствует URL запроса.

REST API

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

Параметры запроса

Название параметра	Тип	Расположение	Описание
name	string	path	Имя книги.
sheetName	string	path	Имя листа.
rangeOperate	string	body	Выполняемая операция: `copydata`, `copystyle`, `copyto` или `copyvalue`.
folder	string	query	Папка, содержащая книгу.
storageName	string	query	Имя сервиса хранения.

Примечания: Поле rangeOperate определяет, что именно копируется. Используйте copydata для копирования только значений ячеек, copystyle — для форматирования, copyto — для копирования и данных, и форматирования, и copyvalue — для копирования значений без формул. API поддерживает диапазоны до 1 миллиона ячеек; более крупные диапазоны могут привести к тайм-ауту.

Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

Вы можете использовать утилиту командной строки cURL для простого доступа к веб-сервисам Aspose.Cells. В следующем примере показано, как делать вызовы в облачный API с помощью cURL.

Запрос

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
        }
      }'

Ответ

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

При успешном выполнении возвращается статус 200 OK. В случае ошибки API может вернуть payloads следующего вида:

{
  "Code": 400,
  "Message": "Bad Request – недопустимые параметры."
}

или

{
  "Code": 401,
  "Message": "Unauthorized – отсутствующий или недействительный маркер аутентификации."
}

Объекты ошибок содержат HTTP-код статуса и описательное сообщение для диагностики проблем.

Вы можете загрузить образец книги для тестирования операции копирования здесь.

Семейство облачных SDK

Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя вам сосредоточиться на задачах проекта. Ознакомьтесь с репозиторием на GitHub, чтобы увидеть полный список облачных SDK Aspose.Cells.

Следующие примеры кода демонстрируют, как вызывать веб-сервисы Aspose.Cells с использованием различных SDK: