Greenhouseコネクションをv3に移行する
Greenhouseは、新しいコネクションにOAuth 2.0認可（v3）を使用します。 APIキー認証（v1/v2）は、既存のコネクションでのみ使用できます。
非推奨に関する注意
Greenhouseは2026年8月30日にv1およびv2 APIのサポートを削除します。 v1またはv2を使用するレシピは、この日付以降に機能しなくなります。 既存のすべてのレシピをv3に移行する必要があります。
Greenhouseは自動移行をサポートしていません。 v3コネクションに切り替えるときは、すべてのトリガーおよびアクションを手動で更新する必要があります。
オブジェクトサポートおよび必要なフィールド更新を理解するには、このガイドをGreenhouse v3オブジェクトカバレッジガイドと併用してください。
コネクションタイプおよびアクションの互換性
Greenhouse v3はOAuth 2.0認可および更新されたAPI動作を使用します。 APIキー認証（v1/v2）は、既存のコネクションでのみ使用できます。 これらのコネクションは、Greenhouseがv1およびv2 APIのサポートを削除する2026年8月30日に動作を停止します。
- OAuth 2.0認可を使用するコネクションはv3アクションのみをサポートします
- APIキー認証を使用するコネクションはv1/v2アクションのみをサポートします
v3コネクションでv1/v2アクションを使用したり、v1/v2コネクションでv3アクションを使用したりすることはできません。
既存のコネクションをv3にアップグレードすることもできません。 OAuth 2.0認可（v3）を使用する新しいコネクションを作成する必要があります。
既存のGreenhouseコネクションを確認する
v1またはv2を使用するすべてのGreenhouseコネクションを特定するには、次の手順を実行します:
Workatoアカウントにサインインします。
アセット > コネクションに移動します。
Greenhouseを検索して選択します。
コネクションを確認し、APIキー認証を使用しているコネクションを特定します。
依存するレシピを確認する
既存のGreenhouseコネクションを使用しているレシピを特定するには、次の手順を実行します:
Greenhouseコネクションを選択します。
Dependenciesセクションを見つけます。
リンクをクリックして依存関係グラフを開きます。
このコネクションを使用しているすべてのレシピを確認します。
Greenhouseコネクションごとにこれらの手順を繰り返します。
テスト用にレシピを準備する
変更を加える前に安全なEnvironmentを準備します。
テストEnvironmentでレシピバージョンを開くか、Environmentを使用していない場合はレシピを複製します。 別のバージョンをテストすると、プロダクションレシピを更新する前に移行の問題を特定できます。
レシピをGreenhouse v3に移行する
レシピをGreenhouse v3に移行するには、次の手順を実行します:
v3コネクションを作成する
v3コネクションを作成するには、次の手順を実行します:
アセット > コネクションに移動します。
作成 > コネクションをクリックするか、Cを2回押します。
Greenhouseを検索して選択します。
コネクション名フィールドに名前を入力します。
任意です。 必要なHarvest OAuthスコープを選択します。 空白のままにすると、Workatoはデフォルトのスコープセットを使用します。
任意です。 Custom domainフィールドに値を入力します。 デフォルトのHarvest APIホストhttps://harvest.greenhouse.ioを使用するには、空白のままにします。 組織でhttps://acme.greenhouse.ioなどのカスタムサブドメインを使用している場合は、acme.greenhouse.ioを入力します。
接続をクリックします。
Greenhouseアカウントにサインインし、アクセスを承認します。
トリガーおよびアクションを更新する
各v1アクションを対応するv3アクションに置き換え、設定を更新します。
レシピを開きます。
Greenhouseステップを選択します。
v1アクションを対応するv3アクションに置き換えます。
入力フィールドおよびマッピングを更新します。
レシピ内のすべてのGreenhouseステップに対して繰り返します。
サポートされるオブジェクト、フィールド、およびv1とv3のアクションとトリガーの違いを特定するには、Greenhouse v3オブジェクトカバレッジガイドを参照してください。
更新されたレシピをテストする
更新されたレシピが正しく機能することを検証します:
エディターでレシピを開きます。
テストレシピをクリックします。
各ステップの入力および出力を確認します。
エラーまたは一致しないフィールドを解決します。
更新されたすべてのレシピに対してテストを繰り返します。
更新されたレシピを有効化する
テスト後、更新されたレシピを有効化します:
プロダクションレシピを開きます。
すべてのGreenhouseステップでv3アクションおよびv3コネクションが使用されていることを確認します。
レシピを保存して開始します。
ワークスペースでEnvironmentを使用している場合は、開始する前に更新されたレシピをプロダクションにデプロイします。
v1からv3へのアクションマッピング
次の表を使用して、置換アクションおよび必要な更新を特定します。
| v1アクション | v3アクション | 移行に関する注記 |
|---|---|---|
| 添付ファイルをアップロード | 添付ファイルを作成（v3） | 直接置換 |
| オブジェクトを作成 | オブジェクトを作成（v3） | オブジェクトカバレッジの相違 |
| 候補者を採用済みにマーク | 候補者を採用済みにマーク（v3） | 大きな変更なし |
| 応募を進める | 応募を移動（v3） | 1:1の対応ではありません。 Moveはより広範な遷移をサポートします |
| 応募を却下 | 応募を却下（v3） | 直接置換 |
| オブジェクトを検索 | オブジェクトを検索（v3） | クエリパラメーターおよびオブジェクトカバレッジの相違 |
| オブジェクトを更新 | オブジェクトを更新（v3） | サポートされるオブジェクトの相違 |
| IDでオブジェクトを取得 | オブジェクトを検索（v3） | カンマ区切りのIDリストでフィルター |
v1とv3の主な違い
Greenhouse v3では、アクションの動作、検索機能、およびオブジェクトサポートに変更が導入されます。 一部のv1アクションはv3で使用できないため、別の方法が必要です。
より広範なアクション動作
Move application（v3）アクションはAdvance applicationアクションを置き換え、より広範な遷移をサポートします。 レシピロジックを確認し、想定どおりに動作することを確認します。
検索動作の変更
オブジェクトを検索（v3）アクションは、複数のv1パターンを置き換えます。 異なるクエリパラメーターを使用し、異なるオブジェクトカバレッジをサポートします。 それに応じてフィルターおよびクエリを更新します。
オブジェクトカバレッジの違い
オブジェクトサポートはv1とv3で異なります。 移行前に、レシピで使用されているオブジェクトが利用可能であることを確認します。
IDでオブジェクトを取得
Greenhouse v3には、IDでオブジェクトを取得アクションに直接相当するものはありません。 オブジェクトを検索（v3）を使用し、カンマ区切りのIDリストでフィルターします。
移行タイムライン
| 日付 | 説明 |
|---|---|
| 2026年3月 | Greenhouse v3のサポートがWorkatoで利用可能になります |
| 2026年8月15日 | v3への移行を完了 |
| 2026年8月30日 | Greenhouseがv1およびv2 APIのサポートを削除 |
最終期限までにテストの時間を確保するため、2026年8月15日までに移行を完了してください。
Last updated: