Google Apps Script開発スキル
基本方針
- JSDoc形式のコメント必須
- try-catchでエラーハンドリング
- ログ出力: console.log / Logger.log
- トリガー設定を考慮した設計
標準テンプレート
/**
* メイン処理
* @description 処理の説明
*/
function main() {
try {
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheetByName('シート名');
// 処理
console.log('処理完了');
} catch (e) {
console.error('エラー: ' + e.message);
throw e;
}
}
よく使うパターン
スプレッドシート操作
// 最終行取得
const lastRow = sheet.getLastRow();
// 範囲取得
const range = sheet.getRange(row, col, numRows, numCols);
// 値の一括取得/設定
const values = range.getValues();
range.setValues(values);
外部API連携
/**
* 外部APIを呼び出す
* @param {string} url - APIエンドポイント
* @returns {Object} レスポンスデータ
*/
function fetchApi(url) {
const options = {
method: 'get',
headers: {
'Content-Type': 'application/json'
},
muteHttpExceptions: true
};
const response = UrlFetchApp.fetch(url, options);
return JSON.parse(response.getContentText());
}
実行時間制限対策
- 6分制限を意識した分割処理
- PropertiesServiceで状態保存
- トリガーでの継続実行
/**
* 処理状態を保存
* @param {number} lastIndex - 最後に処理したインデックス
*/
function saveProgress(lastIndex) {
const props = PropertiesService.getScriptProperties();
props.setProperty('lastIndex', lastIndex.toString());
}
/**
* 処理状態を取得
* @returns {number} 最後に処理したインデックス
*/
function getProgress() {
const props = PropertiesService.getScriptProperties();
const lastIndex = props.getProperty('lastIndex');
return lastIndex ? parseInt(lastIndex, 10) : 0;
}
トリガー設定
/**
* 時間ベースのトリガーを設定
*/
function createTimeTrigger() {
ScriptApp.newTrigger('main')
.timeBased()
.everyHours(1)
.create();
}
Examples
- 「スプレッドシートのデータを自動処理したい」→ getValues/setValuesパターンを提供
- 「毎日決まった時間に実行したい」→ トリガー設定のテンプレートを提供
- 「外部APIからデータを取得したい」→ UrlFetchAppパターンを提供
- 「処理が6分で止まる」→ 分割処理＋PropertiesService保存パターンを提供
Guidelines
- すべての関数にJSDoc形式のコメントを付ける
- try-catchで例外処理を必ず実装
- 6分の実行時間制限を意識した設計にする
- 状態保存にはPropertiesServiceを使用
- ログ出力はconsole.logまたはLogger.logを使用
- スプレッドシート操作はgetValues/setValuesで一括処理（セル単位アクセスは遅い）
- API呼び出しにはmuteHttpExceptions: trueを設定してエラーハンドリング
majiayu000