既存スプレッドシート (オブジェクト) を取得する

既存のスプレッドシートオブジェクトを取得するには、SpreadsheetApp クラスの openById
メソッドを用いる。

【構文】

SpreadsheetApp.openById(id)

id : String 型。スプレッドシートのURLの key= 以降の部分の文字列を指定する。

戻り値 : Spreadsheet 型

 
 
スプレッドシートのURLが

 https://docs.google.com/spreadsheet/ccc?key=abcdEFGHijklmnopQrstUvwXYz&hl=ja#gid=0
  
であった場合の例を以下に記す。


【例】
function GetSpreadsheet() {
 var objSpreadsheet = SpreadsheetApp.openById("abcdEFGHijklmnopQrstUvwXYz");
 Browser.msgBox("スプレッドシート名 : " + objSpreadsheet.getName());
}
 

openById メソッドを用いて既存のスプレッドシートオブジェクトを取得しただけでは、見た目上、
何も起きない。但し、例題のようにスプレッドシートの名前を取得したり、シートの値を取得した
り、共同編集者の設定を行ったり、等の処理を実行する為には、先ず最初にスプレッドシート
オブジェクトを取得するところから始まるので、とても大事。