API Google Sheets позволяет добавлять, удалять и манипулировать строками и столбцами в таблицах. Примеры на этой странице иллюстрируют, как с помощью Sheets API можно выполнять некоторые распространенные операции со строками и столбцами.
Эти примеры представлены в виде HTTP-запросов, которые не зависят от языка. Чтобы узнать, как реализовать пакетное обновление на разных языках с помощью клиентских библиотек Google API, см. раздел Обновление электронных таблиц .
В этих примерах заполнители 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 } }, ], }