このドキュメントでは、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.freebusy |
自分のカレンダーにスケジュールを表示します。 |
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 |
カレンダーのアドオンとして実行します。 |
https://www.googleapis.com/auth/calendar.addons.current.event.read |
Google カレンダーで開いたイベントを確認します。 |
https://www.googleapis.com/auth/calendar.addons.current.event.write |
Google カレンダーで開いたイベントを編集します。 |
https://www.googleapis.com/auth/calendar.events.owned |
オーナー権を持っている Google カレンダー上の予定の参照、作成、変更、削除。 |
https://www.googleapis.com/auth/calendar.events.owned.readonly |
オーナー権を持っている Google カレンダー上の予定の参照。 |
https://www.googleapis.com/auth/calendar.events.freebusy |
アクセス権を持っている Google カレンダーの空き情報を確認できます。 |
https://www.googleapis.com/auth/calendar.app.created |
メイン以外の Google カレンダーの作成、そのカレンダー上の予定の参照、作成、変更、削除。 |
https://www.googleapis.com/auth/calendar.calendarlist |
登録している Google カレンダーの参照、新規登録、登録解除。 |
https://www.googleapis.com/auth/calendar.calendarlist.readonly |
登録している Google カレンダーの一覧を表示します。 |
https://www.googleapis.com/auth/calendar.calendars |
アクセス権を持っている Google カレンダーのプロパティの参照と変更、メイン以外のカレンダーの作成。 |
https://www.googleapis.com/auth/calendar.calendars.readonly |
アクセス権を持っている Google カレンダーのプロパティ（タイトル、説明、デフォルトのタイムゾーン、その他）の参照。 |
https://www.googleapis.com/auth/calendar.acls |
オーナー権を持っている Google カレンダーの共有権限の参照と変更。 |
https://www.googleapis.com/auth/calendar.acls.readonly |
オーナー権を持っている Google カレンダーの共有権限を確認します。 |
https://www.googleapis.com/auth/calendar.events.public.readonly |
一般公開カレンダー上の予定の参照。 |