Найти строку

Ищет в вашей Google Таблице первую строку, где в нужном столбце стоит заданное значение, и возвращает её содержимое. Пригодится, чтобы проверить, есть ли запись, и достать связанные с ней данные. Например, по введённому промокоду бот находит строку и узнаёт размер скидки и срок действия. Для работы нужно один раз подключить Google Таблицы к боту в настройках.

Настройки блока

• spreadsheetId (обязательно) — В какой таблице искать строку. Идентификатор таблицы — это часть её адреса в браузере между /d/ и /edit.
• range (обязательно) — В каком участке таблицы искать, например «Промо!A2:D500» (без строки заголовка). Чем уже участок, тем быстрее найдётся результат.
• matchColumnIndex — В каком столбце выбранного участка искать совпадение. Счёт идёт с нуля от начала участка: 0 — первый столбец, 1 — второй и так далее. Например, для участка, начинающегося со столбца A, 0 означает столбец A.
• matchValue (обязательно) — Что искать в выбранном столбце — например введённый пользователем промокод. Обычно подставляется через переменную. Бот вернёт первую строку, где значение совпадёт по выбранному правилу.
• matchMode — Как сравнивать искомое значение с содержимым ячейки: точное совпадение (без учёта регистра), содержит (ячейка включает искомый текст как часть) или по шаблону (для более гибкого поиска). Для большинства задач подходит точное совпадение.
• outputFoundVariable (обязательно) — Название переменной, в которую запишется, нашлась строка или нет. По этому результату удобно разветвить сценарий: например, при совпадении показать скидку, иначе — сообщить, что промокод не найден.
• outputRowJsonVariable — Название переменной, в которую сложится содержимое найденной строки — все её ячейки по порядку. К отдельной ячейке потом можно обратиться по её номеру, например {{var.0}} — первая ячейка. Если строка не найдена, переменная останется пустой.
• outputRowIndexVariable — Название переменной, в которую запишется порядковый номер найденной строки внутри выбранного участка (счёт с единицы от начала участка, а не от начала листа). Если строка не найдена — там будет 0.
• timeoutMs — Сколько ждать ответа от Google Таблиц, прежде чем считать запрос неудачным (в миллисекундах: 10000 — это 10 секунд).
• errorNodeId — Куда направить сценарий, если обращение к таблице не удалось. Укажите блок, который обработает такой случай. Если оставить пустым, сценарий прервётся.
• errorVariableName — Название переменной, в которую попадёт текст ошибки, если обращение к таблице не удалось.

---

_{Тип узла в схеме: integration.google_sheets.find_row}