Google Sheets

Google Sheets — это веб-приложение для работы с таблицами. Этот модуль обеспечивает возможность загрузки и обработки данных из документов Google Sheets, поддерживая различные варианты форматирования данных и выбор листов.

Этот модуль предлагает расширенный загрузчик документов Google Sheets, который может:

• Загружать данные из нескольких таблиц
• Выбирать конкретные листы и диапазоны
• Обрабатывать отформатированные и необработанные значения
• Работать с формулами и вычислениями
• Настраивать обработку заголовков
• Обрабатывать содержимое с помощью разделителей текста
• Обеспечивать аутентификацию через OAuth2

Входные данные

Обязательные параметры

• Учётные данные для подключения: OAuth2-данные Google Sheets. См. раздел #Google Sheets
• Выбор таблицы: Выберите таблицы из вашего Google Drive

Дополнительные параметры

• Имена листов: Список имён листов для загрузки, разделённых запятыми
• Диапазон: Конкретный диапазон для загрузки (например, A1:E10)
• Включать заголовки: Указывает, включать ли первую строку как заголовки (по умолчанию: да)
• Параметр отображения значений: Как должны быть представлены значения:
  • Отформатированные значения — как отображается в интерфейсе
  • Неотформатированные значения — сырие значения
  • Формулы — исходные формулы
• Разделитель текста: Средство для обработки извлечённого содержимого
• Дополнительные метаданные: JSON-объект с дополнительной информацией
• Исключить ключи метаданных: Список через запятую ключей метаданных, которые нужно исключить

Выходные данные

• Документ: Массив объектов документов, содержащих метаданные и содержимое страницы (pageContent)
• Текст: Конкатенированная строка, объединяющая pageContent всех документов

Основные особенности

• Аутентификация через OAuth2
• Поддержка нескольких таблиц и листов
• Выбор конкретных листов и диапазонов
• Работа с заголовками
• Настройка отображения значений (включая форматирование)
• Поддержка разделения текста
• Кастомизация метаданных

Параметры отображения значений

Отформатированные значения

• Значения, отображаемые в интерфейсе
• Включает форматирование
• Числа с десятичными/валютой
• Даты в указанном формате

Неотформатированные значения

• Исходные значения ячеек
• Числа без форматирования
• Даты как сериальные числа
• Логические значения как true/false

Формулы

• Исходные формулы
• Ссылки на ячейки
• Функции
• Вычисления

Структура документа

Каждый документ содержит:

• pageContent: Отформатированный контент листа
• metadata:
  • spreadsheetId: ID таблицы в Google Sheets
  • spreadsheetName: название документа
  • sheetName: название листа
  • range: выбранный диапазон
  • headers: заголовки столбцов (при включении)
  • lastModified: дата последнего изменения
  • url: ссылка для просмотра в браузере
  • Дополнительные пользовательские метаданные

Примечания

• Требует аутентификации через OAuth2
• Обрабатывает ограничения по скорости запросов
• Поддержка больших таблиц
• Эффективная обработка с точки зрения памяти
• Обработка ошибок при недопустимых диапазонах
• Автоматическое обновление токенов доступа
• Доступ к данным в реальном времени