Googleシートコネクター

Google Sheetsコネクタ

はじめに

Google Sheets APIを使用すると、ユーザーはGoogleアカウントに設定された適切なアクセス権でGoogleシートを作成、読み取り、編集することができます。このコネクタの目的は、TulipのOauth 2.0を活用して、HTTPコネクタを使用してGoogle Sheetsと統合し、インスタンスにインポートできるアウトオブボックスのコネクタをお客様に提供することです。

目的

1. Google Sheets API(v4)のエンドポイントにHTTPコールを行い、Googleスプレッドシートと対話することで、さまざまなユースケースに活用できるスプレッドシート上のさまざまな読み取り/書き込みアクションを試すことができます。

API ドキュメント

1. Google Sheets API リファレンスドキュメント

前提条件

1. Google のクラウドコンソールでアカウントを作成し、 OAuth 2.0 認証情報を設定します。詳細はGoogleのAPIドキュメントを参照。
2. GoogleクラウドコンソールでインスタンスのリダイレクトURLを追加する。

チューリップ接続の詳細

以下の情報をTulipのコネクタに設定する必要があります。

1. 実行中: クラウドコネクタホスト
2. ホスト：sheets.googleapis.com
3. ポート:443
4. TLS: はい
5. OAuth 2(Admin)：認証はすべての Connector ファンクションに引き継がれます。

コネクタ機能

Googleの新しいスプレッドシート

目的

1. ユーザーは入力としてスプレッドシート名とSheetNameを渡すことができ、Tulipは提供されたシート名で新しいスプレッドシートを作成します。APIのレスポンスは、スプレッドシートのメタデータとさまざまなプロパティとなり、これをさらにフィルタとして使用して、スプレッドシートからデータを取得および更新できます。
2. Google sheets V4 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、Tulip変数で利用することができます。

エンドポイント

エンドポイント**https://sheets.googleapis.com/v4/spreadsheets**への HTTP POST コール

必要な入力

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

1. SpreadSheet Name - スプレッドシートのタイトル
2. Sheet Name - 初期シートタイトル

出力エクストラクタ

1. スプレッドシート：他のタスクを実行するために使用される SpreadSheet の一意な識別子。
2. スプレッドシートのURL：新しく作成されたスプレッドシートのURL

Googleスプレッドシートデータ取得

目的

このコネクタは、指定された範囲内で指定された spreadsheetId からデータを取得します。データは、コネクタ関数に提供されたクエリパラメータに基づいて、行または列の配列として提供されます。

エンドポイント

エンドポイントへの HTTP GET コール-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}

必須入力

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

1. SpreadSheet Id
2. Range - [A1 Format]の文字列(https://developers.google.com/sheets/api/guides/concepts

a1_notation)

コネクタ関数から供給される追加のクエリパラメータは以下のとおりです。

1. majorDimension ：ROWS または COLUMNS は、内部データ配列を決定します。
2. dateTimeRenderOption は、DateTime フィールドのフォーマットを指定します。 デフォルト値：FORMATTED_STRING
3. valueRenderOptionは、レスポンスにおいてデータがフォーマットされなければならないか、フォーマットされないかを指定します：formatted_value

出力抽出

1. 値：これは配列の配列で、データの各行は配列となります。

Google SpreadSheet InsertRow

目的

スプレッドシートに値を追加します。入力範囲は、既存のデータを検索してその範囲内の "表" を見つけるために使用します。値は、テーブルの最初の列から始まり、テーブルの次の行に追加されます。Connector は spreadsheetId、Range、およびセルに挿入される値のリストを受け取ります。

エンドポイント

エンドポイントへの HTTP POST コール -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:append

必須入力

渡されるクエリ・パラメータは以下の通り。

1. スプレッドシートID
2. 範囲
3. 値：このコネクタでは、挿入される列に対して各パラメータ名が付けられた8つの列の値を考慮しました。これは値の配列として API に渡されます。

コネクタ関数から供給される追加のクエリパラメータは以下のとおり：

1. valueInputOption：これは必須フィールドで、コネクタから送信される：USER_ENTERED

出力エクストラクタ

1. spreadsheetId
2. UpdatedRows：挿入された行数を指定する

Googleスプレッドシートクリア

目的

スプレッドシートから値を消去します。コール側はスプレッドシートの ID と範囲を指定しなければなりません。セルの他のすべてのプロパティ（書式設定、データ検証など）は保持されます。Connector は spreadsheetId、Range、およびセルに挿入される値のリストを受け取ります。

エンドポイント

エンドポイントへの HTTP POST コール -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values/{range}:clear

必須入力

渡されるクエリ・パラメータを以下に示す。

1. スプレッドシートID
2. 範囲

Google SpreadSheet 詳細取得 byFilter

目的

このコネクタは、指定された spreadsheetId と、データ フィルタ内で指定された特定の条件を持つスプレッドシートの詳細を取得します。

エンドポイント

エンドポイントへの HTTP POST コール -https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}:getbyDataFilter

必須入力

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

1. spreadSheetId
2. includeGridData：デフォルト値は False

以下のパラメータは、JSON 形式のリクエストボディの一部として送信されます。

1. gridRange

出力エクストラクタ

1. spreadSheetId
2. タイトル
3. ロケール
4. 自動再計算
5. タイムゾーン
6. シートID
7. シートタイトル
8. シートタイプ
9. シート行数
10. 列数
11. スプレッドシートURL

ユーザーのユースケースに応じて、出力の一部として含めることができる他のパラメータがあります。

Google バッチデータ取得

目的

このコネクターは、指定されたspreadsheetIdからデータを取得します。 データは、コネクターに指定されたクエリーパラメーターに基づいて、行または列の配列として提供されます。

エンドポイント

エンドポイントへの HTTP GET コール-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGet

必須入力

渡されるクエリパラメータは以下のとおり。

1. スプレッドシート ID
2. 範囲 - [A1Format] の文字列(https://developers.google.com/sheets/api/guides/concepts

a1_notation)

コネクタ関数から供給される追加のクエリパラメータは以下のとおりです。

1. majorDimension ：ROWS または COLUMNS は、内部データ配列を決定します。
2. dateTimeRenderOption は、DateTime フィールドのフォーマットを指定します。 デフォルト値：FORMATTED_STRING
3. valueRenderOptionは、レスポンスにおいてデータがフォーマットされなければならないか、フォーマットされないかを指定する デフォルト値:FORMATTED_VALUE

出力抽出

1. 値の範囲：これはオブジェクトの配列です。各オブジェクトは1つの範囲を詳述する

Googleバッチデータ取得フィルター

目的

このコネクタは、指定されたフィルタ条件内で指定されたspreadsheetIdからデータのバッチとしてデータを取得します。データは、コネクタに提供されたクエリパラメータに基づいて、行または列の配列として提供されます。

エンドポイント

エンドポイントへの HTTP POST コール-https://sheets.googleapis.com/v4/spreadsheets/{spreadsheetId}/values:batchGetByDataFilter

必須入力

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

1. スプレッドシート ID

コネクタ関数から提供される追加のリクエストボディパラメータは以下のとおりです。

1. データフィルタ
2. majorDimension ：ROWS または COLUMNS は、内部データ配列を決定します。
3. dateTimeRenderOptionは、DateTimeフィールドのフォーマットを指定する デフォルト値：FORMATTED_STRING
4. valueRenderOptionは、レスポンスにおいてデータがフォーマットされなければならないか、フォーマットされないかを指定します：formatted_value

出力抽出

1. 値の範囲：これはオブジェクトの配列です。各オブジェクトは、1 つの範囲の詳細を示します。

ビデオ