Google Sheets
Чтение, запись и обновление данных с выбором листа
Google Sheets — это облачная платформа для работы с электронными таблицами, которая позволяет командам и отдельным пользователям создавать, редактировать и совместно работать над таблицами в реальном времени. Широко используется для отслеживания данных, создания отчетов и решения задач, связанных с легковесными базами данных. Google Sheets интегрируется со многими инструментами и сервисами.
С помощью интеграции Google Sheets в AACFlow вы можете:
- Читать данные: Получать значения ячеек из определенных диапазонов в таблице
- Записывать данные: Записывать значения в определенные диапазоны ячеек
- Обновлять данные: Изменять существующие значения ячеек в таблице
- Добавлять строки: Добавлять новые строки данных в конец листа
- Очищать диапазоны: Удалять данные из определенных диапазонов ячеек
- Управлять таблицами: Создавать новые таблицы или получать метаданные о существующих
- Пакетные операции: Выполнять пакетное чтение, обновление и очистку данных в нескольких диапазонах
- Копировать листы: Дублировать листы внутри таблицы или между таблицами
В AACFlow интеграция с Google Sheets позволяет вашим агентам читать, записывать и управлять электронными таблицами в рамках автоматизированных рабочих процессов. Это идеально подходит для автоматической отчетности, синхронизации данных, ведения записей и создания конвейеров данных, использующих таблицы в качестве совместного уровня данных.
Интегрируйте Google Sheets в рабочий процесс с явным выбором листа. Возможности: чтение, запись, добавление, обновление, очистка данных, создание таблиц, получение информации о таблице и копирование листов.
Чтение данных из определенного листа в таблице Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы (находится в URL: docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/edit). |
range | string | Нет | Диапазон в нотации A1 для чтения (например, "Sheet1!A1:D10", "A1:B5"). По умолчанию используется первый лист A1:Z1000, если не указано. |
| Параметр | Тип | Описание |
|---|
sheetName | string | Название листа, который был прочитан |
range | string | Диапазон ячеек, который был прочитан |
values | array | Значения ячеек в виде двумерного массива |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Запись данных в определенный лист в таблице Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы |
range | string | Нет | Диапазон в нотации A1 для записи (например, "Sheet1!A1:D10", "A1:B5") |
values | array | Да | Данные для записи в виде двумерного массива (например, [["Имя", "Возраст"], ["Алиса", 30], ["Боб", 25]]) или массива объектов. |
valueInputOption | string | Нет | Формат данных для записи |
includeValuesInResponse | boolean | Нет | Включать ли записанные значения в ответ |
| Параметр | Тип | Описание |
|---|
updatedRange | string | Диапазон ячеек, которые были обновлены |
updatedRows | number | Количество обновленных строк |
updatedColumns | number | Количество обновленных столбцов |
updatedCells | number | Количество обновленных ячеек |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Обновление данных в определенном листе в таблице Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы для обновления |
range | string | Нет | Диапазон в нотации A1 для обновления (например, "Sheet1!A1:D10", "A1:B5") |
values | array | Да | Данные для обновления в виде двумерного массива (например, [["Имя", "Возраст"], ["Алиса", 30]]) или массива объектов. |
valueInputOption | string | Нет | Формат данных для обновления |
includeValuesInResponse | boolean | Нет | Включать ли обновленные значения в ответ |
| Параметр | Тип | Описание |
|---|
updatedRange | string | Диапазон ячеек, которые были обновлены |
updatedRows | number | Количество обновленных строк |
updatedColumns | number | Количество обновленных столбцов |
updatedCells | number | Количество обновленных ячеек |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Добавление данных в конец определенного листа в таблице Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы для добавления данных |
range | string | Нет | Диапазон в нотации A1 для добавления после (например, "Sheet1", "Sheet1!A:D") |
values | array | Да | Данные для добавления в виде двумерного массива (например, [["Алиса", 30], ["Боб", 25]]) или массива объектов. |
valueInputOption | string | Нет | Формат данных для добавления |
insertDataOption | string | Нет | Способ вставки данных (OVERWRITE или INSERT_ROWS) |
includeValuesInResponse | boolean | Нет | Включать ли добавленные значения в ответ |
| Параметр | Тип | Описание |
|---|
tableRange | string | Диапазон таблицы, куда были добавлены данные |
updatedRange | string | Диапазон ячеек, которые были обновлены |
updatedRows | number | Количество обновленных строк |
updatedColumns | number | Количество обновленных столбцов |
updatedCells | number | Количество обновленных ячеек |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Очистка значений из определенного диапазона в таблице Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы Google Sheets |
sheetName | string | Да | Название листа/вкладки для очистки |
cellRange | string | Нет | Диапазон ячеек для очистки (например, "A1:D10"). Очищает весь лист, если не указано. |
| Параметр | Тип | Описание |
|---|
clearedRange | string | Диапазон, который был очищен |
sheetName | string | Название листа, который был очищен |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Получение метаданных о таблице Google Sheets, включая заголовок и список листов
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы Google Sheets |
includeGridData | boolean | Нет | Включать ли данные сетки (значения ячеек). По умолчанию false. |
| Параметр | Тип | Описание |
|---|
spreadsheetId | string | ID таблицы |
title | string | Заголовок таблицы |
locale | string | Локаль таблицы |
timeZone | string | Часовой пояс таблицы |
spreadsheetUrl | string | URL таблицы |
sheets | array | Список листов в таблице |
↳ sheetId | number | ID листа |
↳ title | string | Заголовок/название листа |
↳ index | number | Индекс листа (позиция) |
↳ rowCount | number | Количество строк в листе |
↳ columnCount | number | Количество столбцов в листе |
↳ hidden | boolean | Скрыт ли лист |
Создание новой таблицы Google Sheets
| Параметр | Тип | Обязательный | Описание |
|---|
title | string | Да | Заголовок новой таблицы |
sheetTitles | json | Нет | Массив названий листов для создания (например, ["Sheet1", "Data", "Summary"]). По умолчанию создается один лист "Sheet1". |
locale | string | Нет | Локаль таблицы (например, "en_US") |
timeZone | string | Нет | Часовой пояс таблицы (например, "America/New_York") |
| Параметр | Тип | Описание |
|---|
spreadsheetId | string | ID созданной таблицы |
title | string | Заголовок созданной таблицы |
spreadsheetUrl | string | URL созданной таблицы |
sheets | array | Список созданных листов в таблице |
↳ sheetId | number | ID листа |
↳ title | string | Заголовок/название листа |
↳ index | number | Индекс листа (позиция) |
Чтение нескольких диапазонов из таблицы Google Sheets в одном запросе
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы Google Sheets |
ranges | json | Да | Массив диапазонов для чтения (например, ["Sheet1!A1:D10", "Sheet2!A1:B5"]). Каждый диапазон должен включать название листа. |
majorDimension | string | Нет | Основное измерение значений: "ROWS" (по умолчанию) или "COLUMNS" |
valueRenderOption | string | Нет | Способ отображения значений: "FORMATTED_VALUE" (по умолчанию), "UNFORMATTED_VALUE" или "FORMULA" |
| Параметр | Тип | Описание |
|---|
spreadsheetId | string | ID таблицы |
valueRanges | array | Массив диапазонов значений, прочитанных из таблицы |
↳ range | string | Диапазон, который был прочитан |
↳ majorDimension | string | Основное измерение (ROWS или COLUMNS) |
↳ values | array | Значения ячеек в виде двумерного массива |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Обновление нескольких диапазонов в таблице Google Sheets в одном запросе
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы Google Sheets |
data | json | Да | Массив диапазонов значений для обновления. Каждый элемент должен иметь "range" (например, "Sheet1!A1:D10") и "values" (двумерный массив). |
valueInputOption | string | Нет | Способ интерпретации входных данных: "RAW" или "USER_ENTERED" (по умолчанию). USER_ENTERED анализирует формулы. |
| Параметр | Тип | Описание |
|---|
spreadsheetId | string | ID таблицы |
totalUpdatedRows | number | Общее количество обновленных строк |
totalUpdatedColumns | number | Общее количество обновленных столбцов |
totalUpdatedCells | number | Общее количество обновленных ячеек |
totalUpdatedSheets | number | Общее количество обновленных листов |
responses | array | Массив ответов об обновлении для каждого диапазона |
↳ spreadsheetId | string | ID таблицы |
↳ updatedRange | string | Диапазон, который был обновлен |
↳ updatedRows | number | Количество обновленных строк в этом диапазоне |
↳ updatedColumns | number | Количество обновленных столбцов в этом диапазоне |
↳ updatedCells | number | Количество обновленных ячеек в этом диапазоне |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Очистка нескольких диапазонов в таблице Google Sheets в одном запросе
| Параметр | Тип | Обязательный | Описание |
|---|
spreadsheetId | string | Да | ID таблицы Google Sheets |
ranges | json | Да | Массив диапазонов для очистки (например, ["Sheet1!A1:D10", "Sheet2!A1:B5"]). Каждый диапазон должен включать название листа. |
| Параметр | Тип | Описание |
|---|
spreadsheetId | string | ID таблицы |
clearedRanges | array | Массив диапазонов, которые были очищены |
metadata | json | Метаданные таблицы, включая ID и URL |
↳ spreadsheetId | string | ID таблицы Google Sheets |
↳ spreadsheetUrl | string | URL таблицы |
Копирование листа из одной таблицы в другую
| Параметр | Тип | Обязательный | Описание |
|---|
sourceSpreadsheetId | string | Да | ID исходной таблицы Google Sheets |
sheetId | number | Да | ID листа для копирования (числовой ID, не название листа). Используйте Get Spreadsheet, чтобы найти ID листов. |
destinationSpreadsheetId | string | Да | ID таблицы назначения, куда будет скопирован лист |
| Параметр | Тип | Описание |
|---|
sheetId | number | ID вновь созданного листа в таблице назначения |
title | string | Заголовок скопированного листа |
index | number | Индекс (позиция) скопированного листа |
sheetType | string | Тип листа (GRID, CHART и т.д.) |
destinationSpreadsheetId | string | ID таблицы назначения |
destinationSpreadsheetUrl | string | URL таблицы назначения |
