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

Ключ

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

Взять значение ячейки

...

Версия 5 (Net)

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

Взять значение ячейки.

Image Removed

Настройки 

 Сервисы Google 

...

Описание

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

Иконка действия

Image Added

Параметры и их настройки

Свойство

Свойство

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

Описание

Тип

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

Контекст

Context

Уникальный идентификатор сеанса (экземпляр документа)
Идентификатор сеанса, к которому будет применено действие
.

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

GoogleTablesInstance
*, где *- порядковый номер контекста, запущенного в данном алгоритме
Да
ID документаИдентификатор документа, к которому необходимо применить действиеСтрока12Q3VXVkv-6Y2IMHДа

Лист

Sheet

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

СтрокаСписок делНет

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

Spread sheet Id

Идентификатор таблицы, значение которого получено
Строка12Q3VXVkv-6Y2IMHДа

Ячейка

Cell

Наименование ячейки,

значение из которой будет взято.

к которой необходимо применить действие

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

СтрокаF3Да
Результаты

Результат

Result

Переменная с типом "Строка", в которую будет записано значение указанной ячейки

Строка
ЗначениеЯчейки
Значение Ячейки
Да
Нет

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

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

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

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

Задача

Существует Google таблица с значениями.
Image Added
Необходимо взять данные из ячейки "А3". Результат вывести в диалоговое окно. 

Решение

Воспользоваться действиями "Настройки подключения", "Взять значение ячейки", "Сообщение". 

Реализация

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

Результат

Программный робот отработал успешно. Данные из ячейки получены.
Image Added
В диалоговое окно выведено значение из ячейки "А3".
Image Added
Отсутствуют