Cu-hacker for SalesforceのGoogleカレンダー連携/同期機能の設定をする

Cu-hacker for Salesforceには2種類のGoogleカレンダー連携機能があります。

これらの機能を使用する際の初期設定手順について説明します。

本設定を行う前に、Cu-hacker for Salesforceのインストール手順の「権限セットの割り当て」以降の手順が正しく行われていることを確認してください。

Google Calendar APIへのリモートサイトアクセスを有効にする

Salesforce 設定にて [セキュリティのコントロール] > [リモートサイトの設定]を開き、[GoogleAPI]の[編集]をクリックします。

security_remote_access.png [有効]にチェックを入れ[保存]

※Cu-hacker for Salesforceのインストール後にリモートサイトの編集画面を開くと、「有効」にチェックが入った状態で表示されますが、上記画面上で「保存」ボタンをクリックし、保存する必要があります。ご注意下さい。

Cu-hacker用のGoogle APIサービスアカウントを作成する

Cu-hacker用のGoogle APIサービスアカウントを作成します。

Google API Console (https://console.developers.google.com/ )にGoogle Appsの特権管理者権限を持つアカウントでログインします。

[プロジェクトを作成]をクリックし、適当な名称で新しいプロジェクトを作成します。
しばらく待つと作成が完了し、作成したプロジェクトの画面に切り替わります。

[API Manager] > [ライブラリ]で [Calendar API]を選択します。

API_ライブラリ_-_My_Project_1 [有効にする]をクリックします。

API_Manager_-_My_Project_1

次に[≡] > [IAMと管理] > [サービスアカウント]を開き、[サービスアカウントを作成]をクリックします。

IAM_と管理_-_My_Project

サービスアカウント作成画面で以下のように入力し、[作成]ボタンをクリックします。

  • サービス アカウント名: 任意(例: cu-hacker)
  • 役割:プロジェクト→編集者
  • 新しい秘密鍵の提供: チェックを入れる
  • キーのタイプ: JSON
  • Google Appsのドメイン全体の委任を有効にする: チェックを入れる
  • 同意画面のサービス名: 任意(例: cu-hacker)

作成を押すと、[<プロジェクト名>-xxxxx.json]というファイル名ファイルが自動的にダウンロードされます。このファイルを大事に保管してください。

[API Manager] > [認証情報]を開き、[OAuth 2.0クライアントID]セクションの[クライアントID]に表示されている数字を控えておきます。

認証情報_-_Cu-hacker

Google Appsでサービスアカウントからのアクセスを許可

Google Appsに管理者でログインして、管理者コンソールの[セキュリティ]を開きます。

[もっと見る] > [詳細設定]を開き[API クライアント アクセスを管理する]を開きます。

以下のアクセス許可設定を追加します。

  • クライアント名: <先ほど控えたクライアントID>
  • 1 つ以上の API の範囲: https://www.googleapis.com/auth/calendar
貼り付けた画像_2016_03_09_19_07

作成したサービスアカウントをCu-hackerに設定

Salesforceで [Cu-hacker管理] アプリケーションを選択し、[設定] タブを開きます。

スクリーンショット 2016-05-18 14.43.47 [Googleカレンダー連携/同期の設定]セクションで以下のように入力し、[保存]をクリックします。

  • Googleサービスアカウントの秘密鍵
    • 上記手順でダウンロードした[<プロジェクト名>-xxxxx.json]ファイルをアップロード
  • Google Appsアカウント保存先項目名
    • Google Appsアカウント(Emailアドレス)が格納されているユーザーオブジェクトの項目のAPI 参照名を設定します。
    • Google AppsアカウントとSalesforceユーザのユーザ名(Username)が同じ場合は空欄のままにします。
    • 例えばユーザーのGoogleEmail__cというカスタム項目にGoogle Appsアカウントのメールアドレスが紐付いている場合は「GoogleEmail__c」を入力します。

 

スクリーンショット 2016-05-23 16.40.15

以上で、Googleカレンダーと連携する準備が整いました。しかし、各連携機能はまだ無効になっています。各連携機能を利用するには機能の有効化が必要です。

Googleカレンダー連携機能を有効化

Googleカレンダー連携機能を有効化する場合、[Cu-hacker管理] アプリケーションの[設定] タブを開き、[Googleカレンダー同期]セクションの[Googleカレンダー連携機能を有効化]で[有効にする]チェックボックスにチェックを入れ、[保存]ボタンをクリックします。

スクリーンショット 2016-05-23 16.49.05

Googleカレンダー連携機能を有効化すると、Cu-hacker for SalesforceにGoogleカレンダーの情報を重ねて表示することができます。

Googleカレンダー同期機能を有効化

Googleカレンダー同期機能を有効化する場合、[Cu-hacker管理] アプリケーションの[設定] タブを開き、[Googleカレンダー同期]セクションの[Googleカレンダー同期機能を有効化]で[有効にする]チェックボックスにチェックを入れ、[保存]ボタンをクリックします。

スクリーンショット 2016-05-23 16.48.54

Googleカレンダー同期機能を有効化すると、Salesforceのカレンダーの更新情報は即座にGoogleカレンダーに反映され、Googleカレンダーの更新情報は5分おきにSalesforceのカレンダーに反映されます。設定終了後、まずはSalesforce側にデータを追加していただき、Googleカレンダーへデータが反映されていることをご確認下さい。

同期のタイミングについて
SalesforceからGoogleカレンダーへの同期はリアルタイムで、GoogleカレンダーからSalesforceへの同期は最低5分ごとに行われ、ご利用されるユーザー数に依存してかかる時間が変わります。1000ユーザーでは30分程度かかります。

Googleカレンダー同期機能: 既存データの同期

あらかじめGoogleカレンダー同期機能を有効化してから実行してください。
現状、既存のSalesforceの行動データをGoogleカレンダーに同期することはできません。(同期機能有効化以降に作成された行動はGoogleカレンダーに同期されます。)  

既存のGoogleカレンダーのデータをSalesforceに同期することができます。
Googleカレンダー同期機能を有効化する場合、[Cu-hacker管理] アプリケーションの[設定] タブを開き、[Googleカレンダー同期]セクションの[既存データの同期]で[期間]および[同期方向](以下参照)を選択し、[初期データ同期開始]をクリックします。

  • 期間:
    • 本日
    • 1ヶ月前
    • 2ヶ月前
    • 3ヶ月前
  • 同期方向:
    • Googleカレンダーの予定をSalesforceに
    • Salesforceの行動をGoogleカレンダーに(本機能はまだ未リリースです。)
スクリーンショット 2016-05-23 16.51.35