スプレッドシートに並んだ商品名や問い合わせの文から、説明文や要約を 1 行ずつ作りたい。ChatGPT の画面に 1 件ずつ貼りつけて、答えをコピーして戻す……を何百行もくり返すのは大変です。
GAS(Google Apps Script)から ChatGPT の API を呼ぶと、A 列の内容をもとに、B 列へ文章を自動で書き込めます。この記事では、次のことまで考えた書き方をまとめました。
・API キーをコードに書かない
・作り終えた行は飛ばし、失敗した行だけあとでやり直す
・6 分の制限や使いすぎで止まらないよう、1 回の量を決める
■ 用意するもの
・OpenAI の API キー(OpenAI のサイトで作ります。API は使った分だけ料金がかかります)
・「一覧」という名前のシート。1 行目は見出し、A 列に元の文(例:商品名と特徴)、B 列は空、C 列はメモ用
■ 手順 1:キーとモデル名を「スクリプト プロパティ」に入れる
スプレッドシートの「拡張機能 → Apps Script」を開き、左の歯車「プロジェクトの設定」の下にある「スクリプト プロパティ」に、次の 2 つを足します。
・OPENAI_API_KEY:API キー
・OPENAI_MODEL:使うモデルの名前(OpenAI のモデルの一覧で、いま使えるものを確かめて書きます)
コードにキーを書くと、スクリプトを人に見せたときや共有したときに、キーまで渡ってしまいます。プロパティに置けば、コードだけを安心して見せられます。
■ 手順 2:コードを貼る
const SHEET_NAME = '一覧'; // 文章を作るシートの名前
const MAX_ROWS_PER_RUN = 50; // 1 回に作る行の上限(使いすぎを防ぐ)
const LIMIT_MS = 4.5 * 60 * 1000; // 6 分の制限の前に止める
const PROMPT = 'あなたはネットショップの担当者です。商品名と特徴から、120字以内の商品説明を1つ書いてください。事実にないことは書かないでください。';
function writeWithAI() {
const props = PropertiesService.getScriptProperties();
const key = props.getProperty('OPENAI_API_KEY');
const model = props.getProperty('OPENAI_MODEL');
if (!key || !model) throw new Error('スクリプト プロパティに OPENAI_API_KEY と OPENAI_MODEL を入れてください');
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName(SHEET_NAME);
if (!sheet) throw new Error('シート「' + SHEET_NAME + '」が見つかりません');
const last = sheet.getLastRow();
if (last < 2) return 0;
const rows = sheet.getRange(2, 1, last - 1, 2).getValues();
const start = Date.now();
let done = 0;
for (let i = 0; i < rows.length; i++) {
if (done >= MAX_ROWS_PER_RUN || Date.now() - start > LIMIT_MS) break;
const input = rows[i][0];
const output = rows[i][1];
if (input === '' || output !== '') continue; // 空の行と、作り終えた行は飛ばす
const row = i + 2;
try {
sheet.getRange(row, 2).setValue(askAI(key, model, input));
sheet.getRange(row, 3).setValue('');
done++;
} catch (e) {
sheet.getRange(row, 3).setValue('エラー:' + e.message); // B 列は空のまま。次の実行でやり直す
if (e.message.indexOf('429') >= 0) break; // 混んでいるときは、続けずに止める
}
}
return done;
}
function askAI(key, model, input) {
const res = UrlFetchApp.fetch('https://api.openai.com/v1/chat/completions', {
method: 'post',
contentType: 'application/json',
headers: { Authorization: 'Bearer ' + key },
payload: JSON.stringify({
model: model,
messages: [
{ role: 'system', content: PROMPT },
{ role: 'user', content: String(input) },
],
}),
muteHttpExceptions: true,
});
const code = res.getResponseCode();
if (code !== 200) throw new Error('API の応答 ' + code);
return JSON.parse(res.getContentText()).choices[0].message.content.trim();
}
PROMPT の文を、作りたい文章に合わせて書き換えます。例:「問い合わせの文を『質問・不具合・要望』のどれか 1 語で答えてください」にすれば分類に、「200 字以内で要約してください」にすれば要約に使えます。
■ 手順 3:動かす
エディタの上で writeWithAI を選んで「実行」を押します。最初の 1 回だけ、許可の画面が出ます(「このアプリは Google で確認されていません」と出たときは、下の記事に進め方を書いています)。
B 列が空の行に文章が入り、すでに入っている行は飛ばします。行が多いときは、トリガーで 10 分ごとなどに動かすと、残りの行を少しずつ作ってくれます。
■ このコードで工夫していること
・1 回に 50 行まで、4.5 分で止まります。GAS の「6 分の制限」で途中で落ちるのを防ぎ、間違って何千行も送って料金がかさむのも防ぎます
・失敗した行は B 列を空のまま残し、C 列に「エラー:API の応答 500」のように理由を書きます。次に動かしたとき、その行だけやり直します
・「429」(混んでいる・上限に近い)が返ったら、続けずに止めます。少し時間をおいて、もう一度動かしてください
・エラーの文に API キーは入りません
■ つまずきやすいところ
・「API の応答 401」:キーが違うか、貼るときに前後に空白が入っています
・「API の応答 404」や「モデルが見つからない」:OPENAI_MODEL の名前を確かめてください
・「API の応答 429」:利用の上限か、支払いの設定がまだのことがあります。OpenAI の管理画面で確かめてください
・最初は 3〜5 行だけのシートで試すと、料金も少なく、結果も確かめやすいです
■ 使う前に知っておきたいこと
・生成 AI の文章は、正しいとは限りません。商品ページへの公開やお客様への送信の前に、人が読んで確かめてください
・お客様の名前や住所などの個人情報は、送らない形にするのがおすすめです(必要な列だけを渡す)
■ 自分で作るのが大変なときは
「うちのシートに合わせて作ってほしい」「分類や要約の指示文を調整したい」といったときは、次の出品でお手伝いしています。API キーはお預かりせず、ご自身で設定する手順をお渡しします。
あわせて読みたい:
この記事は、AI(Claude)の助けを借りて書いています。コードは、テスト用のデータで動きを確かめてから載せています。