GetFontColorObjects

Google Apps Script (GAS) でスプレッドシートの文字色を一括取得する際、getFontColors() というメソッドが存在します。しかし、これは現在 旧式 (Legacy) となっており、より高機能な getFontColorObjects() の使用が強く推奨されています。

この記事では、getFontColors() の基本的な仕様を解説すると共に、なぜ新しいメソッドへ移行すべきなのか、その決定的な違いと具体的な移行方法を解説します。

Google Apps Script 始め方 スプレッドシート 活用例 を各ショップで検索

楽天市場で探す Amazonで探す Yahoo!ショッピングで探す

getFontColors() の基本仕様

getFontColors() は、指定した範囲の各セルの文字色を、#ff0000 のような16進数カラーコードの文字列の二次元配列 (String[][]) として取得します。

Google Apps Script (GAS) で、広範囲のセルの文字色を一つずつチェックするスクリプトを書いた結果、「処理が遅すぎてタイムアウトしてしまう…」という経験はありませんか？ その原因は、セルの情報を何度も取得するためにAPIを繰り返し呼び出していることにあります。

このパフォーマンス問題を解決する鍵が、getFontColorObjects() メソッドです。

この記事では、getFontColorObjects() を使って複数セルの文字色情報を一括で高速に取得し、効率的に処理する方法を、具体的なコード例と共に徹底的に解説します。