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