Guide
Apps Script基礎ガイド
KOKOCAL SCRIPTで生成したスクリプトを導入する前に知っておきたい、Apps Scriptの基本をまとめたガイドです。 貼り付け、保存、初回承認、トリガー、HTMLファイル、複数スクリプト利用時の考え方を確認できます。
Code.gs、HTMLファイル、プロジェクト名など、必要な作成単位を先に確認します。
Googleの承認画面で求められる権限の意味を確認してから実行できます。
バックアップやテスト用ファイルを使い、実運用前に動作を確認します。
Apps Scriptの基本
Apps Scriptとは
GoogleスプレッドシートやGoogleスライドなどに、独自のメニュー、処理、自動化を追加できるGoogleのスクリプト実行環境です。KOKOCAL SCRIPTでは、このApps Scriptへ貼り付けて使うスクリプトを生成します。
バインド型スクリプト
多くのジェネレーターは、対象のスプレッドシートやスライドからApps Scriptを開き、そのファイルに紐づけて導入します。対象ファイル内でメニューやサイドバーを表示しやすい一方、利用したいファイルごとに導入が必要です。
Code.gsとHTMLファイル
Apps Script本体はCode.gsへ貼り付けます。サイドバーや画面部品を使うジェネレーターでは、LayerPanel.htmlなどのHTMLファイルも追加します。生成結果にファイル名が表示される場合は、その名前で作成してください。
初回承認
初めて実行すると、Googleアカウントによる権限承認が求められます。対象ファイルの読み書き、UI表示、トリガー作成など、スクリプトに必要な範囲で許可します。
導入の流れ
- 1
対象ファイルを開く
生成スクリプトを使いたいGoogleスプレッドシート、Googleスライドなどを開きます。
- 2
Apps Scriptを開く
拡張機能メニューからApps Scriptを開き、既存コードがある場合は退避してから貼り付けます。
- 3
必要なファイルを作成する
Code.gsのほか、HTMLファイルが必要な場合は、生成結果に表示されたファイル名で追加します。
- 4
保存して初期設定を実行する
保存後、指定された初期設定関数やメニュー作成関数を実行します。
- 5
元ファイルを再読み込みする
メニュー追加型のスクリプトでは、対象ファイルを再読み込みすると上部メニューに反映されます。
- 6
導入後確認を行う
生成結果の確認事項に沿って、テスト用ファイルまたはバックアップ済みファイルで動作を確認します。
生成結果には導入ガイドのダウンロード機能があります。ページを離れる前に保存しておくと、導入方法、確認事項、コード、JSONをまとめて見返せます。
注意事項
バックアップを作成する
データを変更するスクリプトは、実行前にファイルをコピーしてバックアップを残してください。特に一括整形や同期処理では重要です。
既存のonOpenやトリガーを確認する
複数のスクリプトを同じプロジェクトへ入れる場合、onOpenなどの共通関数やメニュー名、トリガーの重複を確認します。
権限の意味を確認する
承認画面では、スクリプトがどのGoogleサービスへアクセスするかを確認できます。不明な場合は、テスト用ファイルで先に確認してください。
処理量と実行時間に注意する
Apps Scriptには実行時間や読み書き回数の制限があります。大量データを扱う場合は、バッチ件数や対象範囲を控えめに設定してください。
よくあるつまずき
メニューが表示されない
初期設定関数を実行したあと、対象ファイルを再読み込みしてください。onOpenでメニューが作成されるタイプでは再読み込みが必要です。
HTMLファイルが見つからない
サイドバー型のスクリプトでは、Code.gsとは別にHTMLファイルを作成します。ファイル名の大文字・小文字も生成結果に合わせます。
権限承認で止まる
個人アカウントや組織設定によっては警告が表示される場合があります。自分で生成したコードであることを確認し、テスト用ファイルで先に実行してください。
複数スクリプトで競合する
onOpen、メニュー名、トリガー、共通関数名が重複していないか確認してください。複数利用時は専用ガイドも参照してください。
Guide
関連ガイド
Apps Scriptの基本を確認したあとは、画面の見方や複数スクリプト利用時の注意点も確認しておくと導入しやすくなります。