Google Console設定
Google WorkspaceモジュールがGoogleサービスと通信する前に、Google Cloudプロジェクトを作成し、必要なAPIを有効にし、OAuth認証情報を生成する必要があります。このガイドでは、すべての手順を説明します。
ステップ1:Google Cloudプロジェクトの作成
- Google API Consoleにアクセスします。
- 上部ナビゲーションバーのプロジェクトを選択をクリックし、新しいプロジェクトをクリックします。
- プロジェクト名を入力します(例:「Concord CRM Integration」)。
- 作成をク リックし、プロジェクトがプロビジョニングされるのを待ちます。
- プロジェクトのドロップダウンで新しいプロジェクトが選択されていることを確認します。
備考
再利用したい既存のGoogle Cloudプロジェクトがある場合は、新規作成する代わりにプロジェクトリストから選択してください。
ステップ2:必要なAPIの有効化
プロジェクトを選択した状態で、以下の各APIを有効にします:
- APIとサービス → ライブラリに移動します。
- 各APIを個別に検索して有効にします:
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
各APIについて:
- 検索結果のAPI名をクリックします。
- 有効にするをクリックします。
- 次のAPIに進む前に確認を待ちます。
警告
モジュールが正しく機能するには、4つのAPIすべてを有効にする必要があります。いずれかのAPIが欠けていると、対応するGoogleサービスにCRMからアクセスできなくなります。
ステップ3:OAuth同意画面の設定
- APIとサービス → OAuth同意画面に移動します。
- ユーザータイプを選択します:
- 外部 -- ほとんどのセットアップに推奨。任意のGoogleアカウントでの認可を許可します。
- 内部 -- Google Workspace(有料)アカウントでのみ利用可能。組織内のユーザーに限定されます。
- 作成をクリックします。
- 必須フィールドを入力します:
- アプリ名 -- 認可時にユーザーに表示される名前(例:「Concord CRM」)。
- ユーザーサポートメール -- サポート用のメールアドレス。
- デベロッパーの連絡先情報 -- あなたのメールアドレス。
- スコープとテストユーザーのステップは保存して続行をクリックして進みます(基本セットアップでは変更不要)。
- サマリータブからダッシュボードに戻るをクリックします。
公開ステータス
| ステータス | HTTPS必須 | 注記 |
|---|---|---|
| テスト中 | いいえ | テストユーザー100人に限定。追加の同意警告が表示される |
| 本番 | はい | すべてのユーザーが利用可能。サイトでHTTPSの使用が必要 |
ヒント
初期セットアップとテストでは、アプリをテスト中モードのままにしてください。すべてが正しく動作す ることを確認したら、シームレスな認可体験のために本番に切り替えてください。
ステップ4:OAuth認証情報の作成
- APIとサービス → 認証情報に移動します。
- 認証情報を作成 → OAuthクライアントIDをクリックします。
- アプリケーションタイプとしてウェブアプリケーションを選択します。
- 認証情報の名前を入力します(例:「Concord CRM OAuth」)。
- 承認済みのリダイレクトURIに以下を追加します:
https://yourdomain.com/google-workspace/callback
yourdomain.comをConcord CRMがインストールされている実際のドメインに置き換えてください。
- 作成をクリックします。
- ダイアログにクライアントIDとクライアントシークレットが表示されます。両方の値をコピーします。
警告
リダイレクトURIは、プロトコル(HTTPS)とパスを含め、Concord CRMのインストールURLと正確に一致する必要があります。リダイレクトURIが正しくないと、認可が失敗します。
ステップ5:Concord CRMへの接続
- 管理者としてConcord CRMにログインします。
- Google Workspaceモジュールの設定に移動します。
- 前のステップのクライアントIDとクライアントシークレットを貼り付けます。
- 保存して認可をクリックします。
- Googleの同意画面が表示されます。Googleアカウントを選択し、要求された権限を付与します。
- Concord CRMにリダイレクトされます。接続ステータスが認可済みと表示されるはずです。
備考
Google Cloudアプリがテスト中モードの場合、認可中に追加の警告画面が表示されます。続行をクリックして進んでください。この警告は本番モードでは表示されません。
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| 「Error 400: redirect_uri_mismatch」 | Google CloudのリダイレクトURIがCRMのURLと正確に一致することを確認 |
| 認可がサイレントに失敗する | Google Cloudプロジェクトで4つのAPIすべてが有効になっていることを確認 |
| 「アクセスがブロックされました:アプリが未確認」 | 本番モードに切り替えるか、テストユーザーとしてアカウントを追加 |
| しばらくすると接続が切れる | モジュール設定から再認可。トークンのリフレッシュ設定を確認 |
セキュリティの推奨事項
- 承認済みリダイレクトURIを使用して、OAuth認証情報を特 定のドメインに制限してください。
- OAuthトークンを通信中に保護するため、Concord CRMのインストールにHTTPSを使用してください。
- 不要な権限が付与されていないことを確認するため、Google Cloud ConsoleでAPIアクセスを定期的に確認してください。
- 認証情報が漏洩した疑いがある場合は、認証情報をローテーションしてください。
サポート
Google Cloudプロジェクトの設定にヘルプが必要な場合は、Themesicサポートチケットエリアをご利用ください。