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