翻訳(オリジナル)

Powered by Google Translate
日本語
English
简体中文
繁體中文
한국어
Français
Deutsch
Español
Italiano
Português
Русский
Bahasa Indonesia
ไทย
Tiếng Việt
Bahasa Melayu
العربية
हिन्दी
Türkçe
Nederlands
Polski
Українська
Powered by Google Translate

Google Apps Scriptローカル開発環境構築ガイド(全4回)【第2回】Google公式ツール「clasp」の導入とGASプロジェクトの連携

当記事の作成にはAIアシスタントを使用しています。
誤った情報が含まれることもありますのでご了承ください。 


 

【第2回】Google公式ツール「clasp」の導入とGASプロジェクトの連携

前回の第1回では、なぜブラウザ版のGASエディタからVS Codeによるローカル開発環境へと移行すべきなのか、その圧倒的なメリットと全体のロードマップを解説しました。そして、すべての土台となる実行環境「Node.js」のインストールと、開発の相棒となる「VS Code内蔵ターミナル」の基本操作をマスターしていただきました。

「黒い画面」に対する苦手意識が少し和らぎ、手元のパソコンで開発を進めるための準備は万全に整っています。

連載の第2回となる本記事では、いよいよ手元のVS CodeとGoogleのクラウド環境を物理的に接続するコアな設定を行っていきます。本記事で到達するゴールは、「VS CodeのターミナルからGoogleアカウントへアクセスし、コマンドひとつでGASプロジェクトを新規作成・取得できる状態を作ること」です。

具体的には、以下のステップで作業を進めていきます。

  • Google公式CLIツール「clasp」のインストール:Node.js(npm)を利用して、ローカルPCに通信ツールを組み込みます。

  • Google Apps Script APIの有効化:Googleアカウント側のセキュリティ設定を変更し、外部ツールからの安全なアクセスを許可します。

  • clasp loginによるOAuth認証:ブラウザと連携してアクセス権限を確立し、安全なログイン状態を作ります。

  • プロジェクトの作成(create)と取得(clone):実際にコマンドを打ち込み、ローカルとGoogleドライブ上のGASプロジェクトを紐付けます。

手元のキーボードから打ったコマンドによって、Googleドライブ上に新しいGASファイルが自動で生成された瞬間、ローカル開発の面白さと利便性を実感していただけるはずです。

作業を始める前に、ご自身のGoogleアカウントにログインできる状態であること、そしてVS Codeが起動できることを確認しておきましょう。それでは、ローカル開発環境構築のハイライトとなる連携作業を開始していきましょう!

Google公式CLIツール「clasp」とは?

clasp(Command Line Apps Script Projects)の概要

ローカルPCで作成したプログラムをGoogleクラウド上で動かすためには、両者を安全に繋ぐ「架け橋」となるツールが必要です。その役割を担うのが、Googleが公式に提供・維持管理しているオープンソースのCLIツール「clasp(クラスプ)」です。

claspは「Command Line Apps Script Projects」の頭文字を取った名称であり、その名の通り、ターミナル(コマンドライン)からGoogle Apps Scriptを自由自在に操作するために設計されています。

従来の開発スタイルでは、ローカルで書いたJavaScriptコードをブラウザのGASエディタへ手動でコピペするか、非公式のブラウザ拡張機能などに頼るしかありませんでした。しかし、Google公式ツールであるclaspの登場により、コマンドひとつでローカルのファイル群をGoogleサーバーへ安全かつ一瞬でアップロード(同期)できるようになりました。

claspは、プロエンジニアが日常的に行っているスマートな開発フローを、GAS開発者にもたらしてくれる最も重要なツールと言えます。

claspでできるようになること・できないこと

claspは非常に強力なツールですが、万能の魔法というわけではありません。これからの開発をスムーズに進めるために、「claspが得意とすること(できること)」と「Web UI(ブラウザ版エディタ)でしか行えないこと(できないこと)」をあらかじめ整理しておきましょう。

それぞれの特徴と役割分担は以下の通りです。

  • claspが得意とすること(できること)

    • プロジェクトの操作:ターミナルからGASプロジェクトの新規作成、既存プロジェクトのローカルへのダウンロード(取得)を行う。

    • コードの同期:ローカルPCで保存したコード(.js / .tsファイル)をGASへ一括反映(push)したり、クラウド上の変更をローカルに引き込む(pull)処理。

    • ファイルの自動監視と即時反映:ローカルでファイルを保存した瞬間に、裏側で自動的にGASへコードを反映させる常時同期(watch)機能。

    • マルチバージョンの管理:GASのデプロイ(ウェブアプリやライブラリとしての公開)や、バージョン作成をコマンドから実行すること。

  • clasp単体ではできないこと(Web UIでの操作が必要なこと)

    • 初回実行時の権限承認:GASからGoogleフォームやSpreadsheetを初めて操作する際に表示される、「アカウントへのアクセスリクエスト(OAuth承認)」のクリック操作。

    • 時間主導型トリガー等の画面設定:「毎朝9時にスクリプトを実行する」といったクロックトリガーや、フォーム送信時トリガーのビジュアル設定(コードで動的生成する場合を除く)。

    • 実行ログ(Cloud Logging)の詳細確認:簡単なログ取得はコマンドでも可能ですが、詳細なスタックトレースや実行履歴の視覚的確認はWeb UIが適しています。

このように、基本となるコードの記述やファイル同期はすべてVS Codeとclaspで完結させつつ、アクセス権限の承認やトリガー設定などの「初回の環境設定」のみブラウザ版エディタを開いてサッと行う、というのが最も効率的なプロの開発スタイルとなります。

連携の仕組み:OAuth認証とAPI通信のイメージ

「自分のパソコンのターミナルからコマンドを打つだけで、なぜGoogleサーバー上のファイルが更新されるのだろう?」と不思議に思うかもしれません。claspが安全にクラウドと通信する裏側では、最新の標準Web技術が使われています。

その仕組みは大きく分けて2つの要素で成り立っています。

  • 認証の仕組み:OAuth 2.0(オーオース)

    • あなたのGoogleアカウントのパスワードをclaspに直接手渡すのではなく、Webブラウザを通じてGoogleの正規ログイン画面を開き、安全に「許可証(アクセストークン)」を発行してもらいます。

    • claspはこの暗号化された許可証を使って通信を行うため、パスワードが漏洩するリスクなく、安全なログイン状態を維持できます。

  • 通信の仕組み:Google Apps Script API

    • Googleが公式に用意している「外部プログラムからGASを操作するための専用窓口(API)」を利用します。

    • clasp push などのコマンドを実行すると、ローカルのファイルデータがGoogle Apps Script APIを経由して安全に通信され、Googleドライブ内の該当するGASファイルが書き換わる仕組みになっています。

安全なアクセス許可(OAuth認証)と、公式の通信窓口(API)の2つが正しく機能することで、セキュリティを万全に保ちながらローカル開発の恩恵を最大限に享受できるのです。

次章では、このclaspを実際にあなたのPCへインストールする具体的な手順を見ていきましょう!

 

npmを使用したclaspのインストール

グローバルインストール(-g)の概念

claspの概要と仕組みを理解したところで、いよいよ手元のパソコンへclaspをインストールしていきましょう。インストールの手段として使用するのが、第1回でNode.jsと一緒に導入したパッケージマネージャー「npm」です。

npmを使ってツールのインストールを行う際、非常に重要な概念となるのが「ローカルインストール」と「グローバルインストール」の違いです。

  • ローカルインストール(通常コマンド)

    • 特徴:現在作業している特定のプロジェクト(フォルダ)内でのみ利用できる形でパッケージを取り込みます。

    • 用途:Webサイトやアプリごとに個別に使うライブラリやプログラム(例えば、特定の計算を行うための補助コードなど)を管理する際に用います。

  • グローバルインストール(-g オプション付与)

    • 特徴:パソコン内のシステム全体に共通するツールとしてインストールします。

    • 用途:どのフォルダで作業していても、ターミナルを開けばいつでもどこでも呼び出せるコマンドラインツール(CLI)として導入したい場合に用います。

今回導入するclaspは、特定のGASプロジェクト内部に閉じ込めるライブラリではなく、パソコン内のあらゆる場所から clasp というコマンドを打ち込んでGASと通信するための「共通ツール」です。

そのため、コマンドの末尾に -g(globalの頭文字)というオプションを付けて、グローバルインストールを行います。

ターミナルでのインストールコマンド実行

では、VS Codeを開き、内蔵ターミナルを起動してインストールコマンドを実行しましょう。

VS Codeのメニューから「ターミナル」→「新しいターミナル」を選択し、以下のコマンドを入力して Enter キーを押します。

npm install -g @google/clasp

コマンドを実行すると、ターミナル上でパッケージのダウンロードとセットアップが自動的に始まります。数秒から十数秒ほど画面上にプログレスバーや各種ログが表示されますので、処理が完了するまでそのまま待ちましょう。

画面に added 1 package や changed X packages といったメッセージが表示され、再び入力待ちのプロンプト( PS C:\...> や user@MacBook % )に戻ればインストールは完了です。

 
筆者が実際に行った場合は以下のような表示が出ました。
npm warn deprecated uuid@9.0.1: uuid@10 and below is no longer supported.  For ESM codebases, update to uuid@latest.  For CommonJS codebases, use uuid@11 (but be aware this version will likely be deprecated in 2028).

added 263 packages in 32s

94 packages are looking for funding
  run `npm fund` for details
npm notice
npm notice New major version of npm available! 11.13.0 -> 12.0.2
npm notice Changelog: https://github.com/npm/cli/releases/tag/v12.0.2
npm notice To update run: npm install -g npm@12.0.2
npm notice

なお、Mac環境において、グローバルインストールの際に npm ERR! code EACCES という権限エラー(Permission denied)が発生する場合があります。これはMacのシステム保護機能によって、システムの共通領域へのファイル書き込みが制限されているために起こります。

もし権限エラーが発生した場合は、コマンドの先頭に管理者権限を付与する sudo を付けて、以下のように実行してください。


sudo npm install -g @google/clasp

実行時にMacのログインパスワードを求められますので、キーボードでパスワードを入力して Enter を押します(※セキュリティ上、パスワード入力中は画面に文字が表示されませんが、内部的には正しく入力されていますのでそのまま入力して確定させてください)。

インストールの動作確認

インストールが無事に完了したら、claspがパソコン上で正常にコマンドとして認識されているか動作確認を行いましょう。

ターミナルで以下のバージョン確認コマンドを実行します。

clasp -v
または、以下のように入力しても同様の結果が得られます。
clasp --version
コマンドを実行して、ターミナルに 2.4.2 や 3.x.x といった数字(バージョン情報)が返ってくれば、claspのグローバルインストールは100%成功です。

もし「clasp は、内部コマンドまたは外部コマンド...として認識されていません」といったエラーが出る場合は、第1回で解説した通り、一度VS Codeを再起動してターミナルを開き直し、環境変数(パス)が再読み込みされた状態で再度試してみてください。

コマンドを実行して、ターミナルに 2.4.2 や 3.x.x といった数字(バージョン情報)が返ってくれば、claspのグローバルインストールは100%成功です。

もし「clasp は、内部コマンドまたは外部コマンド...として認識されていません」といったエラーが出る場合は、第1回で解説した通り、一度VS Codeを再起動してターミナルを開き直し、環境変数(パス)が再読み込みされた状態で再度試してみてください。

事前準備:Google Apps Script APIの有効化

なぜAPIの有効化設定が必要なのか?

claspの準備が整ったら、次はアクセスされる側である「Googleアカウント」側の設定を行います。この設定を行わないと、どれだけ正しいコマンドを入力してもclaspとGoogleクラウドを繋ぐことはできません。

行うべき設定とは、「Google Apps Script API」の有効化(スイッチをONにする作業)です。

Googleのアカウントはデフォルト状態において、安全性を最優先するセキュリティ設計となっています。そのため、GoogleのWeb画面以外(外部のプログラムやclaspなどのツール)から勝手にGASのプロジェクトを作成したり、コードを書き換えたりする通信を、初期設定ですべてブロック(遮断)しています。

つまり、そのままの状態でclaspを使おうとすると、Google側が「不審な外部アクセス」と判断し、処理を拒否してしまうのです。

「Google Apps Script API」のスイッチをONに切り替えることは、あなた自身のGoogleアカウントに対して「私はclaspという外部ツールを使って自分のGASプロジェクトを管理しますので、アクセスを許可してください」と明示的にセキュリティの扉を開けてあげる作業を意味します。

この事前準備を怠ると、後のステップで必ず「User has not enabled the Apps Script API(ユーザーがApps Script APIを有効化していません)」というエラーが発生して作業がストップしてしまいます。必ずこの段階で設定を完了させておきましょう。


設定画面からのAPIオン切り替え手順(ステップバイステップ)

APIの有効化作業は、ブラウザ上のGoogle Apps Script設定画面から数クリックで行うことができます。以下の手順に沿って設定を進めてください。

  1. Google Apps Scriptのホーム画面へアクセスする お使いのWebブラウザ(Google Chrome等)を開き、以下のURLにアクセスします。

    • Google Apps Script ユーザー設定ページ:[https://script.google.com/home/usersettings](https://script.google.com/home/usersettings)

    • ※または、通常のGASホーム画面( script.google.com )を開き、左側メニューの一番下にある「歯車アイコン(設定)」をクリックしても移動できます。

  2. ログインアカウントの確認 画面右上のアカウントアイコンを確認し、これから開発で使用するGoogleアカウントでログインしているかを必ず確かめてください。複数のアカウントでログインしている場合は、意図しないアカウントの設定を変更してしまうのを防ぐため、正しいアカウントへ切り替えておきます。

  3. 「Google Apps Script API」の設定項目を探す 設定ページが開くと、アカウントに関するいくつかの項目が表示されます。その中にある「Google Apps Script API」という項目を探します。

  4. スイッチを「オン」に切り替える 項目の横にあるトグルスイッチを確認します。初期状態では「オフ(グレー色)」になっていますので、スイッチをクリックして「オン(青色または緑色)」に変更します。 

設定変更後に「保存」ボタンなどを押す必要はありません。スイッチが「オン」の表示に変わった時点で、Googleサーバー側に設定が自動保存されます。

設定変更時の注意点と反映タイミング

設定作業自体は非常にシンプルですが、初心者が陥りがちな2つの注意点があります。

  • 複数アカウントログイン時のアカウント間違い プライベート用と仕事用など、同じブラウザで複数のGoogleアカウントに同時ログインしている場合、ブラウザのセッション切り替えによって「設定を変更したアカウント」と「この後VS Codeでログイン認証するアカウント」が食い違ってしまうケースがよくあります。必ず操作中のアカウントアイコンを注視してください。

  • Googleサーバー側への設定反映のタイムラグ 画面上でスイッチを「オン」に切り替えた直後は、Googleの内部サーバー全体へ設定が浸透するまでに、数秒から数十秒ほどのごくわずかなタイムラグが生じることがあります。スイッチを入れた直後にコマンドを実行してエラーが出たとしても慌てず、1分ほど時間を置いてから次のステップへ進むと安全です。

これで、Googleアカウント側の受け入れ態勢も完璧に整いました。

次章では、いよいよ clasp login コマンドを実行し、VS CodeとGoogleアカウントを安全にログイン認証させる手順へと進みましょう!

 

clasp loginでGoogleアカウントと認証連携

clasp login コマンドの実行

claspのインストールと「Google Apps Script API」の有効化が完了したら、いよいよ手元のVS Code(clasp)とGoogleアカウントを接続する認証作業に入ります。

この認証処理を行うために使用するのが clasp login コマンドです。

VS Codeを開き、内蔵ターミナルに以下のコマンドを入力して Enter キーを押します。

clasp login
コマンドを実行すると、ターミナル上に認証用URLが内部生成され、即座にパソコンで既定のWebブラウザ(Google Chromeなど)が全自動で起動します。 

もしブラウザが自動的に開かない場合は、ターミナル画面に表示されている [https://accounts.google.com/o/oauth2/v2/auth](https://accounts.google.com/o/oauth2/v2/auth)... から始まる長いURLをコピーし、手動でブラウザの文頭アドレスバーに貼り付けてアクセスすれば問題ありません。

このコマンドによって、Googleの安全なOAuth 2.0認可プロセスが起動し、Webブラウザ側でのアクセス許可手続きへと移行します。

ブラウザでのOAuth認証フロー

自動的に立ち上がったWebブラウザ画面では、安全にGoogleアカウントとの通信許可を確立するための認証ステップが進行します。画面の指示に従って以下の手順で進めてください。

  1. 連携するGoogleアカウントの選択
    ブラウザに「アカウントの選択」画面が表示されます。前章で「Google Apps Script API」を有効化させたGoogleアカウントを正確に選択します。複数のアカウントが表示されている場合は、アカウント間違いに十分注意してください。

  2. 「Google clasp が Google アカウントへのアクセスを求めています」の許可
    アカウントを選択すると、claspがアクセスしようとしている権限の一覧(Google Apps Scriptの作成・表示・管理、Googleドライブの表示など)が表示されます。内容を確認し、右下の「許可」または「続行」ボタンをクリックします。
    ※使用しているアカウントやセキュリティ設定によっては、途中で「このアプリは Google で確認されていません」という警告画面(安全でないページへの移動)が表示される場合があります。この場合は画面左下の「詳細」をクリックし、「Google clasp(安全でないページ)に移動」のリンクを選択して許可手続きを続行してください。

  3. 「Logged in! You may close this page.」画面の確認
    すべての許可操作が正常に完了すると、ブラウザ上に「Logged in! You may close this page.(ログインが完了しました。このページを閉じて構いません)」という英字メッセージが表示されます。

このメッセージを確認したら、開いたブラウザのタブを閉じてVS Codeのターミナル画面へ戻りましょう。ターミナル側にも Logged in to ... という成功ログが表示されて入力プロンプトに戻っていれば、認証連携は完全に成功です。

認証情報ファイル(.clasprc.json)の作成と取り扱い注意点

clasp login に成功すると、一体パソコン内部では何が起きているのでしょうか。この裏側では、次回以降コマンドを打つたびに毎回ログイン画面を開かなくて済むよう、自動的に「アクセス許可証(トークン)」がファイルとして生成されています。

この認証情報が保存されるのが .clasprc.json という設定ファイルです。

  • 生成される保存場所
    .clasprc.json は、現在作業している個別のプロジェクトフォルダ内ではなく、お使いのパソコンの「ユーザーホームディレクトリ」(Windowsの場合は C:\Users\ユーザー名\.clasprc.json 、Macの場合は /Users/ユーザー名/.clasprc.json )に自動的に隠しファイルとして格納されます。

  • 役割と便利な仕組み
    このファイルの中に、Googleから発行された安全なアクセストークン(OAuth認証鍵)が記録されています。これにより、パソコン内のどのフォルダでターミナルを開いてclaspコマンドを実行しても、自動的にログイン状態が維持され、スムーズにGoogleクラウドと通信できるようになっています。

  • 取扱上の最重要セキュリティ注意点
    .clasprc.json には、あなたのGoogleアカウントのGASやGoogleドライブを操作できる極めて重要なアクセス権限情報が含まれています。そのため、このファイルを絶対に第三者に渡したり、GitHubなどの公開リポジトリへアップロードしたりしてはいけません。

ホームディレクトリに自動保存されるため、通常のプロジェクト管理で誤ってウェブ上へ公開してしまうリスクは低いですが、「認証情報が書かれた鍵ファイルがPC内に安全に保存されている」というセキュリティ意識はしっかりと持っておきましょう。

clasp create / clone によるプロジェクトの作成と取得

【パターンA】ローカルから新規GASプロジェクトを作成する: clasp create

認証連携が完了したら、いよいよVS CodeとGASプロジェクトを繋ぐ実際の操作を行います。まずは「手元のVS Codeから新しいGASプロジェクトを新規立ち上げする」パターン(clasp create)を解説します。

  1. 作業用フォルダの準備とVS Codeでの展開
    PC上の好きな場所(デスクトップや書類フォルダなど)に、今回の開発用フォルダ(例:my-gas-project)を作成します。VS Codeのメニューから「ファイル」→「フォルダを開く」を選択し、作成したフォルダを開きます。

  2. VS Codeのターミナルを起動する
    Ctrl + Shift + @(Macは Cmd + @)で内蔵ターミナルを開きます。プロンプトの末尾が、先ほど作成した作業用フォルダ名になっていることを確認してください。

  3. clasp create コマンドの実行
    ターミナルに以下のコマンドを入力して Enter キーを押します。

clasp create
  1. スクリプトタイプ(Script Type)の選択
    コマンドを実行すると、ターミナル上に「どのような種類のGASプロジェクトを作成しますか?」という対話型選択メニューが表示されます。

    • standalone(単体で動作するスクリプト)

    • docs(Googleドキュメントに紐づくスクリプト)

    • sheets(Googleスプレッドシートに紐づくスクリプト)

    • slides(Googleスライドに紐づくスクリプト)

    • forms(Googleフォームに紐づくスクリプト)

    • webapp(Webアプリケーション形式)

    • api(API形式)

    キーボードの上下矢印キー(↑ / ↓)でカーソルを動かし、今回は最も標準的な standalone または sheets に合わせて Enter キーを押します。

選択が完了すると処理が走り、Googleドライブ上に新しいGASプロジェクトが自動生成され、同時にローカルの作業フォルダに必要な初期設定ファイルがダウンロードされます。Googleドライブを開いて確認すると、指定した形式のGASファイルが新規作成されているはずです。

【パターンB】ブラウザ上の既存GASプロジェクトをローカルに持ってくる: clasp clone

続いて、もうひとつの重要なパターンである「すでにGoogleドライブ上に存在する既存のGASプロジェクトをローカルPCへ引き込む」パターン(clasp clone)を解説します。

  1. スクリプトID(Script ID)の確認とコピー
    ブラウザで対象の既存GASプロジェクト(Webエディタ)を開きます。
    左側メニューにある「歯車アイコン(プロジェクトの設定)」をクリックします。画面を少し下にスクロールすると「スクリプト ID」という項目があり、英数記号が入り混じった長い文字列(例:1A2b3C4d5E6f7G8h9I0j...)が表示されています。この文字列の横にある「コピー」ボタンを押してスクリプトIDを控えましょう。

  2. 空の作業フォルダをVS Codeで開く
    ローカルPC上に新しい空のフォルダを作成し、VS Codeでそのフォルダを開いた状態にします。

  3. clasp clone コマンドの実行
    VS Codeのターミナルを開き、先ほどコピーしたスクリプトIDを末尾に指定して、以下のコマンドを実行します。

clasp clone "ここにコピーしたスクリプトIDを貼り付け"
コマンドを実行するとGoogleサーバーとの通信が行われ、ブラウザ上のGASエディタ内に存在していたすべてのコードファイルが、ローカルの作業フォルダ内へ一括でダウンロードされます。

これで既存のプロジェクトをVS Codeで編集する準備が完了しました。

生成・取得されたファイル群の確認

clasp create または clasp clone を実行した直後、VS Codeの左側サイドバー(エクスプローラー領域)を確認してみましょう。作業フォルダの中に、いくつかのファイルが自動生成・配置されているのが分かります。

それぞれの役割と意味を整理しておきましょう。

  • .clasp.json(clasp設定ファイル)

    • 役割:ローカルのこのフォルダが、Googleクラウド上の「どのGASプロジェクト(スクリプトID)」と紐付いているかを記録した最重要ファイルです。

    • 内容:内部には {"scriptId":"..."} という形式でIDが記録されています。このファイルが存在することで、claspは迷わず正しい送信先へコードを同期できます。

  • appsscript.json(マニフェストファイル)

    • 役割:GASプロジェクト全体の動作環境や設定情報を管理するファイルです。

    • 内容:タイムゾーンの設定(Asia/Tokyo)、例外処理、ライブラリの依存関係などがJSON形式で記述されています。ブラウザ版のプロジェクト設定画面で行う基本設定がここに集約されています。

  • Code.js または .js / .ts ファイル

    • 役割:実際のプログラム処理を記述するコード本体ファイルです。

    • 内容:clasp create で作成した場合は、初期コードとして function myFunction() {} が記述されたファイルが生成されます。clone の場合はWebエディタ上にあったコードがそのまま再現されています。

これらのファイル群がローカルに揃ったことで、VS CodeとGASプロジェクトとの物理的なパイプラインがついに開通しました。

次回(第3回)は、このローカル上でコードを編集し、clasp push や clasp pull 、そしてリアルタイム全自動同期を行う clasp push --watch を駆使した実践的な開発ワークフローを完全マスターしていきます!
 

【初心者が陥りがちなトラブルとエラー対処】

claspを用いた環境構築やプロジェクト連携の過程では、開発者が最初によく遭遇する「お約束」とも言えるエラーやトラブルが存在します。しかし、原因と対処パターンさえ知っていれば、慌てる必要は一切ありません。ここでは、特に初心者が陥りがちな3つのトラブルとその明確な解決手順を解説します。

「User has not enabled the Apps Script API」エラーが出た場合

clasp create や clasp clone などのコマンドを実行した際、ターミナルに赤文字で User has not enabled the Apps Script API というエラーが表示されて処理が停止してしまうケースです。

  • 発生原因
    第3章で解説した「Google Apps Script API」のスイッチがGoogleアカウント側でONになっていないか、あるいはAPIを有効化したアカウントとは「別のアカウント」でログイン認証が行われていることが原因です。

  • 解決のための再確認チェックリスト

    1. ブラウザで Google Apps Script ユーザー設定ページ([script.google.com/home/usersettings](https://script.google.com/home/usersettings))へアクセスします。

    2. 画面右上のアイコンを確認し、現在claspで連携しようとしているGoogleアカウントと完全に一致しているか確かめます。

    3. 「Google Apps Script API」のトグルスイッチが「オン(青色)」になっていることを確認します。もし「オフ」になっていた場合はオンに切り替えます。

    4. 設定変更直後の場合は、Googleのサーバー側に反映されるまで1分ほど待ち、再度ターミナルでコマンドを実行します。

clasp login 時にブラウザが開かない、または認証エラーになる場合

clasp login を実行したものの、待てど暮らせどブラウザが自動起動しない、あるいはブラウザが開いても認証画面の途中でエラーになってしまう現象です。

  • 発生原因
    OSの既定のブラウザ設定が正しく登録されていないか、セキュリティソフトやブラウザのポップアップブロック機能、またはシークレットウィンドウ(インコグニトモード)のセッション干渉によって自動開く処理が阻害されていることが考えられます。

  • 代替手順と解決策

    • 手動コピー&ペーストによるログイン:clasp login コマンドを実行すると、ターミナル上に Logged in! You may close this page. というメッセージが出る前に、認証用の長文URL([https://accounts.google.com/o/oauth2/](https://accounts.google.com/o/oauth2/)...)が出力されています。このURLをマウスクリックまたはコピーし、普段お使いのブラウザのアドレスバーに直接貼り付けて移動してください。手動で開いても全く同じ認証フローを進めることができます。

    • 標準ブラウザの確認:ブラウザのシークレットモードや別プロファイルが開いている場合は一旦閉じ、通常ウィンドウでログイン操作を行ってください。

複数のGoogleアカウントを所有している場合の意図しないアカウント連携

プライベート用と仕事用など、日常的に複数のGoogleアカウントを切り替えて使っている環境で発生しやすいトラブルです。「Aアカウントで作業するつもりが、なぜかBアカウントのGoogleドライブにプロジェクトが作られてしまった」「権限エラーでクローンできない」といった症状が現れます。

  • 発生原因
    過去に clasp login を実行した際のアカウント情報(.clasprc.json)がPC内に残ったままになっており、意図しない別のアカウントの認証鍵で通信が行われていることが原因です。

  • 解決のためのログアウト&再ログイン手順

    1. VS Codeのターミナルで以下のログアウトコマンドを実行します。

      clasp logout
      
      これでPC内に保存されていた古い認証ファイル(.clasprc.json)が削除され、認証状態がリセットされます。

    2. ブラウザ側で、今回連携したい「正しいGoogleアカウント」だけにログインした状態(またはそのアカウントがメインになっている状態)を作ります。

    3. 再度ターミナルで clasp login を実行し、正しく対象のアカウントを選択して認証を完了させます。

おわりに / 次回予告

第2回の振り返り

お疲れ様でした!「第2回:Google公式ツール『clasp』の導入とGASプロジェクトの連携」の全工程が無事に完了しました。

第2回を通じて、みなさんは以下の実践的なステップをクリアし、大きな壁を乗り越えました。

  • Google公式のCLIツール「clasp」をnpm経由でグローバルインストールした

  • Googleアカウントのセキュリティ設定を変更し、「Google Apps Script API」を有効化させた

  • clasp login を実行し、OAuth認証を通じてVS CodeとGoogleアカウントを安全に接続した

  • clasp create(新規作成)および clasp clone(既存取得)をマスターし、ローカルのVS Code上にプロジェクト環境を構築した

手元のVS Codeで操作した内容が、クラウド上のGoogleドライブやGASプロジェクトと確かに繋がっているという感覚を掴んでいただけたのではないでしょうか。

次回予告

VS CodeとGoogleクラウドを結ぶパイプラインはこれで完璧に開通しました。次回からは、いよいよ実際にコードを書きながらローカル開発の爆速ワークフローを体感していく「実践編」に突入します!

次回のテーマは、「【第3回】VS CodeとGASをつなぐ!claspを使った実践的な同期ワークフロー」です。

  • ローカルプロジェクトの要となる設定ファイル(.clasp.json や appsscript.json)の正しい理解とカスタマイズ

  • VS Codeで書いたコードをGASへ一瞬で反映させる clasp push

  • ブラウザ側で変更されたコードをローカルへ手軽に引き込む clasp pull

  • ファイルを保存(Ctrl+S / Cmd+S)した瞬間に全自動でGASへ反映される神機能 clasp push --watch の活用法

もう二度とブラウザ版エディタへのコピペ作業には戻れなくなる、圧倒的にシームレスな開発テンポをお届けします。次回もぜひ楽しみにしていてください!
 

メインページフィード書き換え・2ページ目以降ページャー書き換え

いいね・シェアボタン

Share This Page!

前後ページのリンク表示