スプレッドシートのテキストを丸ごと英訳するGASマクロを作ってみた

Yasuaki Machida

2023.12.13

テクノロジー

Technology

Technology部の町田です。

翻訳ツールとして知名度の高いDeepLはAPIも提供しており、各種ツールと連携することでサイトだけでなくスプレッドシートのテキストなども翻訳可能です。

私はもともと、スプレッドシートで引数として指定したセルの内容をDeepLAPIで英訳するDeepL関数を使っていました。しかし、これだと元の内容とは別に翻訳後のテキストを記載するセルを用意する必要があること、シート単位で関数をコピペする必要があり、シートが複数存在するスプレッドシートを一括で英訳するには少し不便です。

そこで今回は、DeepL APIを使ってスプレッドシートの内容を一括で翻訳するGASマクロを作りましたのでご紹介します。

DeepL APIを使うための準備

まずはDeepL APIの公式サイトからアカウント登録をおこなう必要があります。

DeepL API

無料プランと有料のProプランがありますが、無料プランでも１ヶ月あたり５０万字まで翻訳できます。使用頻度などを考慮してプランを選びましょう。

サイト右上の「無料で体験する」ボタンからアカウント登録できます。

画面に従い情報を入力していきます。無料プランでもクレジットカード情報を登録する必要がありますが、複数アカウントでの不正利用を防ぐためなので、自動で課金されることはありません。

登録が完了したらアカウント情報からAPIキーが取得できます。

DeepL APIでまるごと翻訳するためのGASマクロ

GASマクロは以下です。”YOUR API KEY”の箇所をDeepL APIアカウントで発行されるAPIキーに置き換えて使用してください。

function translateSpreadsheet() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheets = ss.getSheets();

  for (var i = 0; i < sheets.length; i++) {
    var sheet = sheets[i];
    var range = sheet.getDataRange();
    var values = range.getValues();
    var translatedValues = [];

    for (var j = 0; j < values.length; j++) {
      var row = values[j];
      var translatedRow = [];
      for (var k = 0; k < row.length; k++) {
        if (row[k]) {
          translatedRow.push(translateWithDeepL(row[k]));
        } else {
          translatedRow.push("");
        }
      }
      translatedValues.push(translatedRow);
    }
    range.setValues(translatedValues);
  }
}

function translateWithDeepL(text) {
  var apiEndpoint = "https://api-free.deepl.com/v2/translate";
  var apiKey = "YOUR API KEY";  // あなたのDeepL APIキーをこちらに入力してください
  var payload = {
    'auth_key': apiKey,
    'text': text,
    'target_lang': 'EN'
  };

  var options = {
    'method' : 'post',
    'payload' : payload
  };

  var response = UrlFetchApp.fetch(apiEndpoint, options);
  var json = JSON.parse(response.getContentText());

  if (json.translations && json.translations.length > 0) {
    return json.translations[0].text;
  } else {
    return text;  // 翻訳に失敗した場合、元のテキストを返す
  }
}

使い方

Googleスプレッドシートを開く
拡張機能からApps scriptを選択
上記GASスクリプトを貼り付け→保存
関数を指定し、実行ボタンを押す
実行完了まで待つ

DeepL関数との使い分け

冒頭で説明した通り、スプレッドシートではDeepL関数も使えます。今回ご紹介したマクロとDeepL関数のメリット・デメリットや、推奨利用シーンをまとめました。

	DeepL関数	一括翻訳マクロ
メリット	・日本語版と英語版を同一ドキュメントで管理できる・編集内容がリアルタイムで翻訳にも反映される	・ボタン1つでドキュメント内のすべてのセルを英訳できる
デメリット	・翻訳対象のセルすべてに対し関数を入力する必要がある・ドキュメントを開く度にAPIも用いて翻訳するためAPI容量の消費が早い	・翻訳後に元ドキュメントに修正が入った場合は修正箇所を手動で反映する必要がある
推奨シーン	・1からドキュメントを作成する際・セルの内容に修正が入る可能性がある資料を翻訳したい	・クライアントから受領した資料を英訳したい・複数シート存在するボリュームの大きい資料を英訳したい