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

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

Database Actionsの起動パッドを開きます。
「ダウンロード」タブで、DOWNLOAD MICROSOFT EXCEL/GOOGLE SHEETS ADD-INペインを選択します。

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

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

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

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

ノート

ファイルのインポートはワンタイム・アクティビティであり、通常は管理者が行います。

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

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

親トピック: Oracle Autonomous Database for Google Sheets

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

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

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

ノート

クラスプは、Node.jsで記述され、ノード・パッケージ・マネージャ(NPM)ツールを介して配布されます。claspを使用するには、Node.jsバージョン4.7.4以降をインストールする必要があります。

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

図apps-script-window.pngの説明
Apps Scriptエディタ・ウィンドウで、デフォルトですでに存在するCode.gsファイルを選択します。Code.gsファイルの横にある縦に並んだドットをクリックします。「削除」を選択して、既存の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」で、「クリップボードにコピー」をクリックしてスクリプト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およびクライアント・シークレット・キーの生成

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

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

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

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

作業中のGoogle Sheetで「Extensions」メニューをクリックし、「Apps Script」を選択します。ウィンドウを開きます。
右上の「デプロイ」ボタンをクリックして、「新規デプロイメント」を選択します。「New deployment」ウィンドウが開きます。
「選択タイプ」の横にある「設定」アイコンをクリックし、「Webアプリケーション」を選択します。
「構成」で、「説明」フィールドにデプロイメントの説明を指定します。たとえば、Web app deploymentとします。
「Web app」で、ログインに使用したGoogleアカウントを「Execute as」ドロップダウンから選択します。オプションで、このデプロイメントにアクセスできるユーザーを選択できます。
「デプロイ」を選択します。
ノート
- アクセスの認可を求めるウィンドウが表示された場合は、それを選択します。Gmailアカウントを選択する必要があるGoogleアカウント・ページにリダイレクトされます。
- 「詳細」をクリックし、「無題のプロジェクトに移動(安全でない)」リンクを選択します。
- リンクを選択すると、アプリケーションを信頼することを確認する新しいウィンドウが開きます。「Allow」をクリックして続行します。
この段階でアクセスを認可する場合、「Autonomous Databaseを使用するためのGoogle Sheetsの認可」のステップ2から4を実行する必要はありません。
「完了」をクリックして、「新規デプロイメント」ウィンドウを閉じます。
右上の「デプロイメント」ボタンをクリックして、「デプロイメントの管理」を選択します。
「Manage Deployments」ページでは、WebアプリURLを表示できます。WebアプリのURLをコピーするには、クリップボードにコピーを使用します。たとえば、WebアプリURL https://script.google.com/macros/s/abcdefghijk/execのサンプルを次に示します。これがWebアプリケーション・デプロイメントURLです。
このURLを保存します。このURLは、後でデータベース・アクションから接続ファイルをダウンロードするとき、またはGoogle Sheetから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クライアント・シークレット」フィールドを生成します。

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

Oracle Cloud Infrastructureドキュメント