GoogleカレンダーのカレンダーIDとAPIキーの取得方法。

GoogleカレンダーのカレンダーIDと、Google Calendar APIのAPIキーの取得・設定のメモ。

カレンダーIDの取得

既存のGoogleカレンダーのIDを取得する方法。

1. IDを取得したいカレンダーの管理権限があるGoogleアカウントにログインしてGoogleカレンダーに行く。
2. 左カラム下部にある「My calendars」(「マイカレンダー」)の中のIDを取得したいカレンダーの「Settings and sharing」(「設定と共有」)を開く。
3. 下部にある「Integrate calendar」(「カレンダーの統合」)の項目に「Calendar ID」(「カレンダーID」)がある。

※ 上部にある「Access permissions」(「予定のアクセス権限」)の項目でカレンダーの公開状態、公開範囲を設定できる。

※ 「Share with specific people」(「特定のユーザーとの共有」)の項目で任意のGoogleアカウントやAPIのサービスアカウントとカレンダー共有の設定ができる。

APIキーの取得

Google APIでGoogleカレンダーを利用するためのAPIキーを取得する方法。

APIキーの取得方法

1. Google API Consoleの「APIs & Services」(「API とサービス」)へ行く。
2. 画面上部固定のメニューバー内にある既存プロジェクトを選択するプルダウンボタンでプロジェクト選択ウィンドウを開く。
3. 右上の「New Project」(「新しいプロジェクト」)で任意の名前を付けてプロジェクトを新規作成。
4. 作成したプロジェクトを選択した状態で左カラムのメニューから「Library」(「ライブラリ」)をクリック。
5. APIの中から「Google Calendar API」を選択して、「ENABLE」(「有効にする」)にする。
6. プロジェクトのダッシュボードに戻り、左カラムのメニューから「Credentials」(「認証情報」)を選択。
7. メインカラム上部にある「CREATE CREDENTIALS」(「認証情報を作成」) > 「API Key」(「API キー」)でAPIキーを作成。
8. モーダルウィンドウが開き、APIキーが表示される。
9. メインカラムのAPI Keysの一覧に表示されている該当のキー名をクリックして、詳細ページ右上の欄でもAPIキーが確認できる。

APIキーの使用制限

そのままでは、取得したAPIキーに使用制限が無いので、APIキーを使用できるウェブアプリケーションを制限する。

該当の「API Key」の詳細ページにある「Application restrictions」(「アプリケーションの制限」)の項目でアクセス制限の設定をする。

• none : 制限無し
• HTTP referrers (web sites) : HTTPのリファラーを確認してURLで制限。
• IP addresses (web servers, cron jobs, etc.) : IPアドレスで制限。
• Android apps : アンドロイドアプリで制限。
• iOS apps : iOSアプリで制限。

「HTTP referrers」で許可するURLを指定するときは、特定のURLを指定するか、「*」(ワイルドカード)を使う。

• 「memo.ag2works.tokyo/特定のパス」 : 特定のURLのみ。
• 「ag2works.tokyo/*」 : ドメイン以下すべて。
• 「memo.ag2works.tokyo/*」 : 特定のサブドメイン以下すべて。
• 「*.ag2works.tokyo/*」: すべてのサブドメイン以下すべて。

※ リファラーは簡単に偽装できるので、リファラーでの制限にあまり意味は無い。(サーバーサイドで動作するようにしてサーバーのIPアドレスで制限する方が無難。)

プロジェクトの削除

作成したプロジェクトを削除したい場合は、画面左上のメニューボタン > 「IAM & Admin」(「IAMと管理」) > 「Settings」(「設定」) > 「SHUT DOWN」(「シャットダウン」)。

サービスアカウントの作成

1. プロジェクトのダッシュボードに行き、左カラムのメニューから「Credentials」(「認証情報」)を選択。
2. メインカラムの「CREATE CREDENTIALS」(「認証情報を作成」) > 「Service account」(「サービスアカウント」)でサービスアカウントを作成。
3. 作成したサービスアカウントをクリックして、詳細ページで「Email」や「Key」が確認できる。

• Googleカレンダー情報をPHPで取得してみる