スクリプト プロジェクト

スクリプト プロジェクトは、Google Apps Script のファイルとリソースのコレクションを表します。単に「スクリプト」と呼ばれることもあります。スクリプト プロジェクトには、コードファイル(拡張子 .gs)または HTML ファイル(拡張子 .html)のいずれかである 1 つ以上のスクリプト ファイルがあります。JavaScript と CSS を HTML ファイルに含めることもできます。

スクリプト エディタでは、一度に開くことができるプロジェクトは 1 つだけです。複数のプロジェクトを複数のブラウザ ウィンドウまたはタブで開くことができます。

プロジェクトの作成と削除

このセクションでは、スタンドアロンまたはコンテナにバインドされた Apps Script プロジェクトを作成および削除する方法について説明します。

スタンドアロン プロジェクトを作成する

Apps Script からスタンドアロン プロジェクトを作成するには:

  1. script.google.com にアクセスします。
  2. [新しいプロジェクト] をクリックします。
  3. スクリプト エディタで、[無題のプロジェクト] をクリックします。
  4. プロジェクトに名前を付けて、[名前を変更する] をクリックします。

Google ドライブからスタンドアロン プロジェクトを作成する

  1. Google ドライブを開きます。
  2. [新規] > [その他] > [Google Apps Script] をクリックします。

Google ドキュメント、スプレッドシート、スライドからコンテナにバインドされたプロジェクトを作成する

  1. ドキュメントのドキュメント、スプレッドシートのスプレッドシート、スライドのプレゼンテーションを開きます。
  2. [拡張機能] > [Google Apps Script] をクリックします。
  3. スクリプト エディタで、[無題のプロジェクト] をクリックします。
  4. プロジェクトに名前を付けて、[名前を変更する] をクリックします。

Google フォームからコンテナにバインドされたプロジェクトを作成する

  1. Google フォームでフォームを開きます。
  2. その他アイコン > [スクリプト エディタ] をクリックします。
  3. スクリプト エディタで、[無題のプロジェクト] をクリックします。
  4. プロジェクトに名前を付けて、[名前を変更する] をクリックします。

clasp コマンドライン ツールを使用してスタンドアロン プロジェクトを作成する

clasp は、ターミナルから Apps Script プロジェクトの作成、pull/push、デプロイを可能にするコマンドライン ツールです。

詳細については、clasp を使用したコマンドライン インターフェース ガイドをご覧ください。

コンテナにバインドされたプロジェクトを削除する

  1. 上記の適切な方法でコンテナにバインドされたプロジェクトを開きます。
  2. 左上の [概要] をクリックします。
  3. 右上の削除アイコン > [完全に削除] をクリックします。

スタンドアロン プロジェクトを削除する

  1. script.google.com にアクセスします。
  2. 削除するプロジェクトの右側で、その他アイコン > [削除] > [削除] をクリックします。

プロジェクト内のファイルを管理する

ファイルを作成する

  1. Apps Script プロジェクトを開きます。
  2. 左側の [エディタ] > [追加] をクリックします。
  3. 作成するファイルの種類を選択し、名前を付けます。

ファイルを削除する

  1. Apps Script プロジェクトを開きます。
  2. 左側の [エディタ] をクリックします。
  3. 削除するファイルの横にあるその他アイコン > [削除] をクリックします。

Apps Script プロジェクトからファイルをエクスポートする

Apps Script からコードファイルを取得するには、各ファイルからコードをコピーして任意のテキスト エディタに貼り付けるか、コマンドラインで clasp を使用します。clasp を使用するには、スクリプト プロジェクトをダウンロードするをご覧ください。

プロジェクトのタイムゾーンを設定する

Apps Script プロジェクトのタイムゾーンを設定できます。スクリプトによって実行される関数はこのタイムゾーンを使用します。

  1. Apps Script プロジェクトを開きます。
  2. 左側の [プロジェクト設定] プロジェクト設定のアイコン をクリックします。
  3. [タイムゾーン] セクションで、使用するタイムゾーンを選択します。

特定の関数でスクリプト プロジェクトとは異なるタイムゾーンを使用する場合は、関数にタイムゾーンを明示的に入力します。たとえば、次のサンプルでは、各関数によって Google カレンダーに新しい予定が作成されます。最初の関数はデフォルトでプロジェクトのタイムゾーンになります。2 番目の関数で太平洋時間帯を指定しているため、プロジェクトのタイムゾーンに関係なく、イベントは太平洋時間でスケジュールされます。

function createEvent(){
// Creates an event in the script project's time zone and logs the ID
var event = CalendarApp.getDefaultCalendar().createEvent('New test event',
   new Date('December 20, 2022 17:00:00'),
   new Date('December 20, 2022 18:00:00'));
console.log('Event ID: ' + event.getId());
}
function createEventPacific(){
// Creates an event with a specified time zone and logs the event ID.
var event = CalendarApp.getDefaultCalendar().createEvent('New sample event',
   new Date('December 20, 2022 17:00:00 PDT'),
   new Date('December 20, 2022 18:00:00 PDT'));
console.log('Event ID: ' + event.getId());
}

複数の Google アカウントに関する問題を解決する

複数の Google アカウントに同時にログインしている場合、アドオンやウェブアプリにアクセスできないことがあります。マルチログイン(同時に複数の Google アカウントにログインしている状態のこと)は、Apps Script、アドオン、ウェブアプリではサポートされていません。

  • 複数のアカウントにログインしている状態でApps Script エディタを開いた場合、続行するアカウントを選択するよう求められます。

  • ウェブアプリまたはアドオンを開いたときにマルチログインの問題が発生する場合は、次のいずれかの解決方法をお試しください。

    • すべての Google アカウントからログアウトし、アクセスするアドオンまたはウェブアプリを含むアカウントにのみログインします。
    • Google Chrome のシークレット ウィンドウ、または同等のシークレット ブラウジング ウィンドウを開き、アクセスするアドオンまたはウェブアプリを含む Google アカウントにログインします。