Google Spreadsheets 漢字に読み仮名（ひらがな・カタカナ）を付けるカスタム関数を作った

Last updated at 2015-12-22Posted at 2015-12-22

これはなに？

いわゆるMicrosoft Excelで言うところのPHONETIC関数です。
漢字を含むテキスト・セルを指定することで、読み仮名を出力することができます。読み仮名はひらがなのふりがなでもカタカナのフリガナでも大丈夫です。

典型的な利用シーンとしては、住所録で氏名の読み仮名を自動で（それなりに）ふりたい、というシーンがあります。ちょうど年賀状シーズンの住所録でふりがなが必要になったりしていると思いますが、ローカルのExcelではなくGoogleスプレッドシートで管理している方も多いでしょう。ExcelにはPHONETIC関数があるのにGoogleスプレッドシートには同様の機能が無いのです。

機能

漢字を含むテキスト（セル）をひらがなへ変換 =HIRAGANA(input)
漢字を含むテキスト（セル）をカタカナへ変換 =KATAKANA(input)
フラグで変換先（ひらがな/カタカナ）を指定して変換 =KANA(input, flag)

使い方

このカスタム関数はgooラボのひらがな化APIを利用しています。そのため、gooラボでのアプリケーションIDの発行とGoogle Spreadsheetsへのカスタム関数登録の2ステップで使えるようになります。

gooラボアプリケーションID発行
Google Spreadsheetsへカスタム関数登録

gooラボアプリケーションID発行

gooラボAPI利用登録ページへアクセスし、利用規約をよく読んだ上で登録を行います（登録にはGitHubアカウントが必要です）。

GitHubの認証画面が表示されるのでAuthorizeボタンを押します。

登録が完了すると、アプリケーションIDが発行されて画面に表示されるのでコピーしておきます。

この手順は、一度だけ実行すれば二度目以降は不要になります。

Google Spreadsheetsへカスタム関数登録

続いて、実際にGoogleスプレッドシート上で各カスタム関数を使えるようにします。

まず、適当なGoogle スプレッドシートを開きます。新規作成でも構いません。今回のカスタム関数は利用するスプレッドシート（Excelで言うところのBook）毎に利用設定が必要ですのでご注意下さい。

次に、メニューバーの「ツール」から「スクリプトエディタ」を選択します。

すると、下図のような画面が開きます。別サービスに移動したように見えますが心配いりません。

以下のように記載されている部分を選択して削除してから、後述のスクリプトをコピー＆ペーストしてください。

function myFunction() {

}

上記を削除して、下記をコピー＆ペーストします。

var perform = function(output_type, sentence) {
  var endpoint = "https://labs.goo.ne.jp/api/hiragana";
  var payload = {
    "app_id": "ここにgooラボアプリケーションIDをペースト",
    "sentence": sentence,
    "output_type": output_type
  };
  var options = {
    "method": "post",
    "payload": payload
  };
  
  var response = UrlFetchApp.fetch(endpoint, options);
  var response_json = JSON.parse(response.getContentText());
  return response_json.converted;
};

/**
 * Convert Japanese KANJI to HIRAGANA by goo LAB API.
 *
 * @param {string} input The value of cell to convert.
 * @return The converted value that HIRAGANA.
 * @customfunction
 * @author Noriaki UCHIYAMA (twitter: @noriaki)
 */
function HIRAGANA(input) {
  return perform("hiragana", input);
}

/**
 * Convert Japanese KANJI to KATAKANA by goo LAB API.
 *
 * @param {string} input The value of cell to convert.
 * @return The converted value that KATAKANA.
 * @customfunction
 * @author Noriaki UCHIYAMA (twitter: @noriaki)
 */
function KATAKANA(input) {
  return perform("katakana", input);
}

/**
 * Convert Japanese KANJI to HIRAGANA/KATAKANA by goo LAB API.
 *
 * @param {string} input The value of cell to convert.
 * @param {boolean} output_type The flag of convert type. TRUE: HIRAGANA, FALSE: KATAKANA.
 * @return The converted value that specified in output_type param.
 * @customfunction
 * @author Noriaki UCHIYAMA (twitter: @noriaki)
 */
function KANA(input, output_type) {
  output_type = output_type ? "hiragana" : "katakana";
  return perform(output_type, input);
}