Python SDK: SheetCoordinates: адреса ячеек
ctx.documents().coordinates() преобразует буквенные адреса ячеек и числовые индексы. Методы работают локально.
Примеры являются фрагментами тела def run(ctx):. Все методы SDK синхронны, await не нужен.
Методы
column_name
ctx.documents().coordinates().column_name(number) -> str
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
number |
int |
Да | Номер строки/страницы с единицы. |
Результат: str.
Преобразует положительный номер столбца в буквы: 1 → A, 27 → AA.
result = ctx.documents().coordinates().column_name(27)
column_number
ctx.documents().coordinates().column_number(name) -> int
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
name |
str |
Да | Имя поля, заголовка, файла, секрета или метрики по назначению метода. |
Результат: int.
Преобразует буквы столбца в номер с единицы. Передавайте только латинские буквы столбца, например B или AA.
result = ctx.documents().coordinates().column_number('AA')
position
ctx.documents().coordinates().position(address) -> tuple[int, int]
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
address |
str |
Да | Адрес ячейки, например B2. |
Результат: tuple[int, int].
Преобразует адрес вроде B2 в [2, 2]. Абсолютные знаки $ принимаются и не меняют координаты: $B$2 даёт ту же позицию.
result = ctx.documents().coordinates().position('B2')
bounds
ctx.documents().coordinates().bounds(value) -> list[int]
| Аргумент | Тип | Обязателен | Назначение |
|---|---|---|---|
value |
Any |
Да | Значение по назначению метода; см. описание результата. |
Результат: list[int].
Возвращает плоский список [start_row, start_column, end_row, end_column]. Для A1:B3 результат [1, 1, 3, 2]. Одиночная ячейка допустима как диапазон; обратные границы дают ValueError.
result = ctx.documents().coordinates().bounds('A1:B3')
Ошибки и контекст выполнения
Все вызовы синхронны. Неверный аргумент или формат данных может вызвать ValueError/TypeError; отказ платформы или недоступность сервиса вызывает RuntimeError. Отсутствие элемента/значения даёт None либо пустой список только там, где это явно описано. Не превращайте любое исключение в пустой успешный результат. Методы внешних сервисов недоступны в преобразовании выгрузки; см. ограничения преобразований и среду.