*Googleアカウント連携（詳細設定）

AmeliaのGoogleカレンダー詳細設定の設定方法

Googleカレンダーの詳細設定では、Google Cloud ConsoleでOAuth認証情報を作成し、AmeliaとGoogleカレンダーを連携させることができます。この方法は、認証、ブランディング、または組織のGoogleアカウントを完全に制御する必要があるユーザー向けです。設定にはいくつかの手順が必要ですが、一度設定すれば、完了後にAmeliaとGoogleカレンダー間の信頼性の高い同期が保証されます。

Googleアプリの確認に関する重要な注意

詳細設定を使用する場合、Google Cloud Consoleで独自のGoogleアプリケーションを作成することになります。この場合、連携の開発者はAmeliaではなく、あなた自身であるとみなされます。

アプリケーションが作成されたばかりでGoogleによって確認されていないため、スタッフがカレンダーを連携する際に「このアプリはGoogleによって確認されていません」という警告が表示されることがあります。

この警告は想定内の動作であり、連携機能が動作しなくなるものではありません。認証情報はユーザー自身によって作成されたものであるため、「詳細」→「（アプリ名）に移動」を選択して安全に続行できます。

必要に応じて、Google Cloud Consoleからアプリケーションの確認申請を行うこともできますが、Ameliaの連携を正常に機能させるために必須ではありません。

アプリを確認することにした場合は、以下のセクションで次の手順を確認してください。

Googleは、Google Cloud Consoleのインターフェースを頻繁に更新および再構成しています。メニューのラベルやナビゲーションパスは時間の経過とともに変更される可能性がありますが、以下に説明する主要な設定手順は変わりません。

詳細なGoogle設定のためにAmeliaを準備するにはどうすればよいですか？

詳細設定を開始する前に、標準のGoogle連携が有効になっていないことを確認してください。

以前に「Googleでサインイン」方式を使用していた場合は、まずそれを解除してください。この方式では、クライアントIDとクライアントシークレットの項目がロックされ、手動設定ができなくなるためです。

解除後、Amelia → 基本設定 → 連携 → Googleカレンダー ＆ Google Meet → 設定を開き、「全般」タブに切り替えます。

ここには、後でGoogle Cloud Consoleで生成された認証情報を貼り付けることになります。

Google Cloud Consoleで何を構成する必要がありますか？

詳細設定には、Google Cloudプロジェクトを作成または構成し、Ameliaとの通信を許可する必要があります。Google Cloud Consoleのインターフェースの変更に関わらず、設定には常に以下の核となる手順が含まれます。

新しいGoogle Cloudプロジェクトを作成するにはどうすればよいですか？

1. Google Cloud Consoleに移動します。
2. 左上のプロジェクト選択（「Google Cloud」ロゴの隣）をクリックするか、CTRL+Oを押します。
3. ポップアップで、右上隅にある「新しいプロジェクト」をクリックします。
4. （無料のGoogleアカウントを使用している場合は）「組織なし」を選択するか、（Google Workspaceを使用している場合は）組織のプロフィールを選択します。
5. プロジェクト名（例：Amelia GCal Integration）を入力し、「作成」をクリックします。

ビジネスアカウントの場合は、必ず組織を選択してください。個人アカウントの場合は、「組織なし」がデフォルトになります。

Google Calendar APIを有効にするにはどうすればよいですか？

1. プロジェクトが作成されたら、ページ右上の通知から「プロジェクトを選択」をクリックします（または、CTRL+Oでプロジェクト選択を再度開き、作成したプロジェクトを選択します）。
2. メニュー（左上の ☰ またはキーボードの「.」キー）を開きます。
3. APIとサービス → ライブラリに移動します。
4. 検索バーに「google calendar api」と入力します。
5. 「Google Calendar API」をクリックし、「有効にする」をクリックします。

OAuth認証情報を作成するにはどうすればよいですか？

1. APIを有効にした後、画面の右上隅にある「認証情報を作成」をクリックします。
2. または、APIとサービス → 認証情報に移動し、画面中央の「+ 認証情報を作成」ドロップダウンから「OAuth クライアント ID」をクリックします。
3. 選択：
   • Google Calendar API
   • ユーザーデータ
   • 「次へ」をクリックします。

4. アプリ名を入力します。（例：Amelia GCal）
5. 「ユーザーサポートメール」と「デベロッパーの連絡先情報」の両方に自分のメールアドレスを選択します。
6. 「保存して続行」をクリックします。

OAuthクライアントIDを設定するにはどうすればよいですか？

1. 次のステップ（スコープ）では、アプリケーションの確認申請を行う予定がない限り、変更を加えずに「保存して続行」を再度クリックしてください。これにより、OAuthクライアントIDの設定に進みます。
2. 「アプリケーションの種類」で「ウェブ アプリケーション」を選択します。
3. 名前を付けます（例：Amelia GCal）。
4. 下にスクロールして「承認済みのリダイレクト URI」に移動し、「+ URI を追加」をクリックして、Amelia → 基本設定 → 連携 → Googleカレンダー ＆ Google Meet → 設定 → 全般タブにあるリダイレクトURIを貼り付けます。
   • 例：https://yourdomain.com/wp-admin/admin.php?page=wpamelia-employees
5. （オプションですが役立ちます）お客様画面のスタッフマイページを使用している場合は、「+ URI を追加」ボタンをクリックし、マイページのフルURLを追加します（例：https://yourdomain.com/staff-portal/）。末尾の / を忘れないでください。
6. 「作成」をクリックします。

「承認済みの JavaScript 生成元」ではなく、「承認済みのリダイレクト URI」を追加するようにしてください。
ウェブサイトはHTTPSを使用している必要があります（HTTPは機能しません）。
アプリを「テスト」モードのままにしないでください。1〜2日ごとにスタッフの連携が解除されてしまいます。必ず「本番」に公開してください。

オプション：Googleのアプリ確認申請

スタッフがカレンダーを連携する際の「このアプリはGoogleによって確認されていません」という警告を削除したい場合は、Google Cloud ConsoleでOAuthアプリケーションの確認申請を行うことができます。

審査のためにアプリケーションを準備するには、OAuth同意画面で以下のスコープを構成する必要があります。

• /auth/calendar.readonly
• /auth/calendar.events

アプリの確認は自動化されたプロセスではなく、完全にGoogleによって処理されます。審査には、アプリケーションがGoogleデータをどのように使用するかについての追加情報が必要になる場合があります。

確認申請の完全な手順については、Googleの公式ガイドに従ってください。

確認は任意であることに注意してください。確認がなくても連携は通常通り機能します。Googleは承認ステップ中に警告を表示するだけです。

クライアントIDとクライアントシークレットを取得するにはどうすればよいですか？

1. 認証情報画面のまま、クライアントIDをコピーして、Amelia → 基本設定 → 連携 → Googleカレンダー ＆ Google Meet → 設定 → 全般の対応する項目に貼り付け、Google Cloud Consoleで「完了」をクリックします。

このステップを誤ってスキップしてしまった場合でも、シークレットを取得する際にクライアントIDにアクセスできます。

1. メニュー（左上の ☰ またはキーボードの「.」キー）を開きます。
2. APIとサービス → 認証情報に移動します。
3. 「OAuth 2.0 クライアント ID」の下にあるアプリの名前をクリックします。
4. 右側に、クライアントIDと非表示のクライアントシークレットが表示されます（コピーボタンをクリックしてください）。
5. これらの値を、Amelia → 基本設定 → 連携 → Googleカレンダー ＆ Google Meet → 設定 → 全般の対応する項目に貼り付けます。

アプリを公開するにはどうすればよいですか？

1. メニュー（左上の ☰ またはキーボードの「.」キー）を開きます。
2. APIとサービス → OAuth 同意画面 → 公開ステータスに移動します。
3. 「アプリを公開」をクリックします。
4. 「本番環境にプッシュしますか？」と聞かれたら確認します。

これで完了です。AmeliaがGoogle Cloudに連携されました。

詳細設定を使用する際に留意すべき点は何ですか？

• 詳細設定は、OAuth認証情報やブランディングされたGoogle承認画面を完全に制御する必要があるユーザー向けです。
• リダイレクトURIは正確に一致している必要があります。不一致があると認証ができません。
• 連携が確立されると、スタッフはGoogleカレンダー設定の記事で説明されているルールに従ってカレンダーをリンクできます。
• この設定は一回限りの構成です。認証情報が取り消されたり、ドメインが変更されたりしない限り、繰り返す必要はありません。
• GoogleがリダイレクトURIフィールドへの http:// の追加を禁止しているため、詳細設定はlocalhostでは動作しません。