このドキュメントでは、Google Calendar API 固有の認可と認証の情報について説明します。このドキュメントを読む前に、認証と認可について学ぶで、Google Workspace の一般的な認証と認可の情報をお読みください。
認可用に OAuth 2.0 を構成する
OAuth 同意画面を構成し、スコープを選択して、ユーザーとアプリの審査担当者に表示する情報を定義し、後で公開できるようにアプリを登録します。
Calendar API のスコープ
アプリに付与するアクセスレベルを定義するには、認可スコープを特定して宣言する必要があります。認可スコープは、Google Workspace アプリ名、アクセスするデータの種類、アクセスレベルを含む OAuth 2.0 URI 文字列です。スコープとは、アプリが Google Workspace データ（ユーザーの Google アカウントのデータを含む）を操作するためのリクエストです。
アプリのインストール時に、アプリで使用されているスコープを検証するよう求められます。一般的には、可能な限り最も絞り込んだスコープを選択し、アプリが必要としないスコープをリクエストしないようにする必要があります。ユーザーは、明確に説明された限定的なスコープへのアクセス権を簡単に付与できます。
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 |
カレンダーのアドオンとして実行します。 |