API Google Sheets позволяет добавлять, удалять и манипулировать строками и столбцами в таблицах. Примеры на этой странице иллюстрируют, как с помощью Sheets API можно выполнять некоторые распространенные операции со строками и столбцами.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек API Google, см. раздел Обновление электронных таблиц .
В этих примерах заполнители SPREADSHEET_ID и SHEET_ID указывают, где вы будете предоставлять эти идентификаторы. Идентификатор таблицы можно найти в URL-адресе таблицы. Вы можете получить идентификатор листа , используя метод spreadsheets.get . Диапазоны указаны с использованием обозначения A1 . Пример диапазона: Лист1!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 Sheets предоставить новым столбцам или строкам те же свойства, что и предыдущая строка или столбец, а если значение 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
}
},
],
}