Таблицы

В этом руководстве описано, как и зачем использовать API Google Sheets для создания таблиц в электронных таблицах.

Что такое стол?

Использование таблиц позволяет упростить создание данных и уменьшить необходимость многократного форматирования, ввода и обновления данных за счет автоматического применения форматирования и структуры к диапазонам данных.

Таблицы обладают множеством функций, таких как заголовки, нижние колонтитулы, типы столбцов, фильтры, представления, ссылки на таблицы и имена таблиц. Подробнее см. в анонсе новой функции и узнайте об использовании таблиц в Google Sheets .

Таблицы можно использовать для таких задач, как отслеживание проектов, планирование мероприятий и управление запасами.

Добавить таблицу

Для добавления таблицы используйте метод batchUpdate , отправив запрос addTable . Этот запрос используется для добавления таблицы в электронную таблицу.

В следующем примере создается таблица с именем "Project Tracker" в указанном range с двумя заданными столбцами. Первый столбец — столбец с процентами, а второй — столбец с выпадающим списком.

{
  "addTable": {
    "table": {
      "name": "Project Tracker",
      "tableId": "123",
      "range": {
        "sheetId": 0,
        "startColumnIndex": 0,
        "endColumnIndex": 5,
        "startRowIndex": 0,
        "endRowIndex": 5,
      },
      "columnProperties": [
        {
          "columnIndex": 0,
          "columnName": "Column 1",
          "columnType": "PERCENT"
        },
        {
          "columnIndex": 1,
          "columnName": "Column 2",
          "columnType": "DROPDOWN",
          "dataValidationRule": {
            "condition": {
              "type": "ONE_OF_LIST",
              "values": [
                {
                  "userEnteredValue": "Not Started"
                },
                {
                  "userEnteredValue": "In Progress"
                },
                {
                  "userEnteredValue": "Complete"
                }
              ]
            }
          }
        }
      ],
    }
  }
}

Типы столбцов

В таблицах есть столбцы следующих типов : числовой, дата, выпадающий список, смарт-чип, флажок. Столбцы «Рейтинг» и «Флажок» заполняются значениями по умолчанию: 0 и FALSE соответственно.

Тип столбца «Выпадающий список» создает выпадающий список в виде чипа. Если тип столбца задан как «Выпадающий список», то для этого столбца необходимо установить правило dataValidationRule с условием ONE_OF_LIST. Для других типов столбцов поле `dataValidationRule` устанавливать не следует.

Обновить таблицу

Используйте метод spreadsheets.batchUpdate и передайте ему объект UpdateTableRequest .

Измените размер таблицы

Используйте метод UpdateTableRequest для изменения range , в который таблица может быть добавлена, чтобы добавить новые строки/столбцы.

Если вам нужно добавить новую строку или столбец в таблицу, используйте InsertRangeRequest или InsertDimensionRequest.

Если вам нужно удалить строку таблицы, вы можете использовать DeleteRangeRequest, в противном случае вы можете использовать DeleteDimensionRequest для удаления всей строки из электронной таблицы.

Если вы обновляете существующую таблицу без нижнего колонтитула и добавляете его, range расширяется на 1 строку. Если вы обновляете существующую таблицу с нижним колонтитулом и удаляете его, range сужается на 1 строку.

Добавить значения в таблицу

Используйте метод AppendCellsRequest с tableId для добавления строк в конец таблицы. Это добавит значения в первую свободную строку и учтет наличие заполненных строк и нижних колонтитулов. Если пустых строк нет, это добавит строки в конец таблицы и перед любым нижним колонтитулом, если таковой имеется.

Удалить таблицу

Используйте метод spreadsheets.batchUpdate и укажите объект DeleteTableRequest . С помощью DeleteTableRequest можно удалить всю таблицу целиком, включая ее содержимое.

Используйте DeleteBandingRequest , чтобы удалить форматирование таблицы, но сохранить данные.

Используйте таблицы совместно с другими функциями Google Sheets.

К другим функциям API, позволяющим использовать таблицы в качестве базовых данных, относятся фильтры , представления фильтров и защищенные диапазоны .