Google Apps Script API では、目的に応じてさまざまな種類の承認が必要です。
- アプリで Apps Script API を使用する。
- 他のアプリケーションがスクリプト プロジェクトのデータやデプロイを管理できるようにする。
アプリケーションで Apps Script API を使用するには、アプリケーションの Google Cloud プロジェクトで API を有効にする必要があります。 これにより、アプリケーションのユーザーがアプリケーションを承認できるように、OAuth 認証情報を作成できます。
サードパーティ アプリケーションがスクリプト プロジェクトのコンテンツやデプロイを管理できるようにするには、スクリプト プロジェクトへのアクセス権を付与する必要があります。
アプリで Apps Script API を使用する
アプリ内で Apps Script API を使用するには、アプリケーションの Google Cloud プロジェクトで Apps Script API を有効にする必要があります。Apps Script API を有効にしたら、OAuth 認証情報を作成し、クライアント ID とシークレットをダウンロードしてアプリケーションに含めることができます。また、Google Cloud コンソールで API の使用状況を モニタリングすることもできます。
API 有効化ウィザードを使用すると、Google Cloud コンソールで Google Cloud プロジェクトを作成または選択し、API を自動的に有効にできます。または、コンソールの [リソースの管理] ページを開き、プロジェクトを選択してから、プロジェクトの [API とサービス] ダッシュボードを使用して Apps Script API を手動で検索して追加することもできます。API を有効にしたら、 アプリケーションの OAuth 認証情報、クライアント ID、クライアント シークレットを [API とサービス] > [認証情報] パネルで作成できます。
Apps Script API クイックスタート では、API を有効にして アプリケーションの承認を設定するプロセス全体をステップごとに説明しています。
サードパーティ アプリケーションにスクリプト プロジェクトへのアクセス権を付与する
Apps Script API を使用すると、アプリケーションで スクリプトとそのデプロイを作成、変更できます。悪意のあるサードパーティ アプリケーションを承認すると、悪意のあるスクリプトが作成されたり、既存のスクリプトの動作が変更されたりする可能性があります。
このリスクを軽減するため、Apps Script API はデフォルトではスクリプト プロジェクトにアクセスできません。スクリプトやデプロイを作成または変更するアプリケーションを使用するには、API アクセス権を明示的に付与する必要があります。スクリプトへの API アクセス権を付与すると、承認したアプリケーションは API を使用してスクリプト プロジェクトを管理できます。
API アクセス権を付与せずに影響を受けるアプリケーションを実行しようとすると、エラーが発生します。このエラーは、アプリケーションを承認した後に発生します。
Apps Script ダッシュボードを使用して、Apps Script API にスクリプトプロジェクトへのアクセス権を付与できます。また、このダッシュボードを使用して、このアクセス権をいつでも取り消すことができます。API アクセス権を付与すると、すべてのアプリケーションにアクセス権が付与されます。ただし、個々のアプリケーションは承認する必要があります。
アクセス権を付与する前に、アプリケーションがスクリプトを変更できるようにすることに伴うリスクを理解してください。悪意のあるアプリケーションであると思われるアプリケーションは絶対に承認しないでください。