認可に OAuth 2.0 を使用すると、プロジェクトの概要、ポリシー、リクエストされたアクセスの認可スコープを含む同意画面がユーザーに表示されます。アプリの OAuth 同意画面を構成すると、ユーザーとアプリ審査担当者に表示される内容を定義し、後で公開できるようにアプリを登録します。
アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは OAuth 2.0 URI 文字列で、Google Workspace アプリ名、アプリがアクセスするデータの種類、アクセスレベルが含まれます。スコープは、ユーザーの Google アカウントのデータなど、Google Workspace のデータを操作するアプリからのリクエストです。
アプリのインストール時に、アプリで使用されているスコープを検証するよう求められます。一般的には、できる限り範囲を絞り込んだスコープを選択し、アプリが必要としないスコープをリクエストしないようにする必要があります。ユーザーが明確に説明された制限付きのスコープに対してより簡単にアクセス権を付与できます。
OAuth 2.0 を使用するすべてのアプリには同意画面の構成が必要ですが、リストする必要があるのは、Google Workspace 組織外のユーザーが使用するアプリのスコープのみです。
ヒント: 必須の同意画面の情報がわからない場合は、リリース前にプレースホルダ情報を使用できます。
OAuth 同意を構成する
- Google Cloud コンソールで、メニュー > [API とサービス] > [OAuth 同意画面] に移動します。
- アプリのユーザータイプを選択し、[作成] をクリックします。
- アプリ登録フォームに入力し、[保存して次へ] をクリックします。
Google Workspace 組織の外部で使用するアプリを作成する場合は、[スコープの追加と削除] をクリックします。スコープを選択する際は、次のベスト プラクティスをおすすめします。
- アプリで必要最小限のアクセスレベルを提供するスコープを選択します。使用可能なスコープのリストについては、Google API の OAuth 2.0 スコープをご覧ください。
- 3 つのセクション(機密でないスコープ、機密性の高いスコープ、制限付きスコープ)のそれぞれに一覧表示されているスコープを確認します。「機密性の高いスコープ」または「制限付きのスコープ」のセクションに記載されているスコープについては、不要な追加の審査を避けるため、機密性のない別のスコープを特定してください。
- 一部のスコープには Google による追加審査が必要です。Google Workspace 組織が内部でのみ使用するアプリの場合、スコープは同意画面に表示されず、制限付きスコープや機密性の高いスコープの使用について、Google による詳しい審査は不要です。詳細については、スコープのカテゴリをご覧ください。
- アプリに必要なスコープを選択したら、[Save and Continue] をクリックします。
- ユーザーの種類に [外部] を選択した場合は、テストユーザーを追加します。
- [テストユーザー] で [ユーザーを追加] をクリックします。
- メールアドレスとその他の承認済みテストユーザーを入力し、[保存して次へ] をクリックします。
- アプリ登録の概要を確認します。変更するには、[Edit] をクリックします。アプリの登録に問題がなければ、[Back to Dashboard] をクリックします。
スコープのカテゴリ
一部のスコープでは、付与するアクセス権のレベルまたはタイプのために、追加の審査と要件が必要になります。次のタイプのスコープについて考えてみましょう。
基本的なアプリの確認が必要 | 追加のアプリ確認が必要 | セキュリティ評価が必要 | |||
---|---|---|---|---|---|
非機密スコープ (推奨) | 特定のアクションに直接関連する限定データにのみアクセスを許可する。 | — | — | ||
機密性の高いスコープ | ユーザーの個人のデータ、リソース、アクションへのアクセス権を付与します。 | — | |||
制限付きのスコープ | 機密性の高いユーザーや広範なユーザーデータまたはアクションへのアクセス権を付与する。 |
次のステップ
アプリのアクセス認証情報を作成します。