デプロイの作成と管理

Apps Script プロジェクト デプロイは、ウェブアプリ、アドオン、または実行可能な API として使用可能なバージョンのスクリプトです。デプロイを作成して管理することで、コードの反復処理、変更の追跡、ユーザーがアクセスできる正確なコード バージョンの管理を行うことができます。

デプロイには次の 2 種類があります。

  • ヘッドデプロイ: 常に現在のプロジェクト コードに同期されます。
  • バージョニングされたデプロイ: 特定のプロジェクト バージョンに接続されます。

ヘッド デプロイ

ヘッドデプロイは現在のプロジェクト コードです。Apps Script プロジェクトを作成すると、そのプロジェクトのヘッド デプロイメントが自動的に作成されます。

ヘッドのデプロイは常に、最後に保存されたコードと同期されます。たとえば、バージョニングされたデプロイメントを作成してコードを変更すると、バージョニングされたデプロイメントはそのまま維持されますが、ヘッドデプロイメントにはそれらの変更が反映されます。

ヘッド デプロイを使用してコードをテストする。ヘッドデプロイを一般向けに使用しないでください。

バージョニングされたデプロイ

バージョニングされたデプロイでは、特定のバージョンのプロジェクト コードを利用できます。これにより、デベロッパーがコードの変更や改善を行っている間も、機能しているバージョンをユーザーが使い続けることができます。

アプリケーションを一般に公開する場合は、必ずバージョニングされたデプロイを使用してください。同時に複数のアクティブなバージョニングのデプロイを作成できます。

重要: バージョニングされたデプロイのオーナー権限は譲渡できません。スクリプト プロジェクトのオーナー権限を他のユーザーに譲渡しても、プロジェクト内の既存のバージョニングされたデプロイのオーナーは変更されません。管理者がデプロイ オーナーのアカウントを削除すると、デプロイでスクリプトエラーが発生する可能性があります。

バージョニングされた Deployment を作成する

Google Workspace アドオン、エディタ アドオン、Google Chat アプリ、または API 実行可能ファイルのいずれかのバージョンをデプロイするには、まず Apps Script の Google Cloud プロジェクトの関連付けをデフォルト プロジェクトから標準プロジェクトに切り替える必要があります。

バージョニングされたデプロイを作成する手順は次のとおりです。

  1. Apps Script プロジェクトを開きます。
  2. 右上の [デプロイ] > [新しいデプロイ] をクリックします。
  3. [タイプを選択] の横にある「デプロイタイプを有効にする」アイコン をクリックします。
  4. デプロイするデプロイタイプを選択します。Google Workspace アドオン、エディタのアドオン、Google Chat アプリの場合は、[アドオン] を選択します。
  5. デプロイメントに関する情報を入力し、[Deploy] をクリックします。

バージョニングされたデプロイを表示する

Apps Script プロジェクトのデプロイメントを表示するには、上部にある [Deploy] > [Manage deployments] をクリックします。

特定のバージョンのコードを表示するには、以前のバージョンを表示するをご覧ください。

バージョニングされたデプロイを編集する

バージョニングされたデプロイを編集して、説明やバージョンを変更できます。デプロイメントを編集するには、次の操作を行います。

  1. Apps Script プロジェクトを開きます。
  2. [デプロイ] > [デプロイの管理] をクリックします。
  3. 変更するアクティブなデプロイを選択し、編集アイコン をクリックします。
  4. 変更を加えて、[デプロイ] をクリックします。

    アーカイブされたデプロイを編集する場合は、再デプロイしてから上記の手順を行う必要があります。

    プロジェクト コードに変更をデプロイする場合は、新しいバージョンを作成し、デプロイを編集してそのバージョンを使用します。新しいバージョンは、そのデプロイメントを使用するすべてのユーザーによって自動的に使用されます。

デプロイメント ID を確認する

すべてのデプロイには、自動的に作成された、関連する文字列 ID があります。この ID を確認する手順は次のとおりです。

  1. Apps Script プロジェクトを開きます。
  2. 右上の [デプロイ] > [デプロイの管理] をクリックします。
  3. アクティブなデプロイを選択して、その ID を確認します。

    デプロイ ID はアクティブなデプロイにのみ表示されます。

デプロイをテストする

デプロイのテスト方法は、作成するアプリのタイプによって異なります。

Google Workspace アドオン

Google Workspace アドオンのデプロイをテストするには、 Google Workspace アドオンのテストをご覧ください。

エディタのアドオン

エディタ アドオンのデプロイをテストするには、エディタ アドオンをテストするをご覧ください。

ウェブアプリ

ウェブアプリのデプロイをテストするには、 ウェブアプリのデプロイをテストするをご覧ください。

Google Chat アプリ

Chat アプリのデプロイをテストするには、まずスクリプトの バージョニングされたデプロイを作成して、デプロイ ID にアクセスする必要があります。

デプロイ ID を取得したら、手順に沿って Google Chat API を有効にします。[Configuration] ページの [Permissions] で、メールアドレスのみを指定して、アプリをインストールしてテストできるようにします。

API 実行可能ファイル

API の実行可能なデプロイをテストするには、まず バージョニングされたデプロイを作成する必要があります。Deployment を作成したら、次の手順を行います。

  1. Apps Script プロジェクトの右上にある [デプロイ] > [デプロイをテスト] をクリックします。
  2. [Select type] の横にある [デプロイタイプを有効にする] > [API Executable] をクリックします。
  3. この URL をコピーして使用し、API 実行可能ファイルのデプロイをテストします。

バージョニングされたデプロイをアーカイブする

バージョニングされたデプロイは削除できません。代わりに、アーカイブできます。

バージョニングされたデプロイをアーカイブするには:

  1. Apps Script プロジェクトを開きます。
  2. [デプロイ] > [デプロイの管理] をクリックします。
  3. アーカイブするデプロイメントを選択し、アーカイブ デプロイメント をクリックします。

アーカイブされたデプロイメントを再デプロイする

  1. Apps Script プロジェクトを開きます。
  2. 右上の [デプロイ] > [デプロイの管理] をクリックします。
  3. 左側の [アーカイブ済み] で再デプロイするデプロイメントを選択し、編集アイコン > [デプロイ] をクリックします。