Добавление пустого столбца в рабочий лист Excel с помощью API Aspose.Cells Cloud

Этот REST API вставляет один или несколько столбцов в рабочий лист.

Необходимые условия
Перед вызовом этого endpoint убедитесь, что вы выполнили следующие действия:

Получите действительный токен доступа OAuth 2.0 и включите его в заголовок Authorization.
Сохраните целевую рабочую книгу в выбранном хранилище (по умолчанию — «Default») либо укажите соответствующие параметры folder и storageName.
Убедитесь, что имя рабочего листа, указанное в sheetName, существует в рабочей книге.

API PutInsertWorksheetColumns

PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/cells/columns/{columnIndex}?totalColumns=1

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации на основе JWT-токена.

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

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла рабочей книги.
sheetName	string	path	Имя рабочего листа.
columnIndex	integer	path	Индекс столбца (начиная с 0), с которого начинается вставка.
totalColumns	integer	query	Количество вставляемых столбцов.
updateReference	boolean	query	Если true, ссылки на ячейки обновляются с учетом вставки.
folder	string	query	Путь к папке, содержащей рабочую книгу.
storageName	string	query	Имя службы хранилища.

Примечания

Значение columnIndex должно находиться в диапазоне от 0 до текущего количества столбцов в рабочем листе. Вставка за пределами существующего диапазона автоматически расширит лист.
Вставка нескольких столбцов (totalColumns > 1) сдвигает существующие столбцы вправо.
Параметр updateReference по умолчанию равен false; установите его в true, чтобы обновить формулы и именованные диапазоны.

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

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

Запрос

curl -X PUT "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/cells/columns/1?totalColumns=1&updateReference=true" \
     -H "Authorization: Bearer <access_token>" \
     -H "accept: application/json"

Ответ

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

Коды ответов

Код	Описание
200	Столбец(ы) успешно вставлены.
400	Неверный запрос — отсутствующие или некорректные параметры.
401	Неавторизовано — недействительный или отсутствующий токен.
404	Рабочая книга или рабочий лист не найдены.
500	Внутренняя ошибка сервера.

Примеры ошибочных ответов

// 400 Bad Request – отсутствующие или некорректные параметры
{
  "Code": 400,
  "Message": "Неверный параметр: totalColumns должно быть положительным целым числом."
}

// 401 Unauthorized – недействительный или отсутствующий токен
{
  "Code": 401,
  "Message": "Ошибка аутентификации. Токен доступа отсутствует или недействителен."
}

// 404 Not Found – рабочая книга или рабочий лист не существует
{
  "Code": 404,
  "Message": "Рабочая книга 'test.xlsx' не найдена."
}

// 500 Internal Server Error
{
  "Code": 500,
  "Message": "На сервере произошла непредвиденная ошибка."
}

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

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

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

Копирование столбцов в рабочем листе Excel