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