Коннектор Google Drive

Коннектор 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. Running On: Cloud Connector Host
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-диске пользователя.

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

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

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

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

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

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

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

Назначение

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

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

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

Необходимые параметры

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

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

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

1. File Id: Уникальный идентификатор файла, который будет использоваться для выполнения других задач
2. File Name (Имя файла): Имя файла
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. File Name (Имя файла): Имя файла
3. Дополнительные параметры, возвращаемые вместе с ответом, могут быть включены в состав выходных параметров

Удалить файл

Назначение

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

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

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

Требуемые входные данные

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

1. ID файла

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

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