Googleスプレッドシート用のアドオンのインストールと設定

16.14.1 Googleスプレッドシート用のアドオンのインストールと設定

Oracle Autonomous DatabaseのGoogle Sheets用のアドオンをインストールするには、Database ActionsインスタンスからoracleGoogleAddin zipファイルをダウンロードします。

Database Actionsの起動パッドを開きます。
「ダウンロード」タブで、「Microsoft Excel/Google Sheetsアドインのダウンロード」ペインを選択します。

図download-add.pngの説明
「ダウンロード」画面が開き、「Microsoft Excel」タブと「Googleスプレッドシート」タブが表示されます。「Googleスプレッドシート」タブをクリックし、「アドインのダウンロード」を選択します。

図download-add-google-sheet.pngの説明

これで、システムの「ダウンロード」フォルダにzipファイルを表示できます。.zipファイルの内容をシステムに抽出します。

Oracle Autonomous DatabaseのGoogle Sheets用のアドオンを設定するには、oracleGoogleAddinフォルダ内のファイルをGoogle Apps Scriptにインポートします。

ノート:

ファイルのインポートは1回かぎりのアクティビティであり、通常は管理者が行います。

ファイルをGoogle Apps Scriptにインポートまたはアップロードした後、次のステップに従ってOracle Autonomous DatabaseのGoogle Sheets用のアドオンの設定を完了します:

16.14.1.1 claspを使用したGoogle Apps ScriptへのoracleGoogleAddinのファイルのアップロード

oracleGoogleAddinフォルダにあるすべてのファイルをアップロードするには、Command Line Apps Script Project (clasp)を使用する必要があります。

Claspは、端末からGoogle Apps Scriptプロジェクトを開発および管理するためのオープンソース・ツールです。

ノート:

claspは、Node.jsで記述され、Node Package Manager (NPM)ツールを介して配布されます。claspを使用するには、Node.jsバージョン4.7.4以降をインストールする必要があります。

Webブラウザのアドレス・バーに「sheet.new」と入力して、Google Sheetsを開きます。必ずGoogleアカウントでログインしてください。
「拡張機能」メニューから「アプリケーション・スクリプト」を選択します。「アプリケーション・スクリプト」エディタ・ウィンドウを表示できます。

図apps-script-window.pngの説明
Apps Scriptエディタ・ウィンドウで、デフォルトですでに存在するCode.gsファイルを選択します。Code.gsファイルの横にある縦に並んだドットをクリックします。「Delete」を選択して、既存のCode.gsファイルを削除します。
Node.jsをインストールした後、コマンド・プロンプトに次のnpmコマンドを入力してclaspをインストールします。このコマンドは、oracleGoogleAddinフォルダをダウンロードして抽出した場所で入力する必要があります。
```
C:\Users\username\Desktop\oracleGoogleAddin>npm install @google/clasp -g
```
UNIXおよびLinuxベースのシステムの管理者としてコマンドを実行するには、次のコマンドを入力します:
```
sudo npm install @google/clasp -g
```
claspをインストールすると、このコマンドはコンピュータ上の任意のディレクトリから使用できます。
次のコマンドを入力してログインし、GoogleアカウントのApps Scriptプロジェクトの管理を認可します。
```
clasp login
```
このコマンドを実行すると、デフォルトのブラウザが起動し、Google Apps Scriptプロジェクトが格納されるGoogleアカウントにサインインするよう求められます。claspでGoogleアカウントにアクセスするには、「Allow」を選択します。

ノート:
Google Apps ScriptでApps Script APIを有効にしていない場合、前述のコマンドは成功しません。https://script.google.com/home/usersettingsサイトにアクセスしてAPIを有効にし、「On」ボタンを選択してサイトを許可し、Google Apps Script APIを有効にします。
既存のGoogle Apps Scriptプロジェクトで、左側のペインの「Project Settings」をクリックします。「ID」で、「Copy to Clipboard」をクリックしてスクリプトIDをコピーします。
コマンド・プロンプトに戻り、次の図に表示されているように、前のステップでコピーしたスクリプトIDを指定して次のコマンドを入力します:
```
clasp clone <Script ID>
```
次のコマンドを指定して、すべてのファイルをフォルダからGoogle Apps Scriptファイルにプッシュします。
```
clasp push
```
このコマンドは、スクリプト・プロジェクトのすべてのファイルをコンピュータからGoogle Apps Scriptファイルにアップロードします。
新しく作成したGoogle Sheetに移動し、「Extensions」メニューをクリックして「Apps Script」を選択します。「Files」で、oracleGoogleAddinフォルダに存在するすべてのファイルを表示できます。
ファイルをGoogle Apps Scriptにインポートまたはアップロードした後、次のステップに従ってOracle Autonomous DatabaseのGoogle Sheets用のアドオンの設定を完了します:
- WebアプリケーションとしてのGoogleスクリプトのデプロイ
- UIを使用してクライアントIDおよびクライアント・シークレット・キーを生成します

16.14.1.2 WebアプリケーションとしてのGoogleスクリプトのデプロイ

oracleGoogleAddinフォルダのすべてのファイルがGoogle Apps Scriptのファイルにインポートまたはアップロードされたら、GoogleスクリプトをWebアプリケーションとしてデプロイする必要があります。

GoogleスクリプトをWebアプリケーションとしてデプロイするには:

作業中のGoogle Sheetで「Extensions」メニューをクリックし、「Apps Script」を選択します。ウィンドウを開きます。
右上の「Deploy」ボタンをクリックして、「New deployment」を選択します。「New deployment」ウィンドウが開きます。
「Select type」の横にある「settings」アイコンをクリックし、「Web app」を選択します。
「Configuration」で、「Description」フィールドにデプロイメントの説明を指定します。たとえば、Web app deploymentとします。
「Web app」で、ログインに使用したGoogleアカウントを「Execute as」ドロップダウンから選択します。オプションで、このデプロイメントにアクセスできるユーザーを選択できます。
「デプロイ」を選択します。
ノート:
- アクセスの認可を求めるウィンドウが表示された場合は、それを選択します。Gmailアカウントを選択する必要があるGoogleアカウント・ページにリダイレクトされます。
- 「Advanced」をクリックし、「Go to Untitled project (unsafe)」リンクを選択します。
- リンクを選択すると、アプリケーションを信頼することを確認する新しいウィンドウが開きます。「Allow」をクリックして続行します。
この段階でアクセスを認可する場合、「Autonomous Databaseを使用するためのGoogle Sheetsの認可」のステップ2から4を実行する必要はありません。
「Done」をクリックして、「New Deployment」ウィンドウを閉じます。
右上の「Deploy」ボタンをクリックして、「Manage Deployments」を選択します。
「Manage Deployments」ページでは、WebアプリURLを表示できます。WebアプリのURLをコピーするには、「Copy to Clipboard」を使用します。たとえば、WebアプリURL https://script.google.com/macros/s/AKfycbwFITvtYvGDSsrun22g7TrbrfV-bUVoWKs7OrA_3rtRAlmcGFe8bejNprZML7gFPzQ/execのサンプルを次に示します。これがWebアプリのデプロイURLです。
このURLを保存します。これは、後でデータベース・アクションから接続ファイルをダウンロードするとき、またはGoogleスプレッドシートからAutonomous Databaseへの接続を手動で作成するときに、「Googleスプレッドシート・リダイレクトURL」フィールドで使用します。

「レスポンス・タイプ」の選択の詳細は、「接続ファイルのダウンロード」を参照してください。
「Apps Script」ブラウザ・タブを閉じ、「Google Sheets」ブラウザ・タブに移動できます。これで、Autonomous Databaseへの接続を作成する準備ができました。
すべてのファイルをApps Scriptにアップロードした後に、必ずワークシートを保存してください。すべてのファイルをアップロードしたら、「Refresh」ボタンをクリックします。Googleスプレッドシートで新しいOracle Autonomous Databaseメニューを表示できるようになりました。

図ask-oracle-menu.pngの説明

ノート:
UIを使用して、「OAuthクライアントID」および「OAuthクライアント・シークレット」フィールドを生成します。