Изменение ширины столбцов внутри диапазона – Aspose.Cells Cloud API

Этот REST API устанавливает ширину столбцов для заданного диапазона.

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

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

REST API

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

Необходимые условия – Перед вызовом конечной точки необходимо:

Создать учётную запись Aspose Cloud и получить client ID и client secret.
Получить JWT-токен, вызвав конечную точку OAuth (/connect/token). Токен возвращается в поле access_token.
Загрузить целевую рабочую книгу в хранилище Aspose Cloud (или убедиться, что она уже существует в указанной папке).

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

Имя параметра	Тип	Расположение	Описание
name	string	path	Имя файла рабочей книги
sheetName	string	path	Имя рабочего листа
value	number	query	Желаемое значение ширины столбца
range	object	body	Объект диапазона, определяющий целевые ячейки
folder	string	query	Путь к папке, где хранится рабочая книга
storageName	string	query	Имя сервиса хранилища

OpenAPI Specification определяет общедоступное программное интерфейсное решение и позволяет выполнять REST-взаимодействия непосредственно из веб-браузера.

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

Запрос

# Вызов конечной точки column‑width для рабочей книги *test.xlsx*,
# рабочего листа *Sheet1*, установка ширины выбранных столбцов в 20 пунктов.
curl -v "https://api.aspose.cloud/v3.0/cells/test.xlsx/worksheets/Sheet1/ranges/columnWidth?value=20" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{
        "ColumnCount": 7,
        "ColumnWidth": 19,
        "FirstColumn": 0,
        "FirstRow": 9,
        "Name": "string",
        "RefersTo": "string",
        "RowCount": 1,
        "RowHeight": 15,
        "Worksheet": "Sheet1"
      }'

Ответ

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

Возможные сообщения об ошибках

Код HTTP	Описание
400	Bad Request – неверный JSON или параметры
401	Unauthorized – отсутствует или недействителен токен
404	Not Found – рабочая книга или рабочий лист отсутствуют

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

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

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

Часто задаваемые вопросы (FAQ)

В: Какую конечную точку следует вызвать, чтобы установить ширину столбцов в диапазоне в файле Excel?
О: POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/ranges/columnWidth, где {name} — имя файла рабочей книги, а {sheetName} — имя целевого рабочего листа.

В: Как выполнить аутентификацию запроса при использовании API установки ширины столбца?
О: Добавьте заголовок Authorization: Bearer <jwt token>. Получите JWT-токен через OAuth-процесс Aspose Cloud (/connect/token), используя ваш client ID и client secret.

В: Какой JSON-текст нужно отправить, чтобы изменить ширину столбцов A–C до 25 пунктов?
О:

{
  "FirstColumn": 0,
  "ColumnCount": 3,
  "FirstRow": 0,
  "RowCount": 1
}

Добавьте параметр запроса value=25 к URL запроса.

Установка значения диапазона в рабочем листе Excel Установка высоты строк для диапазона в Excel — Aspose.Cells Cloud API (v3.0)