Таблицы

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

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

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

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

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

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

Чтобы добавить таблицу, используйте метод 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 . Этот запрос используется для удаления всей таблицы и её содержимого.

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

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

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