このドキュメントでは、Google Calendar API 固有の認可と認証について説明します。このドキュメントを読む前に、認証と認可についてで Google Workspace の一般的な認証と認可に関する情報をご確認ください。
認可用に OAuth 2.0 を構成する
OAuth 同意画面を設定し、スコープを選択することで、ユーザーとアプリの審査担当者に表示する情報を定義し、後でアプリを公開できるようにアプリを登録します。
Calendar API スコープ
アプリに付与されるアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは、Google Workspace アプリ名、アクセスするデータの種類、アクセスレベルを含む OAuth 2.0 URI 文字列です。スコープとは、ユーザーの Google アカウント データなど、Google Workspace データの操作に対するアプリのリクエストです。
アプリがインストールされると、アプリで使用されるスコープをユーザーが検証するよう求められます。通常は、できるだけ範囲の狭いスコープを選択し、アプリで必要のないスコープはリクエストしないようにします。ユーザーは、明確に説明された限定的なスコープに対してアクセス権限を付与する傾向があります。
Calendar API は、次のスコープをサポートしています。
| 範囲 | 意味 |
|---|---|
https://www.googleapis.com/auth/calendar |
Google カレンダーを使用してアクセスできるすべてのカレンダーの表示、編集、共有、完全削除を行えます。 |
https://www.googleapis.com/auth/calendar.readonly |
カレンダーを使用してアクセスできるすべてのカレンダーを表示、ダウンロードできます。 |
https://www.googleapis.com/auth/calendar.events |
すべてのカレンダーの予定を表示、編集できます。 |
https://www.googleapis.com/auth/calendar.events.readonly |
すべてのカレンダーの予定を表示します。 |
https://www.googleapis.com/auth/calendar.settings.readonly |
カレンダーの設定を表示します。 |
https://www.googleapis.com/auth/calendar.addons.execute |
カレンダーのアドオンとして実行します。 |