Коннектор Google Drive

Интеграция Tulip с API Google Drive v3

Введение

Google Drive API позволяет пользователям создавать, читать и редактировать файлы google drive с соответствующим доступом, установленным для их аккаунтов google. Цель этого коннектора - использовать аутентификацию Oauth2.0 и интегрировать Google Drive V3 API с Tulip с помощью HTTP-коннекторов и предоставить нашим клиентам готовый коннектор, который можно импортировать в их экземпляр.

Назначение

1. Мы собираемся осветить различные функции HTTP-коннектора, которые можно построить, выполняя HTTP-вызовы к конечным точкам Google Drive V3 API для взаимодействия с Google Drive, чтобы опробовать различные действия чтения и записи на диске, которые можно использовать для различных сценариев использования.

API Doc

Документ по API Google Drive

Настройка API Google

Как и во многих других коннекторах, настройка вне Tulip - самая сложная часть интеграции. Ознакомьтесь с этим видеоруководством, в котором рассказывается о процессе создания проекта Google API, учетных данных и их внесения в плагин библиотеки Google Drive.

Предварительные требования

1. Создайте аккаунт в облачной консоли Google и настройте учетные данные OAuth 2.0. Дополнительную информацию можно найти в документации Google по API.
2. Активируйте Google Drive API в Google API Console.

Детали подключения Tulip

Для коннекторов Tulip необходимо настроить следующую информацию.

1. Работает на: Хост облачного коннектора
2. Хост:www.googleapis.com
3. Порт:443
4. TLS: Да
5. Области, которые необходимо настроить в коннекторе:
6. https://www.googleapis.com/auth/drive
7. https://www.googleapis.com/auth/drive.file
8. https://www.googleapis.com/auth/drive.metadata
9. https://www.googleapis.com/auth/drive.appdata

Функции коннектора

Получить все файлы диска

Назначение

Этот коннектор получает все файлы, существующие в google drive пользователя.

Конечная точка

HTTP GET вызов конечной точки https://www.googleapis.com:443/drive/v3/files?fields=*.

Требуемый ввод

Входы не требуются

Требуемый выходной экстрактор

1. File Id: Уникальный идентификатор файла, который будет использоваться для выполнения других задач
2. Имя файла: Имя файла
3. Дополнительные параметры, возвращаемые вместе с ответом, могут быть включены в выходные параметры

Получить специфические метаданные файла

Назначение

Этот коннектор получает метаданные файла, существующего на диске.

Конечная точка

HTTP GET вызов конечной точки - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

Требуемый ввод

Ниже перечислены параметры URL, которые необходимо передать

1. Идентификатор файла

Требуемый выходной экстрактор

1. File Id: Уникальный идентификатор файла, который будет использоваться для выполнения других задач
2. Имя файла: Имя файла
3. Дополнительные параметры, возвращаемые вместе с ответом, могут быть включены в выходные параметры

Создать новый файл

Назначение

1. Пользователи могут передать имя файла с расширением и описанием в качестве входных данных, и Tulip создаст новый файл с указанным именем. Ответом API будут метаданные и различные свойства файла.
2. Информация, полученная из Google Drive V3 API, может быть использована в приложениях Tulip, таблицах Tulip или переменных Tulip, которые будут переданы в другие функции коннектора. Эта информация также может быть использована в других коннекторах Google.

Конечная точка

HTTP POST вызов конечной точки https://www.googleapis.com:443/drive/v3/files Требуемый ввод

Требуемый ввод

Ниже перечислены параметры, которые передаются в теле запроса

1. Имя файла - Название файла с расширением
2. Описание - Описание файла

Требуемый выходной экстрактор

1. File Id: Уникальный идентификатор файла, который будет использоваться для выполнения других задач
2. Имя файла: Имя файла
3. Дополнительные параметры, возвращаемые вместе с ответом, могут быть включены в выходные параметры

Удалить файл

Назначение

1. Пользователи могут передать ID файла в качестве входных данных, и Tulip удалит файл на диске.

Конечная точка

HTTP DELETE вызов конечной точки - https://www.googleapis.com:443/drive/v3/files.

Требуемый ввод

Ниже перечислены параметры, которые передаются в теле запроса

1. ID файла

Требуемый экстрактор вывода

Выходные данные не извлекаются, так как возвращается пустой ответ.