Google Apps Script プロジェクトのデプロイは、ウェブアプリ、Google Workspace アドオン、API 実行可能ファイルとして使用できるスクリプトのリリースです。 デプロイを作成して管理することで、コードを反復処理し、 ユーザーがアクセスするスクリプトバージョンを制御できます。
デプロイには次の 2 種類があります。
- ヘッド デプロイ。常に現在のプロジェクト コードに同期します。
- バージョン付きデプロイ。特定のプロジェクト バージョンに接続します。
ヘッドデプロイ
ヘッドデプロイは現在のプロジェクト コードです。Apps Script プロジェクトを作成すると、そのプロジェクトのヘッドデプロイが自動的に作成されます。
ヘッドデプロイは常に、最後に保存されたコードと同期されます。たとえば、バージョン付きデプロイを作成してからコードを変更すると、ヘッドデプロイにはその変更が反映されますが、バージョン付きデプロイはそのままになります。
ヘッドデプロイはコードのテストに使用します。ヘッドデプロイは一般公開用に使用しないでください。
Apps Script プロジェクトごとにヘッドデプロイは 1 つだけです。ヘッドデプロイを使用するには、スクリプト プロジェクトに対する読み取りアクセス権が必要です。
バージョン付きデプロイ
バージョン付きデプロイでは、プロジェクト コードの特定のバージョンを使用できます。 これにより、コードに変更や改善を加えながら、ユーザーは引き続き機能するバージョンを使用できます。
一般公開用のアプリケーションを公開する場合は、必ずバージョン付きデプロイを使用してください。複数のアクティブなバージョン付きデプロイを同時に使用できます。
重要: バージョン付きデプロイの所有権を譲渡することはできません。スクリプト プロジェクトの所有権を譲渡しても、既存のバージョン付きデプロイの所有者は変更されません。管理者がデプロイの所有者のアカウントを削除すると、デプロイでスクリプト エラーが発生する可能性があります。
デプロイとバージョンの違い
Apps Script では、 バージョンと デプロイは異なる概念です。
- バージョン: スクリプト プロジェクトのコードの静的なスナップショット。一度作成されたバージョンは変更できません。バージョンは、開発履歴の「保存ポイント」と考えることができます。
- デプロイ: スクリプトの特定のバージョンをユーザーが使用できるようにするリリース。デプロイには一意の URL または ID があります。
既存のデプロイ（ウェブ アプリなど）で使用されているコードを更新する場合は、新しいバージョンを作成し、その新しいバージョンを参照するようにデプロイを 編集します。これにより、URL またはデプロイ ID を維持しながら、すべてのユーザーのアプリケーションが更新されます。
バージョン付きデプロイを作成する
アドオン、 エディタ アドオン、Chat アプリ、API 実行可能ファイルのバージョンをデプロイするには、まず Apps Script の Google Cloud プロジェクトの関連付けをデフォルト プロジェクトから標準 プロジェクトに切り替える必要があります。
バージョン付きデプロイを作成するには:
- Apps Script プロジェクトを開きます。
- 右上の [デプロイ] > [新しいデプロイ] をクリックします。
- [種類の選択] の隣にある [デプロイタイプを有効にする] をクリックします。
- デプロイするデプロイタイプを選択します。Google Workspace アドオン、エディタ アドオン、Google Chat アプリの場合は、[**アドオン**] を選択します。
- デプロイに関する情報を入力して、[デプロイ] をクリックします。
新しいデプロイはライブラリとして共有できます。スクリプトをライブラリとして共有すると、デプロイの説明がライブラリ ユーザーに表示されます。
バージョン付きデプロイを表示する
Apps Script プロジェクトのデプロイを表示するには、上部の [デプロイ] > [デプロイを管理] をクリックします。
特定のバージョンのコードを表示するには、 以前のバージョンを表示するをご覧ください。
バージョン付きデプロイを編集する
バージョン付きデプロイを編集して、説明やバージョンを変更できます。デプロイを編集するには:
- Apps Script プロジェクトを開きます。
- [Deploy] > [デプロイを管理] をクリックします。
- アクティブなデプロイを選択して、[Edit] をクリックします。
- 変更を加えて [デプロイ] をクリックします。
アーカイブされたデプロイを編集するには、再デプロイしてから上記の手順を行います。
プロジェクト コードに変更をデプロイするには、新しいバージョン を作成し、それを使用するようにデプロイを編集します。これは、URL やデプロイ ID を変更せずにアプリケーションを更新する標準的な方法です。デプロイでは、すべてのユーザーに対して新しいバージョンが自動的に使用されます。
デプロイ ID を確認する
すべてのデプロイには、関連付けられた文字列 ID があります。この ID を確認するには:
- Apps Script プロジェクトを開きます。
- 右上の [Deploy] > [Manage deployments] をクリックします。
- アクティブなデプロイを選択して、その ID を確認します。
デプロイ ID は、アクティブなデプロイにのみ表示されます。
デプロイをテストする
デプロイをテストする方法は、作成するアプリの種類によって異なります。
Google Workspace アドオン
アドオンのデプロイをテストするには、 アドオンをテストするをご覧ください。
エディタ アドオン
エディタ アドオンのデプロイをテストするには、 エディタ アドオンをテストするをご覧ください。
ウェブアプリ
ウェブアプリのデプロイをテストするには、 ウェブアプリのデプロイをテストするをご覧ください。
Google Chat アプリ
Chat アプリのデプロイをテストするには、 スクリプトのバージョン付きデプロイを作成して、そのデプロイ ID にアクセスします。
デプロイ ID を取得したら、 Chat API 構成 で ID を指定し、手順に沿って インタラクティブ機能 をテストします。
実行可能 API
API 実行可能ファイルのデプロイをテストするには、 バージョン付きデプロイを作成します。デプロイを作成したら、次の手順を行います。
- Apps Script プロジェクトの右上にある [デプロイ > デプロイをテスト] をクリックします。
- [種類の選択] の横にある
> [実行可能 API] をクリックします。 - URL をコピーして使用し、API 実行可能ファイルのデプロイをテストします。
バージョン付きデプロイをアーカイブする
デプロイのレコードからバージョン付きデプロイを削除することはできません。 代わりに、アーカイブできます。
バージョン付きデプロイをアーカイブするには:
- Apps Script プロジェクトを開きます。
- [Deploy] > [デプロイを管理] をクリックします。
- デプロイを選択して、[Archive deployment] をクリックします。
プロジェクト履歴からバージョンを削除する
バージョン付きデプロイを削除することはできませんが、使用しているスクリプト バージョンをプロジェクト履歴から削除することはできます。バージョンを削除するには、アクティブなデプロイで使用されていない必要があります。
バージョンを削除するには、 バージョンを削除するをご覧ください。
アーカイブされたデプロイを再デプロイする
- Apps Script プロジェクトを開きます。
- 右上の [Deploy] > [Manage deployments] をクリックします。
- [アーカイブ済み] でデプロイを選択し、[編集] > [デプロイ] をクリックします。