Apps Script プロジェクトのデプロイは、ウェブアプリ、アドオン、API 実行可能ファイルとして使用できるスクリプトのバージョンです。デプロイメントを作成して管理することで、コードを反復処理し、変更を追跡し、ユーザーがアクセスできるコードのバージョンを正確に制御できます。
デプロイには次の 2 種類があります。
- ヘッドデプロイ: 常に現在のプロジェクト コードと同期されます。
- バージョニングされたデプロイ: 特定のプロジェクト バージョンに接続されています。
ヘッドデプロイ
ヘッド デプロイは現在のプロジェクト コードです。Apps Script プロジェクトを作成すると、そのプロジェクトのヘッド デプロイメントが自動的に作成されます。
ヘッドデプロイは、最後に保存したコードと常に同期されています。たとえば、バージョニングされたデプロイを作成してからコードを変更すると、ヘッドデプロイに変更が反映されますが、バージョニングされたデプロイはそのままになります。
ヘッドデプロイを使用してコードをテストします。一般公開にはヘッドデプロイを使用しないでください。
バージョニングされたデプロイ
バージョニングされたデプロイでは、特定のバージョンのプロジェクト コードを使用できます。これにより、コードの変更や改善を行っている間も、ユーザーは機能するバージョンを引き続き使用できます。
アプリを一般公開する場合は、常にバージョニングされたデプロイメントを使用します。一度に複数の有効なバージョニングされたデプロイメントを設定できます。
重要: バージョニングされたデプロイメントのオーナー権限を移行することはできません。スクリプト プロジェクトの所有権を他のユーザーに移行しても、プロジェクト内の既存のバージョニングされたデプロイメントのオーナーは変更されません。管理者がデプロイメント所有者のアカウントを削除すると、デプロイメントでスクリプト エラーが発生することがあります。
バージョニングされた Deployment を作成する
Google Workspace アドオン、エディタ アドオン、Google Chat アプリ、API 実行可能ファイルのバージョンをデプロイするには、まず Apps Script の Google Cloud プロジェクトの関連付けをデフォルト プロジェクトから標準プロジェクトに切り替える必要があります。
バージョニングされた Deployment を作成する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 右上の [Deploy] > [New deployment] をクリックします。
- [種類の選択] の横にある [デプロイタイプを有効にする] をクリックします。
- デプロイするデプロイタイプを選択します。Google Workspace アドオン、Editor アドオン、Google Chat アプリの場合は、[アドオン] を選択します。
デプロイに関する情報を入力し、[デプロイ] をクリックします。
バージョニングされたデプロイメントを表示する
Apps Script プロジェクトのデプロイを表示するには、上部の [デプロイ] > [デプロイを管理] をクリックします。
特定のバージョンのコードを確認するには、以前のバージョンを表示するをご覧ください。
バージョニングされたデプロイメントを編集する
バージョニングされたデプロイメントを編集して、説明やバージョンを変更できます。Deployment を編集する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- [Deploy] > [Manage deployments] をクリックします。
- 変更するアクティブなデプロイメントを選択し、編集アイコン をクリックします。
変更を加えて、[デプロイ] をクリックします。
アーカイブされたデプロイメントを編集する場合は、デプロイを再デプロイしてから、上記の手順に沿って操作する必要があります。
プロジェクト コードに変更をデプロイする場合は、新しいバージョンを作成し、それを使用するようにデプロイを編集します。新しいバージョンは、そのデプロイメントを使用するすべてのユーザーによって自動的に使用されます。
デプロイ ID を確認する
すべてのデプロイメントには、自動的に作成される関連付けられた文字列 ID があります。この ID を確認する手順は次のとおりです。
- Apps Script プロジェクトを開きます。
- 右上の [Deploy] > [デプロイを管理] をクリックします。
アクティブなデプロイメントを選択して ID を確認します。
デプロイ ID は、アクティブなデプロイメントにのみ表示されます。
デプロイをテストする
デプロイのテスト方法は、ビルドするアプリの種類によって異なります。
Google Workspace アドオン
Google Workspace アドオンのデプロイをテストするには、 Google Workspace アドオンのテストをご覧ください。
編集者向けアドオン
エディタ アドオンのデプロイをテストするには、エディタ アドオンをテストするをご覧ください。
ウェブアプリ
ウェブアプリのデプロイをテストするには、 ウェブアプリのデプロイをテストするをご覧ください。
Google Chat アプリ
Chat アプリのデプロイをテストするには、まずスクリプトの バージョン付きデプロイを作成して、デプロイ ID にアクセスする必要があります。
デプロイ ID を取得したら、Chat API 構成で ID を指定し、手順に沿ってインタラクティブ機能をテストします。
API 実行可能ファイル
API 実行可能デプロイをテストするには、まず バージョニングされたデプロイを作成する必要があります。Deployment を作成したら、次の手順を行います。
- Apps Script プロジェクトの右上にある [デプロイ] > [デプロイをテスト] をクリックします。
- [種類の選択] の横にある [デプロイタイプを有効にする]
> API 実行可能ファイル をクリックします。
- URL をコピーして、API 実行可能ファイルのデプロイをテストします。
バージョニングされたデプロイメントをアーカイブする
バージョニングされたデプロイメントは削除できません。代わりに、アーカイブできます。
バージョニングされたデプロイをアーカイブするには:
- Apps Script プロジェクトを開きます。
- [Deploy] > [Manage deployments] をクリックします。
- アーカイブするデプロイメントを選択し、[デプロイメントをアーカイブ] をクリックします。
アーカイブされたデプロイメントを再デプロイする
- Apps Script プロジェクトを開きます。
- 右上の [Deploy] > [デプロイを管理] をクリックします。
- 左側の [アーカイブ済み] で、再デプロイするデプロイメントを選択し、編集アイコン > [デプロイ] をクリックします。