Google Sheetsのアドオンをインストールして設定

機械翻訳について

Google Sheetsのアドオンをインストールして設定

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

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

「図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用のアドオンの設定を完了します:

Claspを使用したGoogle AppsスクリプトへのoracleGoogleAddinファイルのアップロード
oracleGoogleAddinフォルダに存在するすべてのファイルをアップロードするには、コマンドライン・アプリケーション・スクリプト・プロジェクト(clasp)を使用する必要があります。
Googleスクリプトをwebアプリケーションとしてデプロイ
oracleGoogleAddinフォルダのすべてのファイルがGoogle Apps Scriptファイルにインポートまたはアップロードされた後、Googleスクリプトをwebアプリケーションとしてデプロイする必要があります。

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

Claspを使用したGoogle AppsスクリプトへのoracleGoogleAddinファイルのアップロード

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

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

ノート:

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

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

図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アカウントにアクセスします。

ノート:
Google AppsスクリプトでAppsスクリプトAPIを有効にしていない場合、前述のコマンドは成功しません。 https://script.google.com/home/usersettingsサイトにアクセスしてAPIを有効にし、「On」ボタンを選択してサイトを許可し、Google Apps Script APIを有効にします。
既存のGoogle Apps Scriptプロジェクトで、左側のペインのプロジェクト設定をクリックします。 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 Sheetsのアドオンをインストールして設定

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

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

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

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

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

「図ask-oracle-menu.pngの説明」

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

親トピック: Google Sheetsのアドオンをインストールして設定