どの Apps Script プロジェクトでも Google Cloud を使用して、認可、 拡張サービスなどの詳細を確認できます。 これらの設定を構成、管理するために、すべての Apps Script プロジェクトに 関連付けられている Google Cloud プロジェクト。 スクリプト プロジェクトでは、 Apps Script がデフォルト プロジェクトです。 自動的に作成される場合や、 作成する標準プロジェクト できます。通常、デフォルト プロジェクトは日常的なスクリプトやシンプルなスクリプトに適していますが、複雑なアプリケーション、商用品質のアプリケーション、公開を予定しているアプリケーションには、標準プロジェクトを使用する必要があります。
デフォルト プロジェクトから標準プロジェクトに切り替えることはいつでもできますが、デフォルト プロジェクトに戻すことはできません。最高 を使用して、開発の早い段階でスクリプトで使用する Cloud プロジェクトを選択します。 後から切り替えると、ユーザーが 再承認する必要があります。
デフォルトの Cloud プロジェクト
Apps Script プロジェクトを作成すると、Apps Script はデフォルトの バックグラウンドで動作する Cloud プロジェクトです。
- ほとんどのスクリプトでは、このデフォルト プロジェクトを表示または調整する必要はありません。アプリ スクリプトは、Google Cloud と必要なやり取りを処理します。たとえば Apps Script エディタで拡張サービスを有効にします。 デフォルトの Cloud プロジェクトで拡張サービスが有効になり、 スクリプト プロジェクトを保存します。
- スクリプトによっては、Google Cloud コンソールを操作する必要があります。対象 標準の Cloud プロジェクトを使用する必要があります。対象 たとえば、Google Cloud コンソールで Google Cloud のログを表示するには、スクリプトで 作成します。
デフォルトでは、Cloud プロジェクトには Identity and Access Management
(IAM)ポリシーが 1 つのエントリを持つものは、サービス アカウントの所有者として機能する
プロジェクトを作成します。Google サービス アカウントは
appsdev-apps-dev-script-auth@system.gserviceaccount.com
。
デフォルトの Cloud プロジェクトを表示または更新する
ほとんどのユーザーは、デフォルト プロジェクトの検索、表示、編集を Google Cloud コンソール。管理者の方は、デフォルトの Google Cloud プロジェクトを表示するをご覧ください。
2019 年 4 月 8 日より前にスクリプト プロジェクトを作成した場合は、 Google Cloud コンソールでアクセスできます。アクセスするには、 スクリプト プロジェクトの設定に移動し、 あります。
デフォルトの Cloud プロジェクトを削除する
管理者は、デフォルトの Cloud プロジェクトを通常どおりに削除できます 標準のクラウド プロジェクト。Apps Script Cloud プロジェクトを削除するをご覧ください。
管理者以外のユーザーは、デフォルトのプロジェクトを削除できません。ただし、次のシナリオでは Apps Script でデフォルトのプロジェクトが削除されます。
- スクリプト プロジェクトを削除するか標準プロジェクトに切り替えると、 スクリプトは、アタッチされているデフォルトのプロジェクトと一緒に、すべてのプロジェクトも削除します。 設定やその情報のことです。
- スクリプトの実行が 180 日以上続くと、Apps Script は 関連付けられているデフォルト プロジェクトが削除されます。スクリプトが Apps Script ではデフォルトのプロジェクトが削除され、Apps Script はそのデフォルトのプロジェクトを作成します。 使用します。
標準の Cloud プロジェクト
ほとんどのスクリプト プロジェクトには、デフォルトの Cloud プロジェクトが最適なオプションですが、 プロジェクトを手動で構成する必要がない場合です。 このような場合は、 スクリプト プロジェクトを切り替えて標準プロジェクトを使用します。
以下のセクションでは、Apps Script で標準プロジェクト、 一般的なタスクなどを確認できます。使用できるのは、 標準プロジェクトで次のタスクを実行できます。
Apps Script が標準の Cloud プロジェクトを必要とする場合
次の状況では、標準プロジェクトを使用する必要があります。
- スクリプト プロジェクトを アドオン (Google Workspace Marketplace)をご覧ください。
- スクリプト プロジェクトの OAuth クライアントを確認する。
- Google Cloud 内で関数を実行する必要があるアプリケーションが
スクリプト プロジェクトを使用して
Apps Script API の
scripts.run
メソッド。 - スクリプト プロジェクトの Google Cloud ログ Google Cloud コンソール。Google Cloud コンソールには、ログのフィルタリングと表示に使用できるツールがさらに用意されており、Apps Script ダッシュボードで提供される簡素化されたビューよりも便利です。
- スクリプト プロジェクトのエラーレポートを表示するには、 Error Reporting。
- ファイルを開くダイアログを作成するには、
- そうでなければ、プロジェクトのリソースを手動で制御する必要がある場合、 Google Cloud の設定。
標準の Cloud プロジェクトのプロパティ
標準プロジェクトには次のプロパティがあります。
- プロジェクトのすべての Google Cloud 設定に直接アクセスできます Google Cloud コンソールから使用できます。これにより、API を有効にしたり、認可認証情報を調整したり、その他の詳細を構成したりできます。
- スクリプト プロジェクトを削除するか、 別の標準プロジェクトを使用すると、元の標準プロジェクトが維持され、 されます。
- 拡張サービスを有効にした場合 スクリプト プロジェクト内で、対応する API を手動で有効にする必要があります。 できます。
- 複数のスクリプト プロジェクトや他のアプリで同じものを共有可能 できます。スクリプト プロジェクトを公開する場合 宛先: Google Workspace Marketplace アドオンとして 独自の標準プロジェクトが必要です公開済みのアプリは共有できません 他のアプリと連携できます。
- スクリプト プロジェクトで別のアプリから関数を実行する場合は、
Apps Script API の
scripts.run
メソッド スクリプト プロジェクトと呼び出し元アプリケーションは同じ標準を共有する必要がある できます。 - Apps Script で標準プロジェクトを使用するスクリプトの承認を求められた場合は、スクリプト(スクリプト プロジェクト名ではなく)を識別するために Cloud プロジェクト名が使用されます。このため、Terraform で定義されるデータ型に Cloud プロジェクト名。
標準の Cloud プロジェクトにアクセスする
スクリプトに関連付けられた標準のプロジェクトにアクセスする 次の操作を行います。
- Apps Script プロジェクトを開きます。
- 左側にある [プロジェクトの設定] をクリックします。
- [Google Cloud Platform(GCP)プロジェクト] で、プロジェクト番号をクリックします。
標準プロジェクトは、Google Cloud コンソールの [リソースの管理] ページで直接確認することもできます。
標準の Cloud プロジェクトで API を有効にする
多くの場合、Apps Script アプリケーションは別の Google API にアクセスする必要があります。これを行うには、対応する Cloud プロジェクトで API を有効にする必要があります。API を有効にするには、次の操作を行います。
- Cloud プロジェクトを開きます。
- メニュー > [API とサービス] をクリックします。
- [API とサービスの有効化] をクリックします。
- 有効にする API を検索ボックスに入力し、Enter キーを押します。
- 検索結果から API をクリックし、[有効にする] をクリックして有効にします。 この Cloud プロジェクトの API です。
場合、利用規約への同意を求められる場合があります。 Google API Google Cloud。利用規約を確認します 慎重に行ってください。
アプリケーションによっては、API の構成が必要になることもあります。 [API とサービス ダッシュボードで確認できます。
ID を確認し、Google Cloud プロジェクトの数と
すべての Cloud プロジェクトには、プロジェクト名、プロジェクト ID、プロジェクト番号があります。 場合によっては、こうした識別子を用意して サービスの構成などのタスクを実行できます。
標準プロジェクトの ID と番号を確認する手順は次のとおりです。
- Cloud プロジェクトを開きます。
- 右上のその他アイコン > [プロジェクト設定] をクリックします。 をクリックします。
- プロジェクト名、プロジェクト ID、プロジェクト番号を表示します。 (結果の [Settings] パネル)をクリックします。プロジェクト番号は次の情報のみで構成されます。 数字で、プロジェクト ID は英数字です。必要に応じて プロジェクト名。認証プロンプトでユーザーに表示されます。
Google Cloud のログとGoogle Cloud コンソールのエラーレポート
Google Cloud Logging を使用している場合 Error Reporting スクリプト プロジェクトのログとレポートを確認するには、 Google Cloud コンソールで次の操作を行います。
- Cloud プロジェクトを開きます。
- メニュー をクリックします。
- [Operations] セクションまで下にスクロールします。 [ロギング] > [ログ エクスプローラ] をクリックします。
- エラーレポートを表示するには、[オペレーション] セクションまで下にスクロールします。 [Error Reporting] をクリックします。共有を求めるメッセージが これはスクリプトプロジェクトがまだ定義されていない場合に 例外がログに記録されました
OAuth 同意画面を完成させる
OAuth を必要とするサービスを使用している場合、Google はユーザーにそれらのサービスを承認するよう求める 提供します。OAuth 同意画面の設定では、同意画面の設定を使用して、 ユーザー インターフェースには、 アプリケーション名と利用規約の URL を入力します。
デフォルトの Cloud プロジェクトでは、デフォルト画面から自動的に Apps Script プロジェクトの詳細これらの設定を調整することはできません 標準の Cloud プロジェクトでは この情報をカスタマイズできますスクリプトの同意ステータスは 次のとおりです。
- Cloud プロジェクトを開きます。
- メニュー > API とサービス > [認証情報] をタップします。 をクリックします。
- [同意画面を構成] をクリックします。
- 同意画面ワークフローの各セクションに入力します。
- ワークフローの各段階で変更を記録するには、 [保存して次へ] をクリックします。
OAuth 認証情報を作成する
Apps Script は通常、サービス用に OAuth を設定します。 表示されます。アプリケーションによっては、追加の認証情報を OAuth 認証情報(クライアント ID とクライアント シークレット)。この操作は、 できます。
スクリプト プロジェクトのクライアント ID とクライアント シークレットを作成するには、次の操作を行います。 次のとおりです。
- Cloud プロジェクトを開きます。
- メニュー > API とサービス > [認証情報] をタップします。 をクリックします。
- [認証情報を作成] > をクリックします。 OAuth クライアント ID。
- [アプリケーションの種類] でアプリケーションの種類を選択し、 必要に応じて、結果のフォームに入力します。完了したら、[作成] をクリックします。
- 表示されたダイアログで、[JSON をダウンロード] をクリックします。Google Chat では このファイルを使用して OAuth を構成します。
標準の Cloud プロジェクトにオーナーを追加する
標準プロジェクトには、オーナーや他のロールを追加できます。 プロジェクトで共同作業を行っている場合は、 スクリプト プロジェクトの Google Cloud 設定に常にアクセスできる。
標準プロジェクトにオーナーや他のロールを追加するには、次の操作を行います。 できます。次の変更を行うには、プロジェクトの編集権限が必要です。
- 共同編集者を指定する。新しい P-MAX キャンペーンを 既存の Google グループを作成することも、既存の Google グループを使用することもできます。コラボレータ リストでドメインを指定して、そのドメイン内のすべてのユーザーを含めることもできます。
- スクリプトの Cloud プロジェクトを開きます。
- メニュー > IAM と管理 > [IAM] を選択します。 をクリックします。
- 上部の [追加] をクリックします。
- 画面上の手順に沿って、1 人以上の新しいメンバーとそのロールを Cloud プロジェクトに追加します。個々のメールアドレス、Google グループ、または ドメインの所有権を証明します。
- [保存] をクリックします。
複数のスクリプトを 1 つの Cloud プロジェクトにまとめる
複数の Apps Script プロジェクトで同じ標準を共有可能 できます。これを行うには、標準プロジェクトを作成し、各スクリプト プロジェクトを切り替えて使用します。デフォルト プロジェクトではこの操作はできません。
別の標準 Cloud プロジェクトを使用する
別の標準 Cloud プロジェクトを使用するようにスクリプト プロジェクトを切り替えることができます。スクリプトで Cloud プロジェクトを手動で構成する必要がある場合は、デフォルト プロジェクトから標準プロジェクトに切り替える必要があります。標準プロジェクトを使用する必要がある場合の詳細については、標準の Cloud プロジェクトをご覧ください。
別の標準 Cloud プロジェクトに切り替えた場合の影響
スクリプトをデフォルト プロジェクトから別の標準プロジェクトに切り替えると、次のような影響があります。
- スクリプトで拡張サービスを有効にした場合は、 対応する API を プロジェクトが作成されます。高度なセキュリティ設定に関連付けられた 作成しました。API を有効にする方法については、 Google Workspace API を有効にするをご覧ください。
- スクリプトで組み込みの Google ドライブ サービスを使用する場合は、
標準の Cloud プロジェクトで Drive API を使用できます。
標準の Cloud プロジェクトで、Drive API を有効にします。
- 以前にスクリプトを承認したすべてのユーザーは、再度承認する必要があります。イン ほとんどの場合、以前に承認されたアプリを 再承認する必要があります。
- スクリプトが Google Workspace Marketplace のアプリの掲載情報に関連付けられている場合、アプリの掲載情報、ユーザー、レビューは、 作成します。新しいプロジェクト内にアプリの掲載情報を作成し、 ユーザーがアプリを再インストールする必要があります。Google Cloud コンソールで アプリを公開するをご覧ください。
- スクリプトをデフォルトのプロジェクトに戻すことはできません。Apps Script の削除 標準のプロジェクトを使用するようにスクリプトを設定した後、デフォルトのプロジェクトが作成されます。
別の標準の Cloud プロジェクトに切り替える
スクリプトの既存の Cloud プロジェクトを別のプロジェクトに切り替える 次の操作を行います。
- 適切な Cloud プロジェクトがない場合は、 プロジェクトの作成の手順に沿って操作してください。 できます。覚えやすいプロジェクト名を設定して、 Google Cloud コンソールの [リソースの管理] ページで見つけます。Apps Script は次の場合にこの名前を使用します。 ユーザーにスクリプトの承認を求めます。
- 既存のプロジェクトを使用する場合は、Google Cloud コンソールの [リソースの管理] ページを開きます。 使用する既存のプロジェクトを見つけます。以下が必要です。 プロジェクト ブラウザと OAuth 構成編集者のロール、または同等のロールを持つロール 権限、 できます。Apps によって自動的に作成されたプロジェクトは使用できません スクリプト。
- Cloud プロジェクトのプロジェクト番号を確認します。
- 置き換える Cloud プロジェクトがあるスクリプトを開きます。
- 左側の [プロジェクトの設定] をクリックします。 。
- [Google Cloud Platform(GCP)プロジェクト] で、[プロジェクトを変更] をクリックします。
- 新しいプロジェクト番号を入力し、[プロジェクトを設定] をクリックします。
Cloud プロジェクトと共有ドライブ
共有ドライブ(旧「チームドライブ」)を使用すると、 ドライブ ユーザーのグループが Apps Script で共同編集できる共有スペース 作成することもできます。共有ドライブは スクリプト、アドオン、ウェブアプリをチームで使用することはできますが、 古いデフォルトの Cloud プロジェクトで何ができるかを見ていきましょう。
次の制限事項のリストは、Cloud プロジェクトが共有ドライブとやり取りする方法を示しています。
- スクリプト プロジェクトが標準プロジェクトを使用している場合、 スクリプト プロジェクトが共有ドライブ内にある場合は、追加の制限が適用されます。
- スクリプト プロジェクトが、または 2019 年 4 月 8 日以降、スクリプトが 共有ドライブに配置されます。
- スクリプト プロジェクトが、以前に作成したデフォルトのプロジェクトを使用している場合
2019 年 4 月 8 日以降、スクリプトの実行中は以下の制限が適用されます。
共有ドライブに配置されます。
- Apps Script UI または Google Cloud コンソールこの制限により、 プロジェクトに直接アクセスする必要があるアクション。
- 拡張サービスを有効にすることはできません。 拡張サービスを有効にするには、標準モードに切り替えてください できます。
- 既存の Apps Script プロジェクトを共有ドライブに移動すると、 デフォルトの Cloud プロジェクトへのアクセスを制限します。引き続き 移行前にアクセス権を持っていれば、デフォルトのプロジェクトにもアクセスできます。対象 例: マイドライブ フォルダにスクリプトを作成して移動した場合 共有ドライブにコピーしても、スクリプトの できます。共有ドライブ内の共同編集者はアクセスできない可能性があります。
- スクリプトは、共有ドライブに移動する前の Cloud プロジェクト名を保持します。共有ドライブでプロジェクト名を変更しても、スクリプトを承認するユーザーには、承認ダイアログに古い名前が表示されます。
古いスクリプトに対して上記の制限を回避するには、標準プロジェクトに切り替えることをおすすめします。
Apps Script Cloud プロジェクトのリストを取得する
組織の Apps Script プロジェクト フォルダに対する resourcemanager.projects.list
権限が付与されている場合、フォルダ内の標準の Apps Script Cloud プロジェクトとデフォルトの Apps Script Cloud プロジェクトをすべて表示できます。
- Google Cloud コンソールの [リソースの管理] ページを開きます。
- Apps Script フォルダの横で、ID をコピーします。
- [フィルタ] > [親 ID] をクリックし、Apps Script フォルダ ID を貼り付けます。
Apps Script Cloud プロジェクトを削除する
Apps Script Cloud プロジェクトを削除するには、 Apps Script Cloud プロジェクトのリスト、 削除するプロジェクトを選択して [ 削除。
gcloud
を使用して Apps Script プロジェクトを削除するには、次のように記述します。
使用できます。
gcloud projects list --filter='parent.id=APPS_SCRIPT_FOLDER_ID'
gcloud projects delete PROJECT_ID
Cloud プロジェクトの削除について詳しくは、シャットダウン (削除)するをご覧ください。