API Google Таблиц позволяет добавлять, удалять и изменять строки и столбцы в таблицах. Примеры на этой странице иллюстрируют, как с помощью API Таблиц можно выполнять некоторые распространённые операции со строками и столбцами.
Эти примеры представлены в виде HTTP-запросов, чтобы не зависеть от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек API Google, см. раздел Обновление электронных таблиц .
В этих примерах плейсхолдеры SPREADSHEET_ID и SHEET_ID указывают, где следует указать эти идентификаторы. Идентификатор таблицы можно найти в URL-адресе таблицы. Получить идентификатор листа можно с помощью метода spreadsheets.get . Диапазоны указываются в формате A1 . Пример диапазона: Sheet1!A1:D5.
Отрегулируйте ширину столбца или высоту строки
В следующем примере кода spreadsheets.batchUpdate показано, как использовать UpdateDimensionPropertiesRequest для обновления свойства ширины столбца A до 160 пикселей. Второй запрос обновляет свойство высоты первых трёх строк до 40 пикселей. Поле dimension определяет, применяется ли операция к столбцам или строкам листа.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}Добавить пустые строки или столбцы
В следующем примере кода spreadsheets.batchUpdate показано, как использовать запрос AppendDimensionRequest для добавления строк и столбцов. Первый запрос добавляет три пустые строки в конец листа, а второй — один пустой столбец. Поле dimension определяет, применяется ли операция к столбцам или строкам листа.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}Автоматически изменять размер столбца
В следующем примере кода spreadsheets.batchUpdate показано, как использовать AutoResizeDimensionsRequest для изменения размера столбцов A:C в зависимости от размера их содержимого. Поле dimension указывает, что операция применяется к столбцам листа.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}Автоматически изменять размер строки
В следующем примере кода spreadsheets.batchUpdate показано, как использовать запрос AutoResizeDimensionsRequest для очистки высоты первых трёх строк. Высота строк затем динамически увеличивается в зависимости от содержимого ячеек в каждой строке. Поле dimension указывает, что операция применяется к строкам листа.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}Удалить строки или столбцы
В следующем примере кода spreadsheets.batchUpdate показано, как использовать DeleteDimensionRequest для удаления первых трёх строк листа. Второй запрос удаляет столбцы B:D. Поле dimension определяет, применяется ли операция к столбцам или строкам листа.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}Вставьте пустую строку или столбец
В следующем примере кода spreadsheets.batchUpdate показано, как использовать InsertDimensionRequest для вставки столбцов или строк с определённым индексом (например, добавления пустых строк в начало листа). Первый запрос вставляет два пустых столбца в столбец C. Второй запрос вставляет три пустые строки, начиная со строки 1.
Поле dimension определяет, применяется ли операция к столбцам или строкам листа.
Если значение равно true, поле inheritFromBefore сообщает API Таблиц о необходимости присвоить новым столбцам или строкам те же свойства, что и у предыдущей строки или столбца, а если значение равно false, то следует наследовать измерения после новых столбцов или строк. inheritFromBefore не может быть true, если вставляется строка в строку 1 или столбец в столбец A.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}Переместить строку или столбец
В следующем примере кода spreadsheets.batchUpdate показано, как использовать MoveDimensionRequest для перемещения столбца A в позицию столбца D. Второй запрос перемещает строки 5–10 в позицию строки 20.
Поле dimension определяет, применяется ли операция к столбцам или строкам листа. Поле destinationIndex определяет, куда переместить исходные данные, используя начальный индекс, отсчитываемый от нуля.
Протокол запроса показан ниже.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}