Запросы Google Sheets
Данный раздел предназначен для настройки взаимодействия с Google Таблицами. С помощью этих настроек вы можете получать, записывать и обновлять данные в таблицах, используя параметры подключения.
Подключение и использование Google Sheets API
1. Назначение
Интеграция с Google Sheets API позволяет приложению взаимодействовать с таблицами Google напрямую — получать, искать, добавлять и обновлять данные без необходимости ручного доступа. Благодаря этому данные из таблицы могут использоваться в автоматических сценариях: чат-ботах, CRM-системах, отчётности и других процессах.
2. Общие сведения о работе с API
Google Sheets API предоставляет программный интерфейс (endpoint), через который можно выполнять операции чтения и записи данных в таблицы Google. Каждая таблица идентифицируется уникальным ID, а каждая вкладка (лист) внутри таблицы — индексом.
Работа с API осуществляется через передачу параметров, которые определяют:
что нужно сделать (метод),
где (ID таблицы и индекс вкладки),
над какими данными (номер столбца, значение, новая информация и т.д.).
3. Настройка подключения
3.1. Название настройки
Поле: Название
Укажите произвольное имя, которое поможет вам различать настройки в списке интеграций.
Примеры:
Получение заказов из Google SheetsОбновление статуса заявокДобавление новых пользователей
Рекомендуется использовать осмысленные имена, отражающие назначение действия. Это упрощает навигацию при большом количестве подключений.
3.2. Метод взаимодействия
Поле: Метод
Определяет тип операции, которую будет выполнять API. Возможные значения (в зависимости от реализации):
Выборка
Получить все данные из таблицы
Найти
Найти строку по значению в указанном столбце
Создать запись
Добавить новую строку
Обновить запись
Изменить данные в существующей строке
Достать запись по номеру строки
Получить строку по её индексу
⚙️ В разных версиях API список методов может отличаться. Перед использованием уточните, какие методы поддерживаются в вашей среде.
3.3. ID таблицы
Поле: ID таблицы
Уникальный идентификатор Google Таблицы. Необходим для того, чтобы API знал, с какой таблицей работать.
Как найти ID:
Откройте нужную таблицу в браузере.
Скопируйте часть ссылки между
/d/и/edit:https://docs.google.com/spreadsheets/d/1A2B3C4D5E6F7G8H9I0J/editВ этом примере ID таблицы —
1A2B3C4D5E6F7G8H9I0J
💡 Важно: не путайте ID таблицы с её названием или ссылкой для общего доступа.
3.4. Индекс вкладки
Поле: Индекс вкладки
Google Таблица может содержать несколько листов (вкладок). Каждая вкладка имеет свой индекс, начиная с нуля:
Первая
0
Вторая
1
Третья
2
Если ваша таблица содержит вкладку с именем «Данные», но она расположена третьей по счёту, её индекс будет 2.
🧭 Рекомендация: чтобы избежать путаницы, откройте таблицу и посмотрите порядок вкладок внизу страницы — нумерация соответствует их позиции слева направо.
3.5. Номер столбца
Поле: Номер столбца
Укажите, с каким столбцом будет работать API при поиске или обновлении данных.
Нумерация ведётся с 1, где A = 1, B = 2, C = 3 и т.д.
A
1
B
2
C
3
D
4
...
...
Пример:
Если значение, по которому выполняется поиск, находится в столбце E, введите 5.
3.6. Значение
Поле: Значение
Используется при методах, предполагающих фильтрацию или поиск строк. Введите значение, по которому API будет искать совпадение в выбранном столбце.
Пример: Если таблица содержит заказы:
1001
Иван
5000 ₽
1002
Ольга
3200 ₽
и вы укажете значение Иван, то запрос вернёт всю строку, где имя клиента — Иван.
3.7. Опция «Создать список»
Если включена, данные, возвращаемые API, формируются в виде массива JSON, что позволяет обрабатывать несколько строк одновременно (например, при множественных совпадениях или массовых выгрузках).
4. Проверка корректности подключения
После заполнения всех полей настройка готова к использованию. Если при выполнении запросов возвращаются ошибки, проверьте следующее:
ID таблицы указан без лишних символов и соответствует активной таблице.
Индекс вкладки совпадает с нужным листом (0 — первая вкладка).
Номера столбцов указаны корректно.
При использовании методов записи или обновления таблица не защищена от редактирования.
🔍 Для диагностики можно использовать тестовые запросы, возвращающие первые 5 строк таблицы — это позволит убедиться, что соединение установлено корректно.
Методы работы с Google Sheets API
Ниже приведено детальное описание поддерживаемых методов и принципов их работы.
1. Метод Выборка (Get Data)
Назначение: получение всех данных с указанной вкладки таблицы.
Параметры:
ID таблицы
Индекс вкладки
(необязательно) флаг Создать список
Как работает:
API считывает все строки с выбранного листа.
Данные возвращаются в виде массива массивов (или JSON-списка).
Пример использования: Получить весь список заказов и отобразить его в боте или приложении.
💡 Этот метод полезен для генерации отчётов, таблиц и обзоров без фильтрации.
2. Метод Найти (Find Row)
Назначение: поиск строки по заданному значению в указанном столбце.
Параметры:
ID таблицы
Индекс вкладки
Номер столбца
Значение
Как работает:
API построчно сканирует указанный столбец.
При нахождении совпадения возвращает всю строку.
Пример: Найти заказ клиента по имени:
Столбец
B→ номер 2Значение →
Иван
Результат — строка, содержащая данные заказа Ивана.
🔎 Если значение встречается несколько раз, возвращается первая найденная строка. Для множественного поиска используйте опцию Создать список.
3. Метод Создать запись (Append Row)
Назначение: добавление новой строки в конец таблицы.
Параметры:
ID таблицы
Индекс вкладки
Список значений новой строки
Пример: Таблица пользователей:
При передаче данных
["3", "Сергей", "sergey@mail.com"]
API добавит новую строку в конец таблицы.
🧩 Метод полезен для ведения журналов, списков регистраций, заявок и других динамических наборов данных.
4. Метод Обновить запись (Update Row)
Назначение: обновление существующих данных в строке, найденной по заданному условию.
Параметры:
ID таблицы
Индекс вкладки
Номер столбца (по которому искать)
Значение (по которому искать)
Новые данные для обновления
Пример: Нужно изменить email пользователя Анна:
Столбец поиска —
B (2)Значение —
АннаНовое значение —
anna.new@mail.com
API находит строку и заменяет старые данные на новые.
⚠️ При совпадении нескольких строк обновляется первая найденная. Для массового обновления используйте циклический вызов API.
5. Метод Достать запись по номеру строки (Get by Row Number)
Назначение: получить все данные из строки по её порядковому номеру.
Параметры:
ID таблицы
Индекс вкладки
Номер строки
Пример:
Передайте значение 3, чтобы получить данные из третьей строки таблицы заказов.
📘 Полезно при работе с таблицами, где структура строго упорядочена — например, для получения фиксированных записей (шапка, параметры, шаблоны).
6. Рекомендации по работе с API
Минимизируйте количество запросов. При массовом обмене данными объединяйте несколько операций в один вызов, если API поддерживает batch-запросы.
Следите за квотой Google API. Бесплатный лимит запросов ограничен. При превышении возможно временное блокирование.
Используйте кэширование. Для часто запрашиваемых данных (например, справочников) рекомендуется хранить копию локально.
Проверяйте права доступа. Если таблица защищена или доступ ограничен, API не сможет записать данные.
Используйте тестовую таблицу. Перед внедрением в продакшен рекомендуется протестировать настройки на отдельном документе.
Итог
Интеграция с Google Sheets API позволяет автоматизировать обмен данными между приложением и таблицами Google.
Выборка
Получить все строки
Основная выгрузка данных
Найти
Поиск по значению
Получение конкретной записи
Создать запись
Добавить строку
Добавление новых данных
Обновить запись
Изменить строку
Корректировка существующих данных
Достать запись по номеру строки
Получить строку по индексу
Точный доступ по порядковому номеру
Last updated