【GAS】スプレッドシートに値をコピーして書き込む方法

2023年9月29日2024年4月27日

当ページのリンクには広告が含まれています。

URLをコピーしました！

にほんブログ村

こんにちは、わくほこ(@wakuhoko)です。

今回はGASを使ってスプレッドシートに値を書き込む方法をご紹介します。

具体的には、

すでにあるスプレッドシートから値を取得し、別のスプレッドシートへ書き込む

という処理になります！

自分メモなので、もし「もっと良い方法があるよ！」などありましたら、ぜひ教えてください。

コードを書く前の準備

コードを書く前に事前に確認しておいて欲しい点が2点あります。

GAS(Apps Script)の開き方
権限の確認

GASの開き方はこちらの記事を参考にしてみてください。

GASを実行するGoogleアカウントに書き込み先へのスプレッドシートの編集権限がないとGASの実行に失敗します。書き込み先のスプレッドシートに権限を追加しておきましょう。

スプレッドシートの右上の「共有」ボタンからアカウントに編集権限を付与できます。

コードを書いてみよう！

それでは実際のコードです。

前提として、以下のコードはコピー元のスプレッドシートのGAS(Apps Script)を開いて実行する想定です。

function myFunction() {
  //書き込み先スプレッドシートの取得
  const fileId     = "書き込み先のスプレッドシートのID";
  const fileObject =  SpreadsheetApp.openById(fileId);

  //書き込み先スプレッドシートのシート名を取得
　const fileSheet = fileObject.getSheetByName("シート名");
  
  //コピー元スプレッドシートのシート名を取得
　const orgFile = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("コピー元シート名");

　//値が存在するすべてのセルの値を取得 
  const orgData = orgFile.getDataRange().getValues();
  
 //書き込み先スプレッドシートの1行目1列目から書き込み
  fileSheet.getRange(1, 1, orgData.length, orgData[0].length).setValues(orgData);
}

コードの解説

まずは3行目のconst fileId = "書き込み先のスプレッドシートのID";というコード。

これは値の書き込み先のシートidを取得しています。

“https://docs.google.com/spreadsheets/d/XXXXXXX/edit?hl=ja#gid=0″

スプレッドシートのURLの「XXXXXXX」の部分をコードの書き込み先のスプレッドシートのIDに入力してください。

4行目のSpreadsheetApp.openById(fileId);では取得したidを元に書き込み先のスプレッドシートを指定して取得しています。

getSheetByName()は引数にシート名を指定することで、シートを取得することができます。

例えば、「シート1」という名前のシートを取得したければ、getSheetByName("シート1");となりますね！

余談ですが、スプレッドシートのシートってややこしいですよね…

SpreadsheetApp.getActiveSpreadsheet();ではコピー元のスプレッドシートを取得しています。

GASと紐づいていないスプレッドシートを取得したい場合は、3行目と4行目のようにidを指定します。

.getSheetByName("コピー元シート名")とすることでコピー元のスプレッドシートのシート名を指定することができます。

getActiveSpreadsheet() は今開いているスプレッドシートとGASが紐づいている場合に使えるメソッドです。

orgFile.getDataRange().getValues();では、getDataRange()で値が存在する範囲を、getValues()で指定した範囲の値を取得しています。

今回はコピー元のスプレッドシートから存在する値をすべて取得しています！

最後のgetRange(1, 1, orgData.length, orgData[0].length)ではコピー元のスプレッドシートのどこからどこまでの値を取得するかを指定しています。

getRange(何行目の,何列目から,何行目の,何列分)

の値を取得するかを指定しています。

setValues();は複数のセルに値を入力することができるメソッドです。

今回は引数にコピー元のスプレッドシートから取得した値を指定しています。

デバッグしてみよう！

せっかくなのでorgData.lengthとorgData[0].lengthの値を見てみましょう！

コピー元のスプレッドシートが以下のようになっているとします。

A列の1行目に「aaa」、A列の2行目に「bbb」という値が入っています。

//書き込み先スプレッドシートの1行目1列目から書き込み
  fileSheet.getRange(1, 1, orgData.length, orgData[0].length).setValues(orgData);
  Logger.log(orgData.length)
  Logger.log(orgData[0].length)

コードの最終行に2行付け足してGASを実行します。

GASの実行方法はこちら

するとログに以下のように表示されます。