SQLでGoogleスプレッドシートを操作するためのSOAPサービスを実装する方法

ソリューションのデモの準備中に、クライアント情報をどこにでも保存できることを示す必要がありました-たとえば、Googleスプレッドシートなど、より複雑な（ 6か月の「実装」と数百万の予算の後 ）CRMクライアント。 私たちが使用しているWSO2 ESBにはGoogleテーブルへのコネクタがありますが、必要な機能を実装することはそれほど簡単な作業ではありませんでした。



しかし最近、WSO2 Data Services Serverは、新機能を整理しているときに、Googleスプレッドシート（​​後でどこでも入手できる）を操作するためのSOAPサービスを簡単に実装できることを発見しました。 さらに、テーブル内のデータの処理は、通常のSQLを介して実行されます。

これを行う方法については、カットの下でお伝えしたいと思います。



（突然、この投稿をどこかで見たことがあると思われる場合-驚かないでください-最後の投稿が禁止されました-リンクを持ち過ぎてしまいました-ここで修正しようとしました）。

WSO2 Data Servicesサーバーとは何ですか？

しかし、最初に、小さな教育プログラム。 WSO2とは何ですか？ 単純な場合、これは単一のCarbon OSGIプラットフォームにインストールされた一連のオープンソースプロジェクト（主にApacheスタックから）です。 その結果、プロジェクトから製品を取得します-単一の管理パネル、サポートなどを使用します。 WSO2は、幅広い統合の課題をカバーしています。



私たちの場合、データへのアクセスを整理するためにWSO2 Data Services Serverが使用され、データソースは非常に異なる場合があります-通常のデータベース（MySQLからDB2へ-大まかに言えば、JDBCドライバーがあります）とNoSQLデータベース、およびファイル（CSV、Excel）および外部サービス（この場合はGoogleスプレッドシート）。 これらはすべて、SOAPまたはRESTサービスでラップできます。

WSO2 Data Servicesサーバーをインストールする

WSO2製品を使用する際に便利なのは、インストール、構成、およびサポートの点で、すべて同じ原則に基づいていることです。 WSO2 DSSをインストールすることは、WSO2 ESBをインストールすることと違いはありません。その例は、たとえばここにあります 。 大まかに言えば-ダウンロード、アンパック、起動-そして出来上がり-数秒後にアドレス（デフォルト）https：// localhost：9443 / carbon（ログインのパスワードはadmin / admin）の管理パネルに移動できます

Googleテーブル

Googleスプレッドシートに伝えないこと-誰もが知っていると思います。 作業するテストテーブルを作成します-たとえば、3つの列-ID、FirstName、LastName







テーブルは、 docs.google.com / spreadsheets / d / 1k4jebSdGJ39nyDnIc505PI0H2XKk8Q8ewxSpe71 / edit ＃gid = 0のようなリンクで開きます。「/編集」へのリンクの一部は、アクセスのために後で使用する必要があるテーブルのURLです。



docs.google.com/spreadsheets/d/1k4jebSdGJ39nyDnIc505PI0H2XKk8Q8ewxSpe71

サービス作成

左側のメニューでサービスを作成するには、[サービス]-> [追加]-> [作成]を選択します。 最初の画面で、基本データを入力します-サービスの名前（私の場合はGoogleClients、ネームスペース（私の場合はws.wso2.org/dataservices/google_client ）。他のパラメーターを使用できます。残りのパラメーターはデフォルトのままにします。

データソースの作成

次のステップは、データソースを設定することです。 1つのサービスで複数のソースを一度に使用できます。Googleスプレッドシートをソースとして追加する必要があります。



次のステップでは、「データソースの追加」と言い、開いたフォームに名前（googleTableなど）を入力し、タイプ（Googleスプレッドシート）を選択して、「クエリモードを使用」ボックスをオンにします（これにより、SQLでテーブルと通信できるようになります）。

さらに興味深い-テーブルへの接続を設定する必要があります。 GoogleスプレッドシートのURLとして、上で示したようにテーブルのURLを使用します。



ただし、次のフィールドでは機能する必要があります。

Google Developers Consoleでアプリケーションを登録する

次のフィールドは、クライアントIDとクライアントシークレット-Googleスプレッドシートをノックするアプリケーション（この場合はサービス）のIDです。 このデータを取得するには、Google Developers Console： console.cloud.google.comにアクセスし、そこに新しいアプリケーションを登録し、OAuth2承認を追加します（API＆Auth-> Credentials-> Add Credentials-> OAuth 2.0 client ID）。 キーを作成するときは、データソースの登録時に使用したものと同じ「承認済みリダイレクトURI」を指定する必要があります（最も単純なケースでは、 localhost ：9443 / authCodeReceiverです。







作成後、データソース登録フォームで指定する必要があるクライアントIDとクライアントシークレットを受け取ります。 最後に取得する必要があるのは、「トークンの更新」です。これは、私たちのために働く特定のユーザーに関する情報が「保護」されるトークンです。このためには、「トークンの生成」ボタンをクリックします。Googleにログインするように求められます。ソーステーブルへのアクセス権がある）およびアクセス許可。 その結果、受信した更新トークンがフィールドに（自動的に）挿入されます。 次に、「接続のテスト」を押します-すべてがうまくいった場合-あなたは肯定的な結果を得るでしょう-あなたは先に進むことができます。

クエリを作成する

すべて、魔法のステップが通過しました-すべてが簡単です。 次のステップは、クエリを作成することです。 すべてのレコードを要求することから始めましょう。 次のステップ「クエリ」で「新しいクエリの追加」をクリックして、クエリの作成を開始します。

• リクエスト名 ：例：selectClients
• データソース ：最後の手順で作成されたgoogleTableを選択します
• クエリ ： Sheet1からID、FirstName、LastNameを選択します-ID、FirstName、LastNameはテーブルの列の名前、Sheet1はタブの名前です

はい、はい、はい！ これがポイントです。使い慣れたSQLを使用してGoogleスプレッドシートを操作します。



次に、「応答の生成」をクリックします。出力フィールドは列名によって生成されます。「要素ごとのグループ化」を変更することをお勧めします。たとえば、「クライアント」および「行名」を「クライアント」に変更します。これらの名前は応答タグで使用されます。 必要に応じて、生成された「出力マッピング」を編集できます。







同様に、 InsertQuery をSheet1（ID、FirstName、LastName）の値（？、？、？）への挿入として作成します（ 「入力マッピングの生成」をクリックするだけで、要求内の質問の数に従って）入力パラメーターを生成します。 これらは名前とタイプに合わせて編集するのが最適です。







同様に、他のクエリ（パラメーターを使用した選択と更新と削除の両方）を生成できます。Googleテーブルを通常のSQLテーブルとして使用できることが重要です。 複雑なクエリがどのようにサポートされているかは調査しませんでしたが、私の場合は、単純で基本的なクエリが十分にありました。

操作を作成する

次のステップは簡単です。リクエストごとにオペレーション（サービスメソッド）を生成します。 ここではすべてが簡単です-操作を作成し、それがどのリクエストであるかを示します。

サービステスト

「完了」をクリックします-それだけです-Googleスプレッドシートを操作するためのSOAPサービスの準備ができました！ あなたはそれをテストすることができます-サービスのリストで、「Try this service」をクリックしてください-そして、開いたウィンドウで、操作を選択し、必要に応じてパラメータを入力して-行ってください。







それだけです！ サービスの準備ができました-これで、バスまたは他のアプリケーションからテーブルを操作できます（WSDLを使用して、このサービスを呼び出すクライアントコードを簡単に生成できます）。 ClientID、Secret Key、Refresh Tokenを使用して「魔法」につまずかないと、すべてが手に入ります。



同時に、単純なSQLクエリを除いて、コードを1行も記述しませんでした。