はじめに：課題の特定とプロジェクトの始動

リスクマネジメント業務の傍ら、データ分析や業務効率化に取り組んでいる。本稿は、Google Apps Script (GAS) を用いて開発した「API/決済不要！Googleスプレッドシート自動翻訳・更新ツール」の開発記録である。

所属企業の日本支社では、韓国本社から共有される韓国語のGoogleスプレッドシートを日常業務で利用している。しかし、日本人従業員は都度翻訳が必要であり、非効率な状況にあった。

既存手法の問題点:

IMPORTRANGEでは、元シートの書式（行/列の非表示など）やセル内画像が正しく反映されない。
手動での翻訳・転記は、シート数が多く更新も頻繁なため、現実的な運用負荷ではなかった。

多くの従業員は、一部のセル内容をコピーし、翻訳サイトに貼り付けて業務を行っていた。この反復作業を自動化し、同僚の不便を解消することが本プロジェクトの目的となった。

開発方針:

利便性: 複雑な設定を避け、Googleスプレッドシートのコピーのみで利用可能にする。
経済性: 外部APIやサーバーを利用せず、無料で完結させる。

GASは過去に簡単なデータ処理や個人用ツール作成で使用経験があったが、本格的なツール開発はこれが初めての試みだった。

Version 0.1：段階的実行方式のプロトタイプ

最初のアイデアは「元シートの書式を維持し、テキストのみを翻訳で置換する」というものだった。

元シートのタブをcopyTo()で複製し、書式を維持。
複製したシートの内容をclearContent()で削除。
A1セルに以下の数式を入力し、全範囲の翻訳を試みる。
=MAP(IMPORTRANGE("元ID", "元シート!全範囲"), LAMBDA(cell, IF(cell="", "", GOOGLETRANSLATE(cell, "ko", "ja"))))

しかし、以下の問題が発生した。

日付のシリアル値化: GOOGLETRANSLATEをMAP関数等と組み合わせると、日付書式が維持されずシリアル値（例: 45755）に変換された。
GASの6分実行制限: 複数のシートを連続処理すると、タイムアウトエラーで停止した。

これらの制約により、リアルタイムの数式反映は断念。ボタンクリックで値と書式を書き込む手動更新方式へ変更した。タイムアウト対策として、ユーザーがメニューを複数の段階に分けて順次クリックする方式を暫定的に採用した。

このバージョンを同僚に共有したところ、実用性については評価された一方、以下のフィードバックを得た。

UIの複雑性: 複数のメニューを順番にクリックする必要があり、直感的でない。
処理時間の可視化: 実行にかかる時間の目安が事前に知りたい。

このフィードバックが、「ワンクリック実行」という目標を本格的に目指すきっかけとなった。

Version 1.0への道：技術的課題との向き合い

ワンクリック実行の最大の障壁は「GASの6分実行時間制限」だった。ここからはChatGPT、Gemini等のAIツールを補助として活用し、コーディングを本格化させた。

最初の難関：トリガーチェーンの不安定性

6分制限を回避するため、シート処理を関数に分割し、処理が完了するごとに次の関数をトリガーで呼び出す「トリガーチェーン」を試みた。

試行1（全トリガー一括登録）: forループで全タブのトリガーを登録 → GASのトリガー上限数（20個）に抵触し失敗。
試行2（ブロック単位での並列処理）: 複数タブをまとめて処理するブロック単位でのトリガー発行を試みたが、APIの同時呼び出しが許容範囲を超え、一部のシートが翻訳途中でフリーズ（無限「ロード中...」）する問題が多発。原因特定に時間を要した。

最終的に、安定性を優先し、1タブにつき1トリガーで順次処理する方式（現在の「低速実行」モードの原型）に方針転換した。

第2の難関：`GOOGLETRANSLATE` API呼び出しの最適化

順次実行でもGOOGLETRANSLATEの「ロード中...」問題は依然として発生した。API呼び出しを最小化するため、「バッチ翻訳」を試みた。複数セルのテキストをJOINで結合し一括翻訳後、SPLITで分割する手法である。

区切り文字の問題:
- 改行コード (CHAR(10))：元のセルに改行があるとデータが破損。
- HTMLタグ (<SEP>)：GOOGLETRANSLATEがタグを任意に変換・削除。
- 特殊文字の組み合わせ (◆◆◆)：同一内容が連続すると区切り文字が無視される。

安定した実装は困難と判断し、バッチ翻訳は断念。MAP(IMPORTRANGE(...))構造は維持しつつ、空白セルは翻訳対象外とする条件分岐を追加し、API負荷を軽減させた。
「ロード中...」問題への対策として、SpreadsheetApp.flush()とUtilities.sleep()を適宜配置し、カスタム関数によるポーリングで計算完了を待機するロジックを実装した。

第3の難関：書式と画像の保持

書式問題: copyTo(targetRange, {formatOnly:true})は異なるスプレッドシートファイル間では機能しない。
- 解決策: 元シートを作業中のスプレッドシートに一時シート (_format_tmp) として複製。同一ファイル内になった後、そこから書式のみをコピーする方式で対応。
画像保持問題: GASのsetValueは、値を書き込むとセル内画像を強制的に削除する。また、IMPORTRANGEは画像を取得できず#REF!エラーを返す。
- 解決策: IMPORTRANGEで#REF!エラーとなるセル（=画像セル）を特定。翻訳結果を書き戻す際、そのセルへのsetValue実行をスキップすることで、最初にシート全体をコピーした際の画像をそのまま維持する。列単位で#REF!の有無を判定し、#REF!がない列はsetValuesで一括処理するよう最適化した。

その他、シート並び替えの不具合、翻訳によるタブ名の重複、逆翻訳問題、非表示シートの処理といった細かいバグを修正していった。

Version 2.0：実行モードの多様化と利便性向上

低速な順次トリガー方式に加え、「数タブだけ素早く更新したい」というニーズに応えるため、「高速実行（5分制限）」モードを追加した。

高速実行モードのロジック:
- startTime = new Date().getTime()で開始時間を記録。
- 各タブ処理前に経過時間を確認し、残存実行時間が1分未満になった場合（安全マージン60秒）、処理を中断。
- 中断した箇所をH23セルに自動記録し、ユーザーに次回再開可能な旨を通知する。

これにより、ユーザーは用途に応じて実行方式を選択できるようになった。

実行ボタン（管理シート）: 高速実行モード。H23セルで開始タブを指定可能。
低速実行ボタン（管理シート）: 従来のトリガーチェーン方式。全タブを確実に更新。
自動化の登録: 低速実行モードを毎日指定時刻に実行するトリガーを設定。
現在タブ更新（上部メニュー）: アクティブなシートのみを、事前に設定した複数の言語ペアから選択して即時更新。

これらの機能追加に伴い、「使い方」シートのドキュメントも拡充した。

開発を通じて得た知見

このプロジェクトは、単なるコーディング以上の経験となった。

課題解決の重要性: 現場の具体的な不便を解消することに直接貢献できた。同僚からの「楽になった」というフィードバックが最大のモチベーションだった。
フィードバックと反復改善: 初期バージョンへの具体的なフィードバックが、機能改善の明確な指針となった。
AIの活用: AIツールは開発の強力な補助となるが、その回答は鵜呑みにできない。特に複雑な仕様（画像保持など）が絡む問題では、自身で仕様を理解した上で、適切な修正を指示する必要があった。
漸進的な開発: 最初から完璧を目指すのではなく、コア機能から実装し、フィードバックに基づいて優先順位を付けて改善していくアプローチが現実的だと学んだ。
UXの考慮: 機能実装だけでなく、エラーメッセージの平易化や説明書の整備など、ユーザーがどう使うかを常に意識することがツールの価値を高める上で重要だった。

今後の改善点

~~ハイパーリンク保持: 現バージョンでは、翻訳処理の過程でセル内のハイパーリンクは失われます。~~
- ✅ ハイパーリンク保持対応（2025-06-17更新）: 翻訳対象セルにハイパーリンクが存在する場合、リンク情報も保持されたまま翻訳後のテキストに再適用されるように修正。getRichTextValue()で元のリンクを取得し、setRichTextValue()で翻訳後のテキストと共に再構築している。

終わりに

このツールが、本社と支社間の円滑なコミュニケーションに貢献し、また、同じようにGAS等を活用して業務自動化に挑戦する方々の参考になれば幸いである。

GitHub Repository (ソースコード＆README): https://github.com/HNGSNGGN/gsheet-auto-translate-tool
Google Sheetsツールコピー用リンク: https://docs.google.com/spreadsheets/d/1iiGXb3FoQvdisdWWc9KplwzdHD07Ne1aYBnhvTI56ao/copy

長文を読んでいただき、感謝する。フィードバックは歓迎する。