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

認証スコープ

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

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

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

承認フローの際、Apps Script は、ユーザーに付与する必要があります。たとえば、スクリプトが読み取り専用権限が必要な場合は、マニフェストにそのスコープを https://www.googleapis.com/auth/spreadsheets.readonly。実施中このスコープのスクリプトは、この API 呼び出しを 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 スコープの追加要件をご確認ください。