Google Drive в Amazon Quick Suite: Создаём кастомный коннектор через OpenAPI за 30 минут

Почему кастомные коннекторы в Quick Suite — это не просто "ещё одна интеграция"

Представьте: ваша команда использует Amazon Quick Suite для автоматизации бизнес-процессов. Встроенные коннекторы покрывают 80% потребностей. Но остаются те самые 20%, которые убивают всю эффективность. Например — автоматическая загрузка отчётов из внутренней системы в Google Drive с последующей обработкой.

Google Drive API существует. Документация есть. Но Quick Suite его "из коробки" не поддерживает. Вариантов два: либо писать кастомный код на Lambda (и поддерживать его вечно), либо использовать кастомные коннекторы через OpenAPI.

Что на самом деле происходит под капотом

Когда вы создаёте кастомный коннектор через OpenAPI, Quick Suite делает следующее:

• Парсит вашу OpenAPI спецификацию (3.0 или 3.1)
• Автоматически генерирует формы для ввода параметров в конструкторе
• Создаёт обработчик запросов с поддержкой аутентификации
• Добавляет коннектор в список доступных actions
• Обеспечивает мониторинг и логирование вызовов

Самое важное: вся эта магия работает без единой строчки кода (если не считать спецификацию OpenAPI). Но именно в этой простоте и кроются подводные камни.

Подготовка: что нужно иметь перед началом

Не начинайте без этого. Серьёзно.

1. Аккаунт Amazon Quick Suite с правами на создание кастомных коннекторов
2. Проект в Google Cloud Console (да, даже для простой интеграции)
3. OAuth 2.0 credentials для Google Drive API (client ID и secret)
4. Базовое понимание OpenAPI 3.0 (хватит знания структуры)
5. Чёткое понимание, какие именно операции Google Drive вам нужны

Шаг 1: Создаём OpenAPI спецификацию для Google Drive

Вот где большинство спотыкается. Не пытайтесь описать весь Google Drive API — это сотни endpoints. Выберите 2-3 операции, которые реально нужны.

Пример: нам нужно загружать текстовые файлы и получать список файлов в папке.

1Базовый скелет спецификации

openapi: 3.0.3
info:
  title: Google Drive Connector for Quick Suite
  version: 1.0.0
  description: Custom connector for Google Drive file operations
servers:
  - url: https://www.googleapis.com/drive/v3
    description: Google Drive API v3
components:
  securitySchemes:
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/drive.file: "Manage your Google Drive files"
paths:
  # Здесь будут наши endpoints

2Добавляем endpoint для загрузки файлов

Google Drive API для загрузки использует multipart/form-data. Quick Suite должен это понимать.

/files:
  post:
    summary: Upload a file to Google Drive
    operationId: uploadFile
    requestBody:
      required: true
      content:
        multipart/form-data:
          schema:
            type: object
            properties:
              name:
                type: string
                description: Name of the file
              parents:
                type: array
                items:
                  type: string
                description: Folder IDs where to upload
              file:
                type: string
                format: binary
                description: File content
    responses:
      '200':
        description: File uploaded successfully
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/File'
    security:
      - oauth2: [https://www.googleapis.com/auth/drive.file]

3Добавляем schema для response

components:
  schemas:
    File:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        mimeType:
          type: string
        webViewLink:
          type: string
        createdTime:
          type: string
          format: date-time

Шаг 2: Настройка OAuth 2.0 в Google Cloud Console

Это самая болезненная часть. Google постоянно меняет интерфейс, но принцип остаётся.

1. Создайте новый проект или выберите существующий в Google Cloud Console
2. Включите Google Drive API в разделе "APIs & Services"
3. Создайте OAuth 2.0 Client ID (тип "Web application")
4. ВАЖНО: добавьте authorized redirect URI от Quick Suite. Он будет выглядеть примерно так: https://quick-suite.auth.us-east-1.amazoncognito.com/oauth2/idpresponse
5. Сохраните Client ID и Client Secret — они понадобятся в Quick Suite

Шаг 3: Создание коннектора в Amazon Quick Suite

Теперь самое интересное — превращаем нашу спецификацию в работающий коннектор.

1Загрузка OpenAPI спецификации

В Quick Suite Designer:

1. Перейдите в раздел "Connectors" → "Custom connectors"
2. Нажмите "Create connector" → "From OpenAPI specification"
3. Загрузите ваш YAML файл или вставьте содержимое
4. Quick Suite автоматически распарсит endpoints и параметры

2Настройка аутентификации

Здесь нужно ввести OAuth credentials:

Шаг 4: Тестирование и отладка

Quick Suite предоставляет встроенный тестер для коннекторов. Не пропускайте этот этап.

Что проверять:

• OAuth flow работает (пользователь может авторизоваться)
• Endpoints возвращают ожидаемые данные
• Параметры правильно мапятся в запросы
• Ошибки API обрабатываются корректно

Шаг 5: Использование в бизнес-процессах

После успешного тестирования коннектор появляется в палитре действий. Пример использования:

Автоматизация загрузки отчётов:

1. Trigger: Ежедневно в 18:00
2. Action: Генерация отчёта (ваш существующий процесс)
3. Action: Google Drive → uploadFile
4. Параметры: name = "Отчёт {{date}}.txt", parents = ["ID_папки"], file = содержимое отчёта
5. Действие при ошибке: Отправка уведомления в Slack

Типичные ошибки и как их избежать

Зачем всё это, если есть готовые решения?

Справедливый вопрос. Есть Zapier, есть Workato, есть десяток других интеграционных платформ. Но:

• Контроль: ваш коннектор — ваши правила обработки ошибок, ваши логи, ваша скорость
• Стоимость: кастомный коннектор в Quick Suite не имеет дополнительной платы за вызовы (после февраля 2025 Amazon изменил pricing model)
• Интеграция: коннектор становится родным для Quick Suite, работает в одном контексте безопасности
• Расширяемость: добавили новый endpoint в OpenAPI — он сразу доступен во всех процессах

Кстати, этот подход очень похож на то, что мы делали в статье про OpenAPI-to-Skills, только там мы превращали документацию в навыки AI-агента, а здесь — в коннекторы для автоматизации.

Что будет дальше с кастомными коннекторами?

На февраль 2026 года Amazon активно развивает Quick Suite как enterprise-платформу. Мои предсказания:

• Появится marketplace для кастомных коннекторов (уже в бета-тесте)
• Добавят поддержку gRPC и GraphQL через OpenAPI-like спецификации
• Внедрят AI-ассистента для генерации спецификаций по описанию ("создай коннектор для загрузки файлов в Drive")
• Интегрируют с PDIQ для создания умных workflow

И последний совет: не создавайте монструозные коннекторы на 50 endpoints. Сделайте несколько специализированных: один для файловых операций, другой для управления разрешениями, третий для поиска. Так проще поддерживать, тестировать и обновлять.

Когда в следующий раз бизнес попросит "интегрировать вот эту странную систему", вы уже будете знать рецепт: OpenAPI + OAuth + Quick Suite = работающий коннектор за день, а не за неделю разработки.