В этом руководстве описывается, как и зачем использовать API Google Sheets для создания таблиц в электронных таблицах.
Что такое стол?
С помощью таблиц вы можете упростить создание данных и уменьшить необходимость многократного форматирования, ввода и обновления данных за счет автоматического применения формата и структуры к диапазонам данных.
Таблицы имеют множество функций, таких как верхние и нижние колонтитулы, типы столбцов, фильтры, представления, ссылки на таблицы и имена таблиц. Дополнительную информацию можно найти в объявлении о функции и узнать об использовании таблиц в Таблицах .
Таблицы можно использовать для таких задач, как отслеживание проектов, планирование мероприятий и управление запасами.
Добавить таблицу
Чтобы добавить таблицу, используйте метод patchUpdate , предоставив запрос addTable . Этот запрос используется для добавления таблицы в электронную таблицу.
В следующем примере создается таблица с именем «Отслеживание проекта» в указанном 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 , чтобы удалить форматирование таблицы, но сохранить данные.
Используйте таблицы с другими функциями Таблиц.
Другие функции API, которые поддерживают таблицы в качестве базовых данных, включают фильтры , представления фильтров и защищенные диапазоны .