しごと自動化レシピ
ホーム / GAS / 手順ガイド

WORK RECIPE GAS

JSON配列を固定件数のバッチ候補へ分ける

APIへ渡す前の分割計画を作ります。検証用ブックの入力から新しい結果シートへ出力し、元の値や設定は残して照合します。

手順ガイド・実機未検証作成日 2026-10-18
五件のJSON配列 → 三つの分割バッチ（作業の流れを表す概念図）
実行確認の記録なし

公式資料を参照して構成した手順です。本記事の操作・コードの実行は未確認です。小さな入力例で期待結果を確かめてから利用してください。

できあがるもの

結果はバッチ1が2件[R1,R2]、バッチ2が2件[R3,R4]、バッチ3が1件[R5]のJSON文字列です。

始める前に

  • 自分が編集できる新しい検証用Googleスプレッドシート。シート名を「入力」に変更
  • 拡張機能から開く紐付きApps Script。V8ランタイムを使用し、同じプロジェクトに同名関数を置かない
  • 入力は100行12列以内。出力シート名「結果」は未使用。初回実行時に対象ファイルへの権限確認が必要
入力例

入力!A1をJSON、A2へ ["R1","R2","R3","R4","R5"] を入れます。

手順

  1. 新しい検証用ブックに入力例を用意します。原本や顧客情報を持つファイルでは実行せず、表と設定を小さなダミーで再現してください。空欄は文字として入れず、色・書式・非表示などを読む記事では記載の設定も手で用意します。
  2. 拡張機能のApps Scriptへ次の完全なコードを貼り付けて保存します。入力と結果のシート名は固定です。既存の結果があると上書きせず停止し、出力文字列には先頭アポストロフィを付けて数式としての再評価を避けます。 
    /** @OnlyCurrentDoc */
function recipeJsonBatchPlan() {
  const ss=SpreadsheetApp.getActiveSpreadsheet();
  const s=ss.getSheetByName('入力');
  if(!s||ss.getSheetByName('結果'))throw Error('入力シートと未使用の結果名が必要');
  if(s.getLastRow()>100||s.getLastColumn()>12)throw Error('検証用100行12列以内');
  const a=JSON.parse(s.getRange('A2').getDisplayValue());if(!Array.isArray(a)||a.length>100||a.some(x=>typeof x!=='string'))throw Error('文字列配列が必要');
  const o=[['バッチ','件数','JSON']];for(let i=0;i<a.length;i+=2)o.push([i/2+1,Math.min(2,a.length-i),JSON.stringify(a.slice(i,i+2))]);
  if(!o.length||!o[0].length||o.some(r=>r.length!==o[0].length))throw Error('出力列数を確認');
  const safe=o.map(r=>r.map(v=>typeof v==='string'?"'"+v:v));
  ss.insertSheet('結果').getRange(1,1,safe.length,safe[0].length).setValues(safe);
}
  3. エディタからrecipeJsonBatchPlanを選び手動実行します。初回は自分が選んだ対象ファイルへの権限内容を確認してください。この例はトリガーを作らず、メール送信・外部通信・ファイル削除をしません。処理後に作られた「結果」を開きます。
  4. APIへ渡す前の分割計画を作ります。端数の最終バッチを落とさないようsliceの結果件数を確認し、全バッチ合計5が入力件数に一致するか照合します。送信や再試行は含めず、人が内容をレビューできる一覧にします。 結果はバッチ1が2件[R1,R2]、バッチ2が2件[R3,R4]、バッチ3が1件[R5]のJSON文字列です。
  5. 結果の行数と値を入力例の期待結果へ照合し、入力シートの値と設定が元のままか確認します。重複IDは保持します。APIの制限は件数だけでなくバイト数や頻度もあるため、この分割で送信可能とは断定しません。 再実行するなら前回の結果を別名で保管してから実行します。入力例を変更しても既存結果は自動更新されません。

期待結果と照合する

結果はバッチ1が2件[R1,R2]、バッチ2が2件[R3,R4]、バッチ3が1件[R5]のJSON文字列です。

まずこの入力例で確認し、件数や値が一致しているかを見ます。完了表示だけで判断せず、重複・空欄・対象外データも残っていないか確認してください。

うまくいかないとき

  • 重複IDは保持します。APIの制限は件数だけでなくバイト数や頻度もあるため、この分割で送信可能とは断定しません。
  • このGASは接続済みGoogle環境で未実行です。構文確認と公式API照合は実機実行と異なります。入力例で期待値を確認してから範囲や業務規則を変更してください。

止める・元に戻す

出力された「結果」シートだけを必要に応じて保存してから削除し、追加した関数を外します。入力表・既存設定はコードから変更していないため、テストで手動設定した部分だけを元へ戻してください。

公式資料・対応範囲

参照日：2026-10-18。公式資料の一般的な機能説明と、本記事固有の入力例の実行検証は別です。実務での短縮時間や効果は未計測です。

同じツールで試す

GASの記事一覧へ →