Добавить новый лист Версия 4 (Net)
Группа действий: Сервисы Google
Описание
Действие добавляет новый лист.
Иконка
Параметры действия
Входные параметры
Контекст Идентификатор сеанса, к которому будет применено действие
ID документа Идентификатор документа, к которому необходимо применить действие
Лист Наименование рабочего листа
Имя нового листа Имя нового листа, который будет создан
Настройки
Свойство | Описание | Тип | Пример заполнения | Обязательность заполнения поля |
---|---|---|---|---|
Параметры | ||||
Контекст | Идентификатор сеанса, к которому будет применено действие. | GoogleTablesInstance | Да | |
ID документа | Идентификатор документа, к которому необходимо применить действие. | Строка | 12Q3VXVkv-6Y2IMH | Да |
Лист | Наименование рабочего листа. По умолчанию первый лист документа. | Строка | Лист1 | Нет |
Имя нового листа | Имя нового листа, который будет создан. Он будет добавлен после активного. Новый лист станет активным листом | Строка | Нет |
Особые условия использования
В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.
- Если за это время запрос выполниться, то действие завершится успешно.
- Если за это время запрос не удастся отправить, то робот завершится с ошибкой.
Пример использования
Задача
Необходимо подключиться к Google Sheets и добавить в таблицу новый лист.
Решение
Воспользоваться действиями "Настройки подключения", "Добавить новый лист".
Реализация
- Собрать схему робота состоящую из следующих действий:
- Настроить параметры для действия "Настройки подключения":
Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive) - Настроить параметры для действия "Добавить новый лист":
В поле "ID документа" указать часть ссылки таблицы. - Запустить робота по кнопке "Старт" в верхней панели.
Результат
Программный робот отработал успешно.
Новый лист добавлен в таблицу.