> For the complete documentation index, see [llms.txt](https://help.co-meeting.co.jp/calsket/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.co-meeting.co.jp/calsket/admins/settings/googlecalender/setup.md). # Googleカレンダー連携/同期機能の設定をする

* [1.Google Calendar APIへのリモートサイトアクセスを有効にする](#id-1-google-calendar-api) * [2.Calsket用のGoogle APIサービスアカウントを作成する](#id-2-calsketgoogle-api) * [3.Google Workspace 管理コンソールでサービスアカウントからのアクセスを許可](#id-3-g-suitegoogle) * [4.作成したサービスアカウントをCalsketに設定](#id-4-calsket) * [5.Googleカレンダー連携機能を有効化](#id-5-google) * [6.Googleカレンダー同期機能を有効化](#id-6-google)

Calsketでは、各個人がGoogleカレンダー上で設定している「マイカレンダー」「他のカレンダー」に追加しているカレンダーをCalsket上で参照可能にする「Googleカレンダー連携機能」とSalesforceの行動データとGoogleカレンダー（各個人のメインカレンダー）のデータを双方向で同期する「Googleカレンダー同期機能」の2種類の連携機能があります。詳しくは下記をご参考ください。 * [Googleカレンダー連携（参照）機能について](/calsket/admins/settings/googlecalender/functions-overview.md) * [Googleカレンダー同期機能について](/calsket/admins/settings/googlecalender/sync-overview.md) * [Googleカレンダー同期機能の同期仕様及び制限事項](/calsket/admins/restrictions/google-calender-sync.md) ここでは、これらの機能を使用する際の初期設定手順について説明します。 {% hint style="info" %} * 本設定を行う前に、Calsketのインストール手順の「[**3.権限セットの割り当て**](/calsket/admins/install/licence-allocation.md#id-3)」以降の手順が正しく行われていることを確認してください。 * サンドボックス環境でGoogleカレンダー同期機能を利用する場合（トライアル期間含む）はライセンスキーの設定が必要です。ライセンスキー未取得の場合は弊社まで[お問い合わせ](/calsket/contact-support.md)ください。 * Googleカレンダー同期機能には**各種制限事項**が存在します。[**こちら**](/calsket/admins/restrictions/google-calender-sync.md)に同期仕様と合わせて記載してありますので、ご確認ください。 {% endhint %} {% hint style="danger" %} SalesforceのGoogleカレンダー同期機能である「Lightning Sync」など、他の同期ツールと併せてトライアルをされる場合、**必ずLightning Syncや他の同期ツールを無効にした上で本設定を行ってください**。有効にしたまま本設定を行った場合、お互いの同期処理が同時に処理され、**行動が無数に追加される現象**が発生します。 {% endhint %} *** ## 1. Google Calendar APIへのリモートサイトアクセスを有効にする ❶ Salesforce設定にて \[セキュリティ] > \[リモートサイトの設定]を開き、\[GoogleAPI]の\[編集]をクリックします。

❷ \[有効]にチェックを入れ\[保存]ボタンをクリックしてください。 {% hint style="danger" %} Calsketのインストール後にリモートサイトの編集画面を開くと、「有効」にチェックが入った状態で表示されますが、上記画面上で「保存」ボタンをクリックし、保存する必要があります。ご注意ください。 {% endhint %} *** ## 2. Calsket用のGoogle APIサービスアカウントを作成する Calsket用のGoogle APIサービスアカウントを作成します。 ❶ Google Cloud Console ([https://console.cloud.google.com](https://console.cloud.google.com/))にGoogle Workplaceの特権管理者権限を持つアカウントでログインします。\ \ ❷ ヘッダーの矢印を押し、\[新しいプロジェクト]をクリックします。

❸ 適当な名称(例:「Calsket」)で新しいプロジェクトを作成します。

❹ \[作成]ボタンを押下後、しばらく待つと作成が完了し、作成したプロジェクトの画面に切り替わります。\
❺ \[≡] > \[APIとサービス] > \[ライブラリ]を開きます。

❻ 一覧に表示されていない場合は、検索フォームに「Calendar API」と入れ絞り込み、検索結果の中から「Google Calendar API」を選択します。

❼ 「有効にする」をクリックします。

❽ 次に、メニューの \[≡] > \[APIとサービス] > \[認証情報]を開きます。

❾ 「認証情報を作成」ボタンをクリックし、「サービスアカウント」を選択します。

❿ 「サービスアカウントの作成」画面に移動しますので、「サービスアカウントの詳細」にて、下記の情報を入力・選択して「作成して続行」ボタンをクリックしてください。 * サービスアカウント名: 任意（例: Calsket） * サービスアカウントの説明：任意

「このサービスアカウントにプロジェクトへのアクセスを許可する (省略可)」にて「編集者」を選択し、「完了」ボタンをクリックします。 ⓫ 続いて、G Suite ドメイン全体の委任を有効化します。作成したサービスアカウントの「メール」箇所をクリックします。

⓬ IDが生成されますので、このIDをテキストエディター等にコピーしておいてください。 ![](https://1131364978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnwmiwu1f7x4PgbGBrNc0%2Fuploads%2FUxEns6jXppAMVg7HtnOP%2Fimage.png?alt=media\&token=809cf44f-13cd-4b0e-ab5e-2144b037fefc) ⓭ 続いてサービスアカウントキーを作成します。「キー」タブをクリックしてください。 ⓮ 「鍵」画面に移動しますので、「鍵を追加」ボタンをクリックし、「新しい鍵を作成」を選択してください。

⓯ 秘密鍵の作成ダイアログが表示されますので、「JSON」を選択し、「作成」をクリックしてください。

\ ⓰ 「<プロジェクト名>-xxxxx.json」が生成されますので、任意の場所に保存します。このファイルは後の設定で利用します。

⓱ 以上で終了です。 *** ## 3. Google Workspace 管理コンソールでサービスアカウントからのアクセスを許可 ❶ Google Workspace管理コンソール（[https://admin.google.com](https://admin.google.com/)）に管理者でログインし、\[セキュリティ]を開きます。

❷ \[アクセスとデータ管理]＞\[APIの制御]を開き\[ドメイン全体の委任を管理]を開きます。 ![](https://1131364978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fnwmiwu1f7x4PgbGBrNc0%2Fuploads%2F5yrTVwiyWGe2SzhYHdbH%2Fimage.png?alt=media\&token=fb8793d4-3beb-4693-a923-fd519ab3404e) ❸ \[新しく追加]を開きます。

❹ 以下のアクセス許可設定を追加し、\[承認]をクリックします。 * クライアントID: <手順2.⓬にて控えたID> * OAuthスコープ:

❺ 以上で完了です。 *** ## 4. 作成したサービスアカウントをCalsketに設定 ❶ Calsketを開き、右上のアイコンもしくは歯車アイコンをクリックし、表示された「システム設定」をクリックしてください

❷ 「Google連携/同期」タブをクリックし、「接続設定」セクション右上の「編集」ボタンをクリックします。

\ ❷ 「Googleサービスアカウントの秘密鍵（JSONファイル）をアップロード」に上記手順でダウンロードした\[<プロジェクト名>-xxxxx.json]ファイルをアップロードし、「Google Workspaceアカウント（メールアドレス）が保存されている「ユーザー」オブジェクトの保存先項目のAPI参照名」にGoogle Workspaceアカウント(Emailアドレス)が格納されているユーザーオブジェクトの項目のAPI 参照名を設定し、「保存」ボタンをクリックします。

{% hint style="info" %} **「Google Workspaceアカウント（メールアドレス）が保存されている「ユーザー」オブジェクトの保存先項目のAPI参照名」に指定する項目の記載場所** Salesforceにログイン＞設定＞オブジェクトマネージャー＞ユーザー＞項目とリレーションにて、 Google Workspaceアカウント(Emailアドレス)が格納されている項目の**「項目名」**を Google Workspaceアカウント（メールアドレス）が保存されている「ユーザー」オブジェクトの保存先項目のAPI参照名に指定します。 ※Google Workspaceアカウント(Emailアドレス)が格納されている項目が存在しない場合は、ログイン＞設定＞オブジェクトマネージャー＞ユーザー＞項目とリレーション＞新規からカスタム項目を新規作成し、ユーザー登録画面にて、作成したカスタム項目にGoogle Workspaceアカウント(Emailアドレス)を登録します。 {% endhint %} ❸ 以上で、Googleカレンダーと連携する準備が整いました。しかし、各機能はまだ無効になっています。各連携機能を利用するには機能の有効化が必要です。 *** ## 5. Googleカレンダー連携機能を有効化 ❶ Calsketを開き、右上のアイコンもしくは歯車アイコンをクリックし、表示された「システム設定」をクリックしてください

❷ 「Google連携/同期」タブをクリックし、「Googleカレンダー連携」セクションの「Googleカレンダー連携機能を有効にする」右脇のトグルボタンをクリックし、Googleカレンダー連携機能を有効にしてください。

❸ 以上で完了です。Googleカレンダー連携機能を有効化すると、CalsketにGoogleカレンダーの情報を重ねて表示することができます（[詳細](/calsket/admins/settings/googlecalender/functions-overview.md)）。 *** ## 6. Googleカレンダー同期機能を有効化 ❶ Calsketを開き、右上のアイコンもしくは歯車アイコンをクリックし、表示された「システム設定」をクリックしてください

❷ 「Google連携/同期」タブをクリックし、「Googleカレンダー同期」セクションの「Googleカレンダー同期を有効にする」右脇のトグルボタンをクリックし、Googleカレンダー同期機能を有効にしてください。

❸ 以上で完了です。Googleカレンダー同期機能を有効化すると、Salesforceのカレンダーの更新情報は即座にGoogleカレンダーに反映され、Googleカレンダーの更新情報は5分おきにSalesforceのカレンダーに反映されます。設定終了後、まずはSalesforce側にデータを追加していただき、Googleカレンダーへデータが反映されていることをご確認ください。 {% hint style="warning" %} **同期のタイミングについて** SalesforceからGoogleカレンダーへの同期処理はCalsketのApexトリガを利用して即座に実行されます。それに対して、GoogleカレンダーからSalesforceへの同期はCalsketの定期的なジョブにより5分ごとに実行されます。このとき、前回の処理が実行中の場合はスキップされるため、5分ごとに同期処理が完了するわけではありません。 GoogleカレンダーからSalesforceの同期時間は同期対象のユーザーやカレンダーの更新量に応じて変化し、規模によっては数時間かかることもございます。ご了承ください。 {% endhint %} [Googleカレンダー同期機能の同期仕様及び制限事項](/calsket/admins/restrictions/google-calender-sync.md)