グーグル・ドライブ・コネクター

チューリップとGoogle Drive v3 APIとの連携

はじめに

GoogleドライブAPIは、ユーザーが自分のGoogleアカウントに設定された適切なアクセス権でGoogleドライブファイルを作成、読み取り、編集できるようにします。このコネクタの目的は、Oauth2.0認証を使用し、HTTPコネクタを使用してTulipでGoogle Drive V3 APIと統合し、インスタンスにインポートできるアウトオブボックスのコネクタをお客様に提供することです。

目的

1. Google Drive V3 APIエンドポイントへのHTTPコールを行うことで構築できるさまざまなHTTPコネクタ機能を紹介し、Google Driveと対話することで、さまざまなユースケースで活用できるドライブ上のさまざまな読み取り/書き込みアクションを試します。

APIドキュメント

GoogleドライブAPIドキュメント

Google APIのセットアップ

多くのコネクタがそうであるように、Tulip以外でのセットアップは統合の最も難しい部分です。Google APIプロジェクト、認証情報を作成し、それらをGoogle Drive Library Pluginに取り込むプロセスを説明したビデオガイドをご覧ください。

前提条件

1. Google のクラウドコンソールでアカウントを作成し、OAuth 2.0 認証情報を設定します。詳細はGoogleのAPIドキュメントを参照。
2. Google API ConsoleでGoogle Drive APIを有効化します。

チューリップ接続の詳細

以下の情報を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 ドライブに存在するすべてのファイルを取得します。

エンドポイント

エンドポイント https://www.googleapis.com:443/drive/v3/files?fields=* への HTTP GET コール。

必要な入力

入力不要

必要な出力 エクストラクター

1. ファイルID：他のタスクを実行するために使用されるファイルの一意の識別子。
2. File Name（ファイル名）：ファイルのファイル名
3. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

特定のファイルのメタデータを取得する

目的

このコネクタは、ドライブに存在するファイルのメタデータをフェッチします。

エンドポイント

エンドポイントへの HTTP GET コール - https://www.googleapis.com:443/drive/v3/files/{FileID}?fields=*

必須入力

渡されるURLパラメータは以下のとおりです。

1. ファイルID

必須出力 Extractor

1. ファイル ID：他のタスクを実行するために使用されるファイルの一意の識別子。
2. ファイル名：ファイルのファイル名
3. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

新規ファイルの作成

目的

1. ユーザーは、拡張子と説明を含むファイル名を入力として渡すことができます。APIのレスポンスは、ファイルのメタデータとさまざまなプロパティになります。
2. Google Drive V3 APIから取得した情報は、Tulipアプリ、Tulipテーブル、Tulip変数で利用することができます。この情報は、他のGoogleコネクタでも使用できます。

エンドポイント

エンドポイントへの HTTP POST コール https://www.googleapis.com:443/drive/v3/files 必須入力

必須入力

リクエスト ボディとして送信されるパラメータは次のとおりです。

1. File Name - 拡張子付きのファイルタイトル
2. Description - ファイルの説明

必須出力 Extractor

1. ファイル ID：他のタスクを実行するために使用されるファイルの一意の識別子
2. ファイル名：ファイルのファイル名
3. レスポンスとともに返される追加パラメータは、出力パラメータの一部として含めることができます。

ファイルの削除

目的

1. ユーザーは入力としてファイルIDを渡すことができ、Tulipはドライブ内のファイルを削除します。

エンドポイント

エンドポイントへのHTTP DELETEコール - https://www.googleapis.com:443/drive/v3/files

必要な入力

リクエストボディとして送信されるパラメータは以下のとおりです。

1. ファイルID

必要な出力 Extractor

空の応答を返すため、出力は抽出されません。