このドキュメントでは、アラート センター API 固有の認可と認証の情報について説明します。このドキュメントを読む前に、認証と認可の詳細で Google Workspace の一般的な認証と認可の情報をお読みください。
認可用に OAuth 2.0 を設定する
OAuth 同意画面を構成し、スコープを選択して、ユーザーとアプリ審査担当者に表示する情報を定義し、後で公開できるようにアプリを登録します。
Alert Center API のスコープ
アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは OAuth 2.0 URI 文字列で、Google Workspace アプリ名、アプリがアクセスするデータの種類、アクセスレベルが含まれます。スコープは、ユーザーの Google アカウントのデータなど、Google Workspace のデータを操作するアプリからのリクエストです。
アプリのインストール時に、アプリで使用されているスコープを検証するよう求められます。一般的には、できる限り範囲を絞り込んだスコープを選択し、アプリが必要としないスコープをリクエストしないようにする必要があります。ユーザーが明確に説明された制限付きのスコープに対してより簡単にアクセス権を付与できます。
Alert Center API は、次のスコープをサポートしています。
| スコープ | 意味 |
|---|---|
https://www.googleapis.com/auth/apps.alerts |
Alert Center API に対する読み取り / 書き込みアクセス権 |
サービス アカウントを作成する
Alert Center API を使用するには、サービス アカウントを使用してドメイン全体の委任を設定する必要があります。詳細については、アクセス認証情報を作成するをご覧ください。