Таблицы

В этом руководстве описывается, как и зачем использовать 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, поддерживающие таблицы как резервные данные, включают фильтры , представления фильтров и защищенные диапазоны .