このページは Cloud Translation API によって翻訳されました。

認可スコープ

ユーザーは、自身のデータにアクセスする、またはユーザーの操作を行うスクリプトプロジェクトを承認する必要があります。できます。ユーザーが初めて認証を必要とするスクリプトを実行すると、UI に認証フローを開始するためのプロンプトが表示されます。

このフローの中で、UI はスクリプトが権限を求めているものをユーザーに知らせるできます。たとえば、スクリプトでユーザーの読み取り権限や、カレンダーの予定を作成したりできます。スクリプトプロジェクトこれらの個々の権限を OAuth スコープとして定義しています。

ほとんどのスクリプトの場合、必要なスコープが自動的に検出されます。スクリプトで使用されているスコープを表示できます。スコープを明示的に設定することもできます。マニフェスト内で URL 文字列を使用して指定します。設定特定のアプリケーションでは、明示的にスコープを指定する必要が生じる場合があります。アドオンなど、新しいアプリケーションを開発するための可能な限り狭いスコープを使用します

承認フローの際、Apps Script は、ユーザーに付与する必要があります。たとえば、スクリプトが読み取り専用権限が必要な場合は、マニフェストにそのスコープを https://www.googleapis.com/auth/spreadsheets.readonly。承認フローの際に、このスコープを持つスクリプトから、このアプリに「Google スプレッドシートの表示」を許可するようユーザーに求めるメッセージが表示されます。

一部のスコープには他のスコープが含まれます。たとえば、Compute Engine インスタンスで https://www.googleapis.com/auth/spreadsheets は、以下に対する読み取りと書き込みのアクセスを許可します。スプレッドシート。

スコープの表示

スクリプトプロジェクトに現在必要なスコープを確認するには、次のとおりです。

スクリプトプロジェクトを開きます。
左側の [概要] をクリックします。。
[Project OAuth Scopes]（プロジェクトの OAuth スコープ）でスコープを表示します。

明示的なスコープを設定する

Apps Script では、スクリプトに必要なスコープを自動的に決定必要な関数呼び出しがないかスキャンします。ほとんどのスクリプトで、十分で時間の節約になりますが、公開されているアドオンのウェブ Google Chat API 呼び出し、Google Chat アプリ、Google Chat API 呼び出しなど、スコープを直接制御できます。

Apps Script では、プロジェクトに非常に許可の範囲の広いスコープが自動的に割り当てられることがあります。これは、スクリプトがユーザーに必要以上のものを要求することを意味します。これは不適切です。実践していきます。公開されているスクリプトの場合、広範なスコープをスクリプトのニーズを満たせるだけに限定されます。

スクリプトプロジェクトで使用するスコープは、そのマニフェストファイルを実行します。マニフェストフィールド oauthScopes は、プロジェクトで使用されるすべてのスコープの配列です。設定方法作成するには、次の操作を行います。

スクリプトプロジェクトを開きます。
左側にある [プロジェクトの設定] をクリックします。
[「appsscript.json」マニフェストファイルをエディタで表示する] チェックボックスをオンにします。
左側の [エディタ] をクリックします。
左側の appsscript.json ファイルをクリックします。
oauthScopes というラベルの付いた最上位フィールドを見つけます。見当たらない場合は追加できます。
oauthScopes フィールドは、文字列の配列を指定します。プロジェクトで使用するスコープを設定するには、この配列の内容を、使用するスコープに置き換えます。次に例を示します。
```
      {
        ...
        "oauthScopes": [
          "https://www.googleapis.com/auth/spreadsheets.readonly",
          "https://www.googleapis.com/auth/userinfo.email"
        ],
       ...
      }
```
上部の保存アイコン（）をクリックします。

OAuth の確認

一部の OAuth スコープは、Google へのアクセスを許可するため、機密ユーザーデータ。スクリプトプロジェクトでユーザーデータへのアクセスを許可するスコープを使用している場合は、完了するまでは、 OAuth クライアントの確認ウェブアプリやウェブアプリとして一般公開する前に、アドオン。詳細については、次のガイドをご覧ください。

制限付きスコープ

機密性の高いスコープに加えて、特定のスコープが 制限付き ユーザーデータの保護に役立つ追加ルールが適用されます。想定している場合、 1 つ以上を使用するウェブアプリやアドオンを公開するアプリは、指定されたすべての制限に従わなければなりません。公開することはできません。

制限付きスコープの一覧を確認する確認することをおすすめしますアプリでこれらの API のいずれかを使用している場合は、公開前に特定の API スコープの追加要件に準拠する必要があります。