Product UpdatesStatus PageWorkato Academy
English
日本語
Get a trial
コネクター
アプリコネクター

Greenhouse ​

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

Greenhouseは、企業がより優れた採用プロセスを構築し、次のステップに向けた採用を行えるように設計された応募者追跡システムおよび採用ソフトウェアです。

Greenhouseコネクターを使用すると、応募者と候補者のワークフローに関する自動化をさらに構築し、他の人材管理システムと連携できます。

ユースケース ​

GreenhouseをHRおよびITシステムに接続して、採用とオンボーディングを自動化します。 Greenhouseコネクターを他のアプリと連携して、候補者データの同期、オンボーディングの自動化、HRおよびITワークフロー全体の効率向上を実現できます。 Greenhouseコネクターを使用して強力なマルチアプリワークフローを作成する方法については、ユースケースをご覧ください。

Greenhouseのユースケース例

APIバージョン ​

Greenhouseコネクターは、レガシー（v1/v2）とv3 APIの両方を使用します。

  • APIキー認証はv1/v2 APIを使用します
  • OAuth 2.0認可コードグラント認証はv3 APIを使用します

移行が必要

コネクションでAPIキー認証（v1/v2）を使用している場合は、2026年08月30日までにOAuth 2.0認可コードグラント認証に移行し、すべてのv1/v2トリガーおよびアクションを対応するv3のものに置き換えてください。 Greenhouseは、この日にv1およびv2 APIのサポートを終了します。

詳細については、Greenhouse v3移行ガイドおよびGreenhouse v3オブジェクトカバレッジガイドを参照してください。

APIキー認証を使用する既存のコネクションは、2026年08月30日まで引き続き実行されます。

コネクションの設定 ​

Greenhouseコネクターは、次の認証タイプをサポートしています:

APIキー認証を使用するコネクションはv1/v2アクションのみをサポートし、OAuth 2.0を使用するコネクションはv3アクションのみをサポートします。

新規Greenhouseコネクションは、OAuth 2.0認可コードグラント認証のみをサポートしています。 APIキー認証は既存のコネクションでのみ使用できます。

APIキー認証を使用している場合は、Greenhouse v3移行ガイドを参照して、既存のコネクションとレシピを移行してください。

OAuth 2.0認可コードグラント認証（v3） ​

OAuth 2.0認可コードグラント認証を使用して、v3 APIでGreenhouseに接続します。 これは、すべての新規コネクションのデフォルト認証方法です。

最小スコープとデフォルトスコープ ​

Harvest OAuthスコープは、WorkatoがGreenhouseインスタンスに対して持つアクセスレベルを定義します。

最小スコープを表示

特定のスコープを選択すると、次のスコープが常に含まれます:

  • harvest:users:list
デフォルトスコープを表示

このリスト内のすべてのスコープは、Harvest OAuthスコープフィールドを空白のままにした場合にリクエストされます:

  • harvest:application_stages:list
  • harvest:applications:convert_to_candidate
  • harvest:applications:create
  • harvest:applications:destroy
  • harvest:applications:hire
  • harvest:applications:list
  • harvest:applications:move
  • harvest:applications:reject
  • harvest:applications:unreject
  • harvest:applications:update
  • harvest:approval_flows:create
  • harvest:approval_flows:list
  • harvest:approval_flows:request_approvals
  • harvest:approval_flows:update
  • harvest:attachments:create
  • harvest:attachments:destroy
  • harvest:attachments:list
  • harvest:candidate_educations:create
  • harvest:candidate_employments:create
  • harvest:candidates:anonymize
  • harvest:candidates:create
  • harvest:candidates:destroy
  • harvest:candidates:list
  • harvest:candidates:merge
  • harvest:candidates:update
  • harvest:close_reasons:list
  • harvest:custom_field_departments:list
  • harvest:custom_field_offices:list
  • harvest:custom_field_options:create
  • harvest:custom_field_options:destroy
  • harvest:custom_field_options:list
  • harvest:custom_field_options:update
  • harvest:custom_fields:create
  • harvest:custom_fields:destroy
  • harvest:custom_fields:list
  • harvest:custom_fields:update
  • harvest:departments:create
  • harvest:departments:list
  • harvest:departments:update
  • harvest:email_templates:list
  • harvest:interviews:create
  • harvest:interviews:destroy
  • harvest:interviews:list
  • harvest:interviews:update
  • harvest:job_hiring_managers:list
  • harvest:job_interview_stages:list
  • harvest:job_owners:list
  • harvest:job_posts:list
  • harvest:jobs:create
  • harvest:jobs:list
  • harvest:jobs:update
  • harvest:notes:create
  • harvest:notes:list
  • harvest:offers:create
  • harvest:offers:list
  • harvest:offers:update
  • harvest:offices:create
  • harvest:offices:list
  • harvest:offices:update
  • harvest:openings:list
  • harvest:prospect_pools:list
  • harvest:referrers:list
  • harvest:rejection_reasons:list
  • harvest:scorecard_question_answers:list
  • harvest:scorecards:list
  • harvest:sources:list
  • harvest:user_emails:list
  • harvest:users:activate
  • harvest:users:create
  • harvest:users:deactivate
  • harvest:users:list
  • harvest:users:revoke_permissions
  • harvest:users:update

OAuth 2.0認可コードグラント認証でGreenhouseに接続する ​

WorkatoでGreenhouseへのOAuth 2.0認可コードグラント認証コネクションを設定するには、次の手順を実行します:

1

作成 > コネクションをクリックするか、Cを2回押します。

2

Greenhouseを検索し、アプリとして選択します。

3

コネクション名フィールドにコネクションの名前を入力します。

OAuth 2.0を使用した認証OAuth 2.0を使用した認証

4

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

5

任意です。 必要なHarvest OAuthスコープを選択します。 詳細については、最小スコープとデフォルトスコープを参照してください。

6

任意です。 Custom domainフィールドに値を入力します。 デフォルトのHarvest APIホストhttps://harvest.greenhouse.ioを使用するには、空白のままにします。 組織でhttps://acme.greenhouse.ioなどのカスタムサブドメインを使用している場合は、acme.greenhouse.ioを入力します。

7

接続をクリックします。

8

Greenhouseアカウントにサインインし、アクセスを承認します。

APIキー認証（v1/v2） ​

非推奨の認証

Greenhouseは、2026年08月30日にv1およびv2 APIのサポートを終了します。 新規コネクションにはOAuth 2.0認可コードグラント認証を使用してください。

APIキー認証を使用して、レガシーAPIを使用する既存のGreenhouseコネクションを管理します。 APIキー認証は新規コネクションでは使用できません。

APIキー認証のGreenhouseセットアップ ​

Workatoとの連携には、Integration System User（ISU）を使用することをお勧めします。 これにより、権限の一貫性が確保され、すべての操作を単一のアカウントにログとして記録できます。

APIトークンの作成 ​

GreenhouseでAPIトークンを作成するには、次の手順を実行します。

1

Settings > Dev Center > API Credential Managementに移動します。

2

Workato用の新しいAPIキーを作成するには、Harvest v3 (OAuth) またはHarvest v1/v2を選択します。

3

Create new API credentials（新しいAPI認証情報を作成）をクリックします。

4

API type（APIタイプ）ドロップダウンメニューを使用して、HarvestまたはHarvest V3 (OAuth) のいずれかを選択します。

5

Partners（パートナー）ドロップダウンメニューを使用して、Workatoを選択します。

6

Description（説明）フィールドを使用して、APIの説明を入力します。

7

Manage permissionsをクリックします。

8

Workatoで使用するために、API key（APIキー）をコピーして保存します。

9

Closeをクリックします。

10

このAPIキーに必要な権限を付与します。 詳細については、Harvest APIの最小権限を参照してください。

権限

このAPI認証情報に正しい権限を付与していることを確認します。 権限が正しくない場合、コネクションが成功していても、一部のGreenhouseコネクターのアクションとトリガーが動作しないことがあります。

11

保存をクリックします。

Harvest APIの最小権限 ​

Greenhouseコネクターには、特定のHarvest APIオブジェクトへのアクセス権を持つAPIキーが必要です。 これらの権限により、すべてのトリガーとアクションが正しく機能します。 たとえば、応募を却下アクションにはApplications権限が必要です。

Workato用のHarvest APIキーを作成するときは、次の権限を付与します。 これらの権限は、標準のコネクター操作をサポートします。

  • Applications
  • Candidates
  • Close Reasons
  • Custom Field Options
  • Custom Fields
  • Departments
  • Education
  • Job Openings
  • Job Posts
  • Jobs
  • Offers
  • Offices
  • Rejection Reasons
  • Scheduled Interviews
  • Scorecards
  • Sources
  • Tags
  • Tracking Links
  • Users
    • Get: Retrieve User
    • Get: List Users

GreenhouseのAPI credentialページで、各APIキーの権限を表示および管理できます。

403 Forbiddenエラーが発生した場合、APIキーに必要な権限がない可能性があります。 APIキーの権限を確認し、リストされているすべてのオブジェクトが選択されていることを確認してください。 詳細については、Greenhouse Harvest APIドキュメントを参照してください。

APIキー認証（v1/v2）を使用してGreenhouseに接続する ​

レガシーAPIを使用してWorkatoでGreenhouseへのAPIキー認証コネクションを設定するには、次の手順を実行します:

1

作成 > コネクションをクリックするか、Cを2回押します。

2

Greenhouseを検索し、アプリとして選択します。

3

コネクション名フィールドにコネクションの名前を入力します。

4

ロケーションドロップダウンメニューを使用して、コネクションを保存するプロジェクトを選択します。

5

Greenhouse APIトークンをAPI keyフィールドに入力します。 詳細については、APIトークンの作成を参照してください。

6

On-Behalf-Of userドロップダウンメニューを使用して、On-Behalf-OfヘッダーのGreenhouseユーザーを選択します。 オプションにはUser emailとUser IDがあります。

7

このAPIトークンに関連付けられたメールアドレスまたはユーザーIDをUser email / User IDフィールドに入力します。

8

任意です。 Custom domainフィールドに値を入力します。 デフォルトのHarvest APIホストhttps://harvest.greenhouse.ioを使用するには、空白のままにします。 組織でhttps://acme.greenhouse.ioなどのカスタムサブドメインを使用している場合は、acme.greenhouse.ioを入力します。

9

接続をクリックします。

Last updated: