Сравнение версий

Ключ

  • Эта строка добавлена.
  • Эта строка удалена.
  • Изменено форматирование.

Очистить область Версия 3 (Net)

Группа действий: Сервисы Google 

...

Описание

Данное действие предназначено для очистки данных указанного диапазона.

Иконка

...

Image Added

Параметры действия

Входные параметры  

Контекст                                       Идентификатор сеанса, к которому будет применено действие

ID документа                                Идентификатор документа, к которому необходимо применить действие

Лист                                              Наименование рабочего листа

Ячейка От                                     Адрес начальной ячейки, от которой будет браться область

Ячейка До                                    Адрес конечной ячейки, до которой будет браться область

Настройки 

Свойство

Англ. наименование

Описание

Тип

Пример заполненияОбязательность заполнения поля
Параметры

Контекст

Context

Идентификатор сеанса, к которому будет применено действие.

Идентификатор сеанса работы с Google таблицами

GoogleTablesInstanceДа

ID документа

Document ID

Идентификатор документа, к которому необходимо применить действие.Строка12Q3VXVkv-6Y2IMHДа

Лист

Sheet

Наименование рабочего листа.

По умолчанию первый лист документа.

СтрокаЛист1Нет

Ячейка От

From сell

Адрес начальной ячейки, от которой будет

произведена очистка

браться область.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

По умолчанию "А1"

СтрокаА1Нет

Ячейка До

To cell

Адрес конечной ячейки, до которой

будет произведена очистка

будет браться область.

Заполнять в формате "ХY", где "Х" - это имя столбца, а "Y" - номер строки.

По умолчанию до конца рабочей области.

СтрокаС9Нет

Особые условия использования

...

В Google Sheets API есть лимит до 60 read-запросов на пользователя в минуту. Для того, чтобы действие сразу не выдавало ошибку при достижении лимита количества запросов, в действие включена операция цикла, которая в течение минуты будет повторно отправлять запросы.

  • Если за это время запрос выполниться, то действие завершится успешно.
  • Если за это время запрос не удастся отправить, то робот завершится с ошибкой.

Пример использования 

Задача

Существует : существует Google таблица с значениями: 

Image Added

 Image RemovedНеобходимо очистить область значений с ячейки "B1" до "С4"

Решение

Воспользоваться : воспользоваться действиями "Настройки подключенияContext Google tables", "Очистить областьClear range".

Реализация

...

  1. Собрать следующую схему робота, состоящую из действий: "Настройки подключения", "Очистить область".
    Image Removed
    Image Added

  2. Настроить параметры для действия "Настройки подключения":
    Image RemovedImage Added
    Заполнить поля "Путь к файлу" и "Имя проекта" (подробнее о заполнении данных полей в ИНСТРУКЦИЯ ПО НАСТРОЙКЕ ПОДКЛЮЧЕНИЯ к Google Sheets/Docs/Drive)

  3. Настроить параметры для действия "Очистить область":
    Image RemovedImage Added
    В поле "Контекст " указать контект подключения к Google Sheets.
    В поле "ID документа" указать часть ссылки таблицы.
    Image Removed
    В поле "Лист" указать наименование листа на котором находятся данные. 
    В поле "Ячейка от" указать наименование ячейки от которой будет взята область данных.
    В поле "Ячейка до" указать наименование ячейки до которой будет взята область данных.
     

...

  1. Image Added

  2. Запустить робота, нажав на кнопку "Старт" в верхней панели. 

Результат

Программный робот отработал успешно.

Image Added

Требуемая область значений очищена из таблицы. 

Image Removed

Image RemovedImage Added