Подключите Google Sheets к ИИ-агенту

Способы аутентификации

• OAuth 2.0

Откройте локальную консоль, выберите провайдера и настройте учётные данные. Для OAuth-провайдеров нужно зарегистрировать собственное OAuth-приложение в соответствующем сервисе.

Что проверить у этого коннектора

Пример ищет таблицы, доступные подключению Google. Проверьте заявленные scopes чтения и права выбранного аккаунта на файлы. Пустой список не обязательно означает сбой runtime.

Проверьте Action перед вызовом

Назначение примера

Поиск таблиц, доступных подключённому аккаунту Google.

Необходимые разрешения Action

• https://www.googleapis.com/auth/spreadsheets.readonly
• https://www.googleapis.com/auth/drive.readonly

Получите схему из работающего экземпляра. Перед выполнением проверьте обязательные параметры, права и подключённый аккаунт.

curl -s http://localhost:3000/v1/actions/googlesheets.search_spreadsheets

После подключения аккаунта адаптируйте параметры к своим ресурсам. Если включена аутентификация runtime, добавьте его Bearer Token.

curl -s -X POST \
  http://localhost:3000/v1/actions/googlesheets.search_spreadsheets \
  -H 'content-type: application/json' \
  -d '{"input":{"maxResults":5}}'

Как читать результат

Ответы HTTP runtime содержат success, message, data и meta. Проверяйте success и выходную схему Action, а не только HTTP-статус. Если метаданные содержат executionId, по нему можно найти журнал с замаскированными секретами. Ниже показан формат ответа, а не результат реального вызова API.

{
  "success": true,
  "message": "OK",
  "data": {},
  "meta": {}
}

Если вызов не удался

• При ошибке аутентификации проверьте адрес и тип учётных данных: административный доступ защищает /api, Bearer-токен runtime используется для /v1 и /mcp. API-ключ провайдера не заменяет токен runtime.
• При отказе в доступе проверьте scopes Action, правила Actions и разрешения на подключения. Даже действительный токен может не иметь доступа к выбранному аккаунту.
• Если результат пуст или ресурс отсутствует, проверьте аккаунт и его права на этот ресурс. Успешная авторизация не открывает все рабочие пространства, каналы и документы.
• Изучите ошибку и журнал до повтора. Если Action изменяет данные провайдера, сначала проверьте, не завершилась ли операция; не повторяйте запрос вслепую.

Дальнейшие шаги

Для поддерживаемых провайдеров OOMOL настраивает OAuth-приложения и управляет облачной средой. Вы по-прежнему выбираете аккаунт и подтверждаете его разрешения.