OAuth 同意画面を設定し、スコープを選択する

認可に OAuth 2.0 を使用すると、プロジェクトの概要、ポリシー、リクエストされたアクセスの認可スコープを含む同意画面がユーザーに表示されます。アプリの OAuth 同意画面を構成すると、ユーザーとアプリ審査担当者に表示される内容を定義し、後で公開できるようにアプリを登録します。

アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは OAuth 2.0 URI 文字列で、Google Workspace アプリ名、アプリがアクセスするデータの種類、アクセスレベルが含まれます。スコープは、ユーザーの Google アカウントのデータなど、Google Workspace のデータを操作するアプリからのリクエストです。

アプリのインストール時に、アプリで使用されているスコープを検証するよう求められます。一般的には、できる限り範囲を絞り込んだスコープを選択し、アプリが必要としないスコープをリクエストしないようにする必要があります。ユーザーが明確に説明された制限付きのスコープに対してより簡単にアクセス権を付与できます。

OAuth 2.0 を使用するすべてのアプリには同意画面の構成が必要ですが、リストする必要があるのは、Google Workspace 組織外のユーザーが使用するアプリのスコープのみです。

ヒント: 必須の同意画面の情報がわからない場合は、リリース前にプレースホルダ情報を使用できます。

  1. Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。

    OAuth 同意画面に移動

  2. アプリのユーザータイプを選択し、[作成] をクリックします。
  3. アプリ登録フォームに入力し、[保存して次へ] をクリックします。
  4. Google Workspace 組織の外部で使用するアプリを作成する場合は、[スコープの追加と削除] をクリックします。スコープを選択する際は、次のベスト プラクティスをおすすめします。

    • アプリで必要最小限のアクセスレベルを提供するスコープを選択します。使用可能なスコープのリストについては、Google API の OAuth 2.0 スコープをご覧ください。
    • 3 つのセクション(機密でないスコープ、機密性の高いスコープ、制限付きスコープ)のそれぞれに一覧表示されているスコープを確認します。「機密性の高いスコープ」または「制限付きのスコープ」のセクションに記載されているスコープについては、不要な追加の審査を避けるため、機密性のない別のスコープを特定してください。
    • 一部のスコープには Google による追加審査が必要です。Google Workspace 組織が内部でのみ使用するアプリの場合、スコープは同意画面に表示されず、制限付きスコープや機密性の高いスコープの使用について、Google による詳しい審査は不要です。詳細については、スコープのカテゴリをご覧ください。
  5. アプリに必要なスコープを選択したら、[Save and Continue] をクリックします。
  6. ユーザーの種類に [外部] を選択した場合は、テストユーザーを追加します。
    1. [テストユーザー] で [ユーザーを追加] をクリックします。
    2. メールアドレスとその他の承認済みテストユーザーを入力し、[保存して次へ] をクリックします。
  7. アプリ登録の概要を確認します。変更するには、[Edit] をクリックします。アプリの登録に問題がなければ、[Back to Dashboard] をクリックします。

スコープのカテゴリ

一部のスコープでは、付与するアクセス権のレベルまたはタイプのために、追加の審査と要件が必要になります。次のタイプのスコープについて考えてみましょう。

      基本的なアプリの確認が必要 追加のアプリ確認が必要 セキュリティ評価が必要
  非機密スコープ (推奨) 特定のアクションに直接関連する限定データにのみアクセスを許可する。
機密性の高いスコープ ユーザーの個人のデータ、リソース、アクションへのアクセス権を付与します。
制限付きのスコープ 機密性の高いユーザーや広範なユーザーデータまたはアクションへのアクセス権を付与する。

次のステップ

アプリのアクセス認証情報を作成します。