GASでスプレッドシートの指定セルからシートIDを取得する方法徹底解説

Google Apps Script（GAS）でスプレッドシートを操作するとき、シートごとの「グリッドID」を使いこなせると便利じゃ！getGridId()メソッドを活用すれば、シート名に依存せずにデータ管理ができるけん、覚えとくと役立つばい。

今回は、このgetGridId()の基本から応用テクニックまでを分かりやすく解説していくばい！

詳解！Ｇｏｏｇｌｅ　Ａｐｐｓ　Ｓｃｒｉｐｔ完全入門ＧｏｏｇｌｅアプリケーションとＧｏｏｇｌｅ　Ｗｏｒ第３版/秀和システム/高橋宣成

posted with カエレバ

楽天市場

Amazon

Yahooショッピング

1. getGridId()って何？
2. getGridId()の使い方
3. 実践的な使い方
1. ✅ シート間でデータコピー
4. シートを動的に作成＆記録
5. 高度な活用テクニック
1. 🔹 プロパティストアに保存
2. 🔹 条件付きシート操作
6. エラー対策と最適化
1. ⚠️ よくあるエラーと対策
2. ⏩ パフォーマンス最適化
7. まとめ

1. getGridId()って何？

グリッドIDは、各シートに割り当てられた一意の数値で、URLのgid=******部分に表示されるけん、そこで確認できるばい。

例えば、このURLを見てみると…

https://docs.google.com/spreadsheets/d/スプレッドシートID/edit#gid=123456789

ここで gid=123456789 がそのシートのグリッドIDち！

シート名を変更してもこのIDは変わらんけん、シートの管理がしやすくなるとよ。ただし、シートを削除して作り直すと新しいIDになるけん、そこは注意ばい！

2. getGridId()の使い方

基本的な使い方はめっちゃシンプル！

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange("A1");
console.log(range.getGridId());

これで、そのシートのグリッドIDが取得できるばい。

3. 実践的な使い方

✅ シート間でデータコピー

getGridId()を使って、指定したシートにデータを正確にコピーすることができるばい。

function copyDataWithGridId() {
  const sourceSheet = SpreadsheetApp.getActive().getSheetByName("データ元");
  const sourceGridId = sourceSheet.getRange("A1").getGridId();

  const destSheet = SpreadsheetApp.openById("ターゲットスプレッドシートID");
  destSheet.getRange(sourceGridId, 1, 1, 10, 2).copyTo(destSheet.getRange("C1"));
}

これならシート名が変わっても影響を受けんけん、安定した処理ができるとよ。

4. シートを動的に作成＆記録

シートをプログラムで作成して、そのグリッドIDを記録する方法もあるばい。

function createNewSheetWithTracking() {
  const spreadsheet = SpreadsheetApp.getActive();
  const newSheet = spreadsheet.insertSheet("新シート");
  const trackingSheet = spreadsheet.getSheetByName("シート管理") || spreadsheet.insertSheet("シート管理");
  
  const gridId = newSheet.getRange("A1").getGridId();
  trackingSheet.appendRow([new Date(), newSheet.getName(), gridId]);
}

これで、新しいシートの情報を自動的に管理できるっちゃ！

5. 高度な活用テクニック

🔹 プロパティストアに保存

グリッドIDをスクリプトプロパティに保存すれば、スクリプトの再実行時に使い回せるばい。

function storeGridId() {
  const sheet = SpreadsheetApp.getActiveSheet();
  const gridId = sheet.getRange("A1").getGridId();
  PropertiesService.getScriptProperties().setProperty("MAIN_SHEET_GRID_ID", gridId.toString());
}

🔹 条件付きシート操作

特定のシートだけに処理を適用するときも便利ばい！

function processSpecificSheet() {
  const targetGridId = 123456789; // 事前に確認した対象シートID
  const currentSheetId = SpreadsheetApp.getActiveRange().getGridId();

  if (currentSheetId === targetGridId) {
    executeSpecialOperations();
  } else {
    executeNormalOperations();
  }
}

6. エラー対策と最適化

⚠️ よくあるエラーと対策

エラー1: 存在しないシートを指定

const sheet = SpreadsheetApp.getSheetByName("重要データ");
if (!sheet) throw new Error("シートが存在しません");

エラー2: 権限不足エラー

"oauthScopes": [
  "https://www.googleapis.com/auth/spreadsheets"
]

⏩ パフォーマンス最適化

バッチ処理を活用する
まとめてグリッドIDを取得する

function batchGetGridIds() {
  const sheets = SpreadsheetApp.getActive().getSheets();
  const gridIds = sheets.map(sheet => sheet.getRange("A1").getGridId());
  console.log("全シートのグリッドID: ", gridIds);
}