Greenhouse 向け Candidate Sync インストールガイド
Greenhouse で Indeed 連携をインストールします。
インストールには Greenhouse の管理者と、Indeed 上で Employer Home の管理者権限を持つユーザーが必要です。
このインストールには技術的な設定が含まれます。作業を進める前に IT 部門に相談してください。
概要
セクション | 対象者 | 目的 | 所要時間 |
|---|---|---|---|
| Greenhouse から必要な情報を取得する | Greenhouse 管理者 | Indeed の Employer Home 管理者と共有するメールのユーザー名とパスワードを用意します。 | 約 30 分（Greenhouse での初回設定のみ）。 |
| Indeed で連携をインストールする | Indeed Employer Home 管理者 | Greenhouse 管理者から必要な情報を取得し、Indeed で連携をインストールして有効化します。 | 約 5 分（Indeed での初回設定のみ）。組織によって連携全体の所要時間は異なります。設定が完了すると、ほぼすぐに連携を利用できます。 |
| 推奨トピック | Indeed Employer Home 管理者 | データ要件と、候補者が求人票 (requisition) にどのように関連付けられるかを理解します。 | 該当なし |
Greenhouse から必要な情報を取得する
このセクションの手順は Greenhouse 管理者が実施し、次の情報を Employer Home の管理者権限を持つユーザーに引き渡してください。
- メールアドレス
- API キー (API key)
-
連携用のメールのユーザー名とパスワードを決めます。
-
Greenhouse にログインします。https://app4.greenhouse.io/users/sign_in
-
設定 (Settings) アイコンをクリックします。
-
Dev Center を選択します。
-
API Credential Management をクリックします。
-
右上の Create New API Key ボタンをクリックします。
-
Create New Credential ダイアログで、次を選択します。
- API Type では「Harvest」を選択します。
- Partner では「Indeed」を選択します。
- Description には「Indeed Harvest API Key」と入力します。
-
Manage Permissions ボタンをクリックします。
-
Copy ボタンをクリックして API キーをクリップボードにコピーします。
重要: この画面を離れると Harvest API キー全体を再度表示できないため、API キーは安全な場所に必ず保存してください。
-
I have stored the API Key ボタンをクリックします。
-
次のページで、次の権限を選択します。
権限 権限カテゴリ 選択する項目 Applications - Patch: Update Application
- Post: Add Attachment to Application
Candidates - Get: Retrieve Candidate
- Get: List Candidates
- Patch: Edit Candidate
- Post: Add Candidate
- Post: Add Attachment
- Post: Add Application
- Post: Add Education
- Delete: Delete Education
- Post: Add Employment
- Delete: Delete Employment
- Post: Add Employment
- Delete: Delete Employment
- Post: Add Prospect
Jobs - Get: Retrieve Jobs
- Get: List Jobs
Tags - Delete: Remove tag from candidate
- Get: List tags applied to candidates
- Get: List Candidate Tag
- Post: Add New Candidate Tags
- Delete: Remove Candidate Tags
- Put: Add a candidate tag
Users - Get: Retrieve User
- Get: List Users
Sources - Get: List Sources
Prospect Pool - Get: Retrieve Prospect Pool
- Get: List Prospect Pools
Education - Get: Get degrees
- Get: Get disciplines
- Get: Get schools
Rejection Reasons - Get: List Rejection Reasons
Job Stages - Get: List Job Stages
-
Save をクリックします。
-
インストールを完了する Employer Home 管理者に、次の認証情報を渡します。
- メールアドレス
- API キー (API key)
Indeed で連携をインストールする
-
Greenhouse の連携カードを選択します。
-
Get started をクリックします。
-
Sync Indeed candidates and data to ATS を選択します。
- Greenhouse 管理者から受け取った情報を入力します。
- メールアドレス (Email)
- API キー (API key)
-
利用規約に同意し、Continue をクリックします。
-
ドロップダウンから Selected Source を選び、Finish をクリックしてインストールを完了します。
推奨トピック
データ要件と、候補者が求人票 (requisition) にどのように関連付けられるかを理解するには、次のトピックを参照してください。
候補者の更新と重複排除
連携は、作成時に使用した Indeed のエイリアス付きメールアドレスで候補者またはプロスペクト (prospect) を検索します。候補者またはプロスペクトが見つかった場合は、次のとおりです。
- コアデータが更新されます。
- 新しい履歴書が添付されます。
- 既存の職歴と学歴が置き換えられます。
更新処理ではデータはマージされず、上書きされます。候補者の更新に、以前システムにあったすべてのデータが含まれない場合、そのデータは失われます。Indeed 連携が扱わないデータ（スクリーナー質問など）は影響を受けません。
データマッピング
Greenhouse では、候補者 (candidate) は求人に紐付いたプロスペクト (prospect) です。
既定ではプロスペクトが作成されます。同じメールアドレスの候補者が既に存在する場合は、プロスペクトを新規作成せず、その候補者が更新されます。
候補者 (Candidate)
| ローカル属性 | 説明 |
|---|---|
| 名 (First name) | 必須 |
| 姓 (Last name) | 必須 |
| 会社 (Company) | 任意 |
| 職種名 (Title) | 任意 |
| 電話番号 (Phone number) | 任意 |
| 住所 (Addresses) | 任意 |
| メールアドレス (Email addresses) | 必須 Indeed は Greenhouse の「Other」メールフィールドに設定します。空のリストを渡すと、すべてのメールアドレスがクリアされます。 重要: 候補者ごとに、実在するメールアドレスを既定の設定として使用してください。 |
| 学歴 (Education) | 任意 |
| 職歴 (Employment) | 任意 |
| タグ（スキル）(Tags (skills)) | 任意 |
| 応募 (Applications) | 任意 |
プロスペクト (Prospect)
| ローカル属性 | 説明 |
|---|---|
| 名 (First name) | 必須 |
| 姓 (Last name) | 必須 |
| 会社 (Company) | 任意 |
| 職種名 (Title) | 任意 |
| 電話番号 (Phone numbers) | 任意 |
| 住所 (Addresses) | 任意 |
| メールアドレス (Email addresses) | 必須 Indeed は Greenhouse の「Other」メールフィールドに設定します。空のリストを渡すと、すべてのメールアドレスがクリアされます。 重要: 候補者ごとに、実在するメールアドレスを既定の設定として使用してください。 |
| タグ (Tags) | 任意 |
| 応募 (Applications) | 任意 source_id、referrer、custom_fields、attachments パラメータは、「Add Application」エンドポイント (endpoint) の形式と一致します。 |
| Application[job-ids] | 任意 注記 応募オブジェクトが含まれていても、この値は空のまままたは省略でき、その場合リクエストは求人のないプロスペクトを作成します。典型的な用途は、求人のないプロスペクトを作成しつつ、履歴書を添付したりソースを識別したりする場合です。 |
関連オブジェクト
学歴 (Education) と職歴 (Employment) について、プロスペクトまたは候補者が既に存在する場合、Indeed は以前のデータを Indeed 側のデータで上書きします。
学歴 (Education)
重要: 教育機関の名称が Greenhouse サーバー上のレコードと一致しない場合、プラットフォームはその学歴に教育機関を保存しません。学位 (degree) と専攻分野 (discipline) についても同様です。
| ローカル属性 | 説明 |
|---|---|
| School ID | 在籍した学校の ID。「GET schools」エンドポイント (endpoint) から取得します。 |
| Discipline_id | 専攻分野の ID。「GET disciplines」エンドポイント (endpoint) から取得します。 |
| Degree ID | 取得した学位の種類。「GET degrees」エンドポイント (endpoint) から取得します。 |
| 開始日 (Start date) | 在籍開始日。タイムスタンプは ISO-8601 形式である必要があります。 |
| 終了日 (End date) | 在籍終了日。タイムスタンプは ISO-8601 形式である必要があります。 |
職歴 (Employment)
| ローカル属性 | 説明 |
|---|---|
| 会社名 (Company name) | 必須 |
| 職種名 (Title) | 必須 |
| 開始日 (Start date) | 必須 タイムスタンプは ISO-8601 形式である必要があります。 注記 特定の職歴エントリに開始日がない場合、プレースホルダとして |
| 終了日 (End date) | 任意 |
モニタリング
監査のため、On-Behalf-Of ヘッダー (header) にユーザー ID を設定することで、リクエストを発行したユーザーを追跡できます。
テスト操作
Greenhouse 連携には、連携ページから利用できるテスト操作が実装されています。
よくある質問
Greenhouse との Indeed 連携は、スクリーナー質問の回答を転送しますか。
いいえ。
Greenhouse との Indeed 連携は、Indeed 上で候補者を更新したときに Greenhouse の候補者も更新しますか。
いいえ。
候補者のエクスポートを手動でトリガーできますか。
いいえ。
候補者はいつ Greenhouse にエクスポートされますか。
候補者は応募したタイミングでエクスポートされます。応募送信後に発生する事象（面接、評価、応募者ステータスの更新など）は Greenhouse には転送されません。