既成のスクリプトのインストールと実行

株価情報を取得するスクリプトをインストールしてみましょう。このスクリプトはユーザーのピーターポンが書いたもので彼の許諾の元使用します。グーグルはこのスクリプトには責任を負わないものとします。

株価スクリプトをインストールして実行するには

1. グーグルアカウントからグーグルドキュメントを開きます
2. 作成＞スプレッドシートを選択
3. 自動的に保存されるようにスプレッドシートの名前を設定
4. ツール＞スクリプトギャラリーを選択
5. Stock Price スクリプトを検索してインストールをクリック。インストールが成功したことが表示される
6. 閉じるをクリック
7. ツール＞スクリプトマネージャを選択。二つの関数がスクリプトリストに見える
8. どちらかのスクリプトを選んで実行をクリック。authorizationを聞かれる
9. Authorizeをクリックしてスクリプトを実行、Now you can run the scriptのメッセージが現れる
10. getStock関数を選んで実行。A1からE1のセルが Symbol,Name, Exchange, Trade Time, Priceで埋まる。それに加えFinanceメニューが現れる。（onOpen関数を実行すると出現）
11. 何か株シンボルをA2からA列に挿入する（ibm,goog,yhooなど）
12. Finance>Get Stockを選択。残りのセルが題目の情報で埋められる。

株価スクリプトの概要

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

これは二番目の関数、getStock()についてである。この関数はFinance > Get Stockをクリックした時に実行するコードを含んでる。スプレッドシートの列にヘッダーを挿入する。そしてA列に入力したストックシンボルを読み取り、それに対応する情報を引き出して、スプレッドシートにそれを挿入する。

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++;    
  }
}

関数が宣言された後、var sheet = SpreadsheetApp.getActiveSheet();は現在アクティブなスプレッドシートを獲得し、それをオブジェクトsheetに読み込む。現在アクティブのスプレッドシートとはは常にスクリプトが組み込まれてるスプレッドシートであるということを特筆する。

var row = 2;のラインは変数 row を初期値2で生成する。この変数は反復のカウンターとして使われる。列Aのストックシンボルのリストからそれぞれの行に対してそれぞれの列をそのストックシンボルに対応する情報で埋めていくためのカウンターとしてである。

while (true)ループは列Aにストックシンボルが存在するかどうかとif ループの内部を連続的にテストする為の処理を含む。それぞれのセルの値は変数symbolに読み込まれる。もしその変数が値を持っているならばFinanceAppオブジェクトのgetStockInfo()メソッドがそのストックシンボルに対する社名、市場名、トレーディング時間と価格を獲得するために呼ばれる。そしてsetValue()メソッドがスプレッドシートのそのシンボルの行の適切なセルに情報を書き込むために呼ばれる。そしてコードは更に二番目の列に値があるか確かめる。もし値があるなら、スクリプトは行はすでに更新されているものと想定して、処理をしない。

if (!symbol) break;のコードはsymbol変数にストックシンボルが入ってない場合にwhile ループから抜け出す為のスクリプトのコードである。感嘆符！は否定条件を記述していて、それによって値があるかどうかテストして、もし値がないならばそれに対応する分岐へ続く。あなたのスプレッドシートは二行目から八行目までストックシンボルで埋まってるかもしれないとする。それぞれの行に対して、最初の行のテキストをコードは読んでsymbol変数に割り当てる。

もし最初の列にテキストが存在しないならば、symbolは空の文字列を含むことになり、そのループは停止される。その場合意外実行は続けられ、空の行に達するまで行数は加算されていく。その時点に達したなら、breakがループから抜け出すスクリプトを呼び起こし、終了する。

Logger.log("Updating symbol: " + symbol);の記述はスクリプトが実行されるときにそれぞれのストックシンボルに対するログメッセージを記録する。ログメッセージを見るためには、あなたのスプレッドシートからストックシンボル意外のデータを消してスクリプトエディタからスクリプトを実行し、表示 > ログをクリックする。そうするとそれぞれのストックシンボルに対するログメッセージを表示するパネルを見ることができる。

株価スクリプトを改良する

// if (!sheet.getRange(row, 2).getValue())

//      } else {
//      Logger.log("Already updated: " + symbol);
//    }