Строка & операции со столбцами

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
      }
    },
  ],
}