onOpen 関数は Get Stockの項目を持つ Finance というメニューをスプレッドシートに追加します。スプレッドシートを開くと onOpen 関数はいつも自動的にこのプログラムを実行します。

getStock 関数はカラムヘッダーを提供し、A2セル以下のA列に入力された銘柄記号を得て、その銘柄情報の検索結果をシートに表示します。

参考：finance_services

function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [ {name: "Get Stock", functionName: "getStock"}];
  ss.addMenu("Finance", menuEntries);
}

このコードはスクリプトをインストールしたシートが開かれると直ぐに実行されるコードです。シートを一度閉じてからまた開くと Finance のメニューが数秒後には表れます。少し時間がかかってもこれは正常な動作です。

onOpen() の部分は関数とその名前の宣言です。（これは言語要素のさまざまな側面を指定する宣言と言えます。） 中括弧に挟まれたコンピューターコードは onOpen() 関数を実行したときの実際の挙動を指定しています。 onOpen() 関数はスクリプトのあるシートを開くと直ぐに自動的に実行されます。中括弧で括られた{ }の部分は関数の働き方のより詳しい情報が書かれています。 Running Scripts in Response to an Event(イベントへの応答スクリプト)が参考になるでしょう。

関数の最初の var ss = SpreadsheetApp.getActiveSpreadsheet(); の部分は ss をJavaScriptオブジェクトとして宣言し、 現在開かれているシートの SpreadsheetAppクラス のメソッド getActiveSpreadsheet() を呼び出しているものです。 メソッドとはクラスに関連付けられた専用のコードで、そのクラスのオブジェクトに対して特別なタスクを実行するものです。

２行目の Get Stock でスクリプトの２つ目の関数である getStock() と関連付けてメニューにエントリーさせるよう定義します。 スプレッドシートに Finance というメニューを追加しているのは、３行目の addMenu() という関数です。

スプレッドシートにカラムヘッダーを挿入する２つ目の getStock() 関数を下に示します。その働きは A列 に入力した株式銘柄それぞれの 情報を取得してスプレッドシートに読み込ませることです。この関数は、メニューからFinance > Get Stock を選択したときに実行されるコードを含みます。

function getStock() {
  var sheet = SpreadsheetApp.getActiveSheet();

  sheet.getRange(1, 1).setValue("Symbol");
  sheet.getRange(1, 2).setValue("Name");
  sheet.getRange(1, 3).setValue("Exchange");
  sheet.getRange(1, 4).setValue("TradeTime");
  sheet.getRange(1, 5).setValue("Price");

  var row = 2;
  while (true) {
    if (!sheet.getRange(row, 2).getValue()) {
      var symbol = sheet.getRange(row, 1).getValue();
      if (!symbol) break;
      Logger.log("Updating symbol: " + symbol);
      var stockInfo = FinanceApp.getStockInfo(symbol);
      sheet.getRange(row, 2).setValue(stockInfo.name);
      sheet.getRange(row, 3).setValue(stockInfo.exchange);
      sheet.getRange(row, 4).setValue(stockInfo.tradetime);
      sheet.getRange(row, 5).setValue(stockInfo.price);
    } else {
      Logger.log("Already updated: " + symbol);
    }
    row++;    
  }
}

次の５行で getRange() メソッドを使いながら A1 から A5 の５つのセルを識別します。そして setValue() メソッドを使って 対応する列のセルにカラムラベルを挿入していきます。setValue() においては Symbol, Name,・・ 等のラベルが引数になります。 メソッドにデータを受け渡す役割をするのが引数です。渡されたデータは文字列データのプレーンテキストになっています。また、それぞれの引数はコーテーションマーク（引用符）で囲みます。

var row = 2; のラインで2の初期値を持つ変数の行を作成します。これは A列 の各行にある株式銘柄リストを反復して数え出す処理のための変数です。そして株式の正しい情報を作り出します。

while (true) の構文には if ループ 内でA列のセルに株式銘柄が入力されているかどうかを連続的にチェックするプロセスが織り込まれています。 各セルの値は、シンボル変数に読み込まれ、もし変数が値を持っていれば、FinanceAppクラス の getStockInfo() メソッドが それぞれの銘柄に対し name, exchange, trading time, price を得るように呼び出されます。さらに setValue() がシートの銘柄行の適切な位置に書き込むように呼び出されます。

if (!symbol) break; の行はシンボル変数に銘柄名が無いときにはループから出るように指示するコードです。 感嘆符は否定的な状態 - ここでは値の無いことをチェックされている状態を指します。 スプレッドシートの２行目から８行目まで埋まっているとしましょう。row++; 文はループプログラムの繰り返しを一回としたカウンターとして 行変数を増やしていく役目です。これよって行変数が９までくると、この行には銘柄名が無いことを理解して、この時点で break によるループからの脱出用スクリプトが呼び出されて終了します。

Logger.log("Updating symbol: " + symbol); はスクリプトが実行されたときに各銘柄名に対するログメッセージを記録します。 ログメッセージを見れば、使用中のスプレッドシート上の銘柄名以外のすべてのデータをクリアできます。Script Editor を開いて View > Logs を見てください。各銘柄に対するログメッセージがパネルに表示されています。

1. スクリプトをインストールして実行を許可しました。
2. 株式銘柄をn行まで入力しました(A1,A2,・・・An)。
3. Finance > Get Stock を選択してスクリプトを実行します。
4. シートを閉じて２～３日後にシートを開いてみます。
5. Finance > Get Stock を再び選択します。セルに表示される情報が作成時のとき同じままです。 株式銘柄の入ってないセルはクリアして Get Stock を再実行します。残っているセルの情報が更新されているでしょう。

1. Script Editor を開いてください。
2. Stock Price スクリプトが開いているか確認してください。
3. 違っていたら エディターの File > Open から正しいスクリプトを出してください。
4. ２つ目の関数の各行頭に２本のスラッシュを書き加えて、下の非連続の行を取り除くかコメントアウトしてください。