Greenhouse v3オブジェクト対応範囲

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

このガイドでは、Greenhouse v3のアクションとトリガーでサポートされるオブジェクトについて説明します。 オブジェクトの利用可否はアクションによって異なり、すべてのv1オブジェクトがv3で利用できるわけではありません。

このガイドは次の目的で使用します:

  • 各アクションとトリガーでサポートされるオブジェクトの特定
  • v1とv3のオブジェクト対応範囲の違いの理解
  • レシピをv3に移行する際の更新の計画

アクション対応範囲

アクション別にサポートされるオブジェクトについては、次のセクションを参照してください:

オブジェクトの検索(v3)

オブジェクトの検索 (v3) アクションは、Greenhouse v3エンドポイントからレコードを検索し、一致するオブジェクトのページ分割されたリストを返します。

サポートされるオブジェクト

次のオブジェクトがサポートされています:

  • 応募
  • 応募ステージ
  • 添付ファイル
  • 候補者
  • クローズ理由
  • カスタムフィールド部門
  • カスタムフィールドオフィス
  • カスタムフィールドオプション
  • カスタムフィールド
  • 部門
  • 面接
  • ジョブ採用マネージャー
  • ジョブ面接ステージ
  • ジョブ所有者
  • ジョブ投稿
  • ジョブ
  • オファー
  • オフィス
  • 求人枠
  • 見込み候補者プール
  • 紹介者
  • スコアカード
  • ソース
  • ユーザーメール
  • ユーザー

共通入力パラメーター

サポート対象オブジェクトで共通して利用できる入力フィールドは次のとおりです:

入力フィールドタイプ説明
オブジェクト選択リスト検索するオブジェクトタイプを選択します。
IDs配列(整数)特定のレコードIDでフィルターします。
作成日時(開始/終了)日付/時刻作成日の範囲でフィルターします。
更新日時(開始/終了)日付/時刻最終更新日の範囲でフィルターします。
ページあたり整数ページあたりのレコード数。
カーソル文字列次のページのページネーションカーソル。

追加フィールドはオブジェクトタイプによって異なります。 サポートされている場合は、次のオブジェクト別フィールドを使用します。

応募

Applicationsオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
ジョブID関連付けられたジョブIDでフィルターします。
候補者ID関連付けられた候補者IDでフィルターします。
ステージID応募ステージIDでフィルターします。
ソースIDソースIDでフィルターします。
Status応募ステータスでフィルターします。
見込み候補者見込み候補者ステータスでフィルターします。
最終アクティビティ日時(開始/終了)最終アクティビティ日の範囲でフィルターします。

候補者

Candidatesオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
メール候補者のメールでフィルターします。
タグ候補者タグでフィルターします。
非公開非公開候補者ステータスでフィルターします。
最終アクティビティ日時(開始/終了)最終アクティビティ日の範囲でフィルターします。
カスタムフィールドオプションIDカスタムフィールドオプションでフィルターします。

面接

Interviewsオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
応募ID関連付けられた応募IDでフィルターします。
候補者ID関連付けられた候補者IDでフィルターします。
ジョブID関連付けられたジョブIDでフィルターします。
ジョブ面接IDジョブ面接IDでフィルターします。
主催者ID主催者IDでフィルターします。
開始日時(開始/終了)面接開始時間の範囲でフィルターします。
終了日時(開始/終了)面接終了時間の範囲でフィルターします。
外部イベントID外部カレンダーイベントIDでフィルターします。

ジョブ

ジョブオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
Statusジョブステータスでフィルターします。
部門ID部門IDでフィルターします。
オフィスIDオフィスIDでフィルターします。
機密機密ジョブでフィルターします。
求人依頼ID採用申請IDでフィルターします。

オファー

Offersオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
応募ID関連付けられた応募IDでフィルターします。
ジョブID関連付けられたジョブIDでフィルターします。
候補者ID関連付けられた候補者IDでフィルターします。
Statusオファーステータスでフィルターします。
送信日(開始/終了)送信日の範囲でフィルターします。
開始日(開始/終了)開始日の範囲でフィルターします。
解決日時(開始/終了)解決日の範囲でフィルターします。

スコアカード

Scorecardsオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
応募ID関連付けられた応募IDでフィルターします。
候補者ID関連付けられた候補者IDでフィルターします。
面接キットID面接キットIDでフィルターします。
提出者ID提出者IDでフィルターします。
面接官ID面接官IDでフィルターします。
Statusスコアカードステータスでフィルターします。
面接日時(開始/終了)面接日の範囲でフィルターします。
提出日時(開始/終了)提出日の範囲でフィルターします。

オブジェクトの作成(v3)

オブジェクトの作成 (v3) アクションは、Greenhouseに新しいレコードを作成します。

サポート対象オブジェクト

次のオブジェクトがサポートされています:

  • 候補者
  • 候補者メモ
  • 候補者の学歴
  • 候補者の職歴
  • 候補者の応募
  • ジョブ
  • ユーザー

候補者

Candidateオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
候補者の名を指定します。
候補者の姓を指定します。
優先名候補者の希望名を指定します。
タイムゾーン候補者のタイムゾーンを指定します。
会社候補者の現在の会社を指定します。
タイトル候補者の現在の役職を指定します。
メール可候補者がメールを受信できるかどうかを指定します。
電話番号電話番号のリストを指定します。
住所住所のリストを指定します。
メールアドレスメールアドレスのリストを指定します。
WebサイトアドレスWebサイトURLのリストを指定します。
ソーシャルメディアアドレスソーシャルメディアプロフィールのリストを指定します。
タグ候補者に割り当てるタグのリストを指定します。
リンク済みユーザーID候補者に関連付けるユーザーIDを指定します。
カスタムフィールドフィールドトークンをキーにしたカスタムフィールド値を指定します。
アプリケーション関連付けられた応募を作成するための応募詳細を指定します。
応募(候補者内にネスト)

Applicationオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
ジョブID応募を作成する際にジョブIDを指定します。
見込み候補者候補者が見込み候補者かどうかを指定します。
見込み候補者プールID見込み候補者プールIDを指定します。
見込み候補者プールステージID見込み候補者プールステージIDを指定します。
見込み候補者所有者ID見込み候補者所有者のユーザーIDを指定します。
ソースIDソースIDを指定します。
採用担当者ID採用担当者のユーザーIDを指定します。
コーディネーターIDコーディネーターのユーザーIDを指定します。
紹介者ID紹介者のユーザーIDを指定します。
初期ステージID初期応募ステージIDを指定します。

候補者メモ

Candidate noteオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
候補者ID候補者IDを指定します。
Application ID応募IDを指定します。
本文メモの内容を指定します。
件名メモの件名を指定します。
メモタイプメモタイプを指定します。
ユーザーID作成者のユーザーIDを指定します。
メール送信元送信者のメールアドレスを指定します。
メール宛先受信者のメールアドレスを指定します。
メールCCCCのメールアドレスを指定します。
表示設定可視性を指定します。

候補者の学歴

Candidate educationオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
候補者ID候補者IDを指定します。
学校名学校名を指定します。
学位学位を指定します。
専攻分野専攻分野を指定します。
開始日開始日を指定します。
終了日終了日を指定します。

候補者の職歴

Candidate employmentオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
候補者ID候補者IDを指定します。
会社名会社名を指定します。
タイトル役職を指定します。
開始日開始日を指定します。
終了日終了日を指定します。

ジョブ

Jobオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
テンプレートジョブID設定のコピー元となるテンプレートジョブIDを指定します。
求人枠数求人枠数を指定します。
ジョブ名内部ジョブ名を指定します。
ジョブ投稿名ジョブ投稿名を指定します。
メモ内部メモを指定します。
部門ID部門IDを指定します。
外部部門ID外部部門IDを指定します。
オフィスIDオフィスIDを指定します。
外部オフィスID外部オフィスIDを指定します。
求人依頼ID採用申請IDを指定します。
求人枠ID求人枠IDを指定します。
カスタムフィールドフィールドトークンをキーにしたカスタムフィールド値を指定します。

ユーザー

Userオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
ユーザーの名を指定します。
ユーザーの姓を指定します。
Primary emailユーザーのメールアドレスを指定します。
従業員ID従業員IDを指定します。
役職役職を指定します。
代理店ID代理店IDを指定します。
オフィスID関連付けられたオフィスIDを指定します。
部門ID関連付けられた部門IDを指定します。

オブジェクトの更新(v3)

オブジェクトの更新 (v3) アクションは、Greenhouseの既存のレコードを更新します。 オブジェクトタイプとレコードIDを指定します。

サポート対象オブジェクト

次のオブジェクトがサポートされています:

  • 候補者
  • 候補者の応募
  • ジョブ
  • ユーザー

候補者

Candidateオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
ID候補者IDを指定します。
Createのすべての候補者フィールドCreate objectアクションの任意の候補者フィールドを指定します。 指定したフィールドのみが更新されます。

候補者の応募

Candidate applicationオブジェクトでは、次の追加フィールドがサポートされています:

パラメーター説明
ID応募IDを指定します。
ソースIDソースIDを指定します。
紹介者ID紹介者IDを指定します。
採用担当者ID採用担当者IDを指定します。
コーディネーターIDコーディネーターIDを指定します。
見込み候補者プールID見込み候補者プールIDを指定します。
見込み候補者プールステージID見込み候補者プールステージIDを指定します。
不採用日時不採用日を指定します。
作成日時作成日時を指定します。
カスタムフィールドフィールドトークンをキーにしたカスタムフィールド値を指定します。

ジョブ

Jobオブジェクトでは、次の追加フィールドがサポートされています:

入力フィールド説明
IDジョブIDを指定します。
CreateのすべてのジョブフィールドCreate objectアクションの任意のジョブフィールドを指定します。 指定したフィールドのみが更新されます。

ユーザー

Userオブジェクトでは、次の追加フィールドがサポートされています:

入力フィールド説明
IDユーザーIDを指定します。
CreateのすべてのユーザーフィールドCreate objectアクションの任意のユーザーフィールドを指定します。 指定したフィールドのみが更新されます。

添付の作成(v3)

添付ファイルの作成 (v3) アクションは、ファイル添付を応募にアップロードします。

入力

次の入力フィールドを利用できます:

入力フィールド説明
Application IDファイルを添付する応募IDを指定します。
ファイル名拡張子を含むファイル名を指定します。
タイプ添付タイプを指定します。
コンテンツファイルコンテンツをBase64エンコード文字列として指定します。 URLが指定されていない場合は必須です。
URL直接ファイルURLを指定します。 Contentが指定されていない場合は必須です。
表示設定可視性設定を指定します。

応募の移動(v3)

応募の移動 (v3) アクションは、応募を別のステージに移動するか、別のジョブに転送します。

入力

次の入力フィールドを利用できます:

入力フィールド説明
Application ID移動する応募IDを指定します。
From stage ID応募の現在のステージIDを指定します。
移動先ステージID同じジョブ内の移動先ステージIDを指定します。 これを使用して、応募をパイプライン内で前後に移動します。
移動先ジョブID応募を別のジョブに転送する移動先ジョブIDを指定します。
メール送信元ユーザーID通知メールを送信するユーザーIDを指定します。

応募の不採用(v3)

応募の却下 (v3) アクションは、応募を却下し、必要に応じて却下メールを送信します。

入力

次の入力フィールドを利用できます:

入力フィールド説明
Application ID不採用にする応募IDを指定します。
却下理由ID不採用理由IDを指定します。
メモ不採用に関する内部メモを指定します。
メール送信日時不採用メールを送信する日時を指定します。
メールテンプレートID不採用メールに使用するメールテンプレートIDを指定します。
メール送信元ユーザーID不採用メールを送信するユーザーIDを指定します。
カスタムフィールドカスタムフィールド値を指定します。 各項目にはフィールド識別子と値を含める必要があります。

候補者を採用済みにマーク(v3)

候補者を採用済みにマーク (v3) アクションは、応募を採用済みとしてマークし、必要に応じて開始日、オープニング、およびクローズ理由を割り当てます。

入力

次の入力フィールドを利用できます:

入力フィールド説明
Application ID採用済みとしてマークする応募IDを指定します。
開始日候補者の開始日を指定します。
求人枠ID採用に関連付ける求人枠IDを指定します。
クローズ理由ID採用のクローズ理由IDを指定します。

トリガー対応範囲

トリガー別にサポートされるオブジェクトについては、次のセクションを参照してください:

新規オブジェクト(v3)

新規オブジェクト (v3) トリガーは、Greenhouseで新しいレコードが作成されたときに起動します。 カーソルベースのポーリングを使用します。

サポート対象オブジェクト

次のオブジェクトがサポートされています:

  • 候補者
  • 応募
  • 面接

入力

次の入力フィールドを利用できます:

入力フィールド説明
オブジェクト監視するオブジェクトタイプを選択します。
開始日初回取得の開始タイムスタンプを指定します。 デフォルトは初回実行の1時間前です。

出力

選択したオブジェクトタイプの完全なオブジェクトフィールドを返します。

新規/更新済みオブジェクト(v3)

新規/更新済みオブジェクト (v3) トリガーは、Greenhouseでレコードが作成または更新されたときに起動します。 レコードをバッチで返します。

サポート対象オブジェクト

次のオブジェクトがサポートされています:

  • 候補者
  • 応募
  • ジョブ投稿
  • ジョブ
  • オファー
  • 面接
  • スコアカード

入力

次の入力フィールドを利用できます:

入力フィールド説明
オブジェクト監視するオブジェクトタイプを選択します。
開始初回取得の開始タイムスタンプを指定します。 デフォルトは初回実行の1時間前です。
バッチサイズバッチあたりのレコード数を指定します。

出力

選択したオブジェクトタイプの完全なオブジェクトフィールドを返します。

レガシー(v1)からv3へのマッピング

このセクションでは、レガシー(v1)アクションとトリガーがv3の同等機能にどのように対応するかを説明します。

アクション

次のマッピングでは、レガシー(v1)アクションがv3アクションおよびサポート対象オブジェクトにどのように対応するかを説明します。

Create object(v1)とCreate object(v3)

v3のCreate objectアクションは、サポート対象エンティティ全体のオブジェクト作成を統合して標準化します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
候補者候補者
候補者メモ候補者メモ
候補者の学歴候補者の学歴
候補者の職歴候補者の職歴
候補者の応募候補者の応募
ジョブジョブ
ユーザーユーザー

候補者メールメモにはv3の同等機能がありません。

Update object(v1)とUpdate object(v3)

v3のUpdate objectアクションは作成と同じオブジェクトモデルを使用し、指定したフィールドのみを更新します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
候補者候補者
アプリケーション候補者の応募
ジョブジョブ
ユーザーユーザー

Search objects(v1)とSearch objects(v3)

v3のSearch objectsアクションはオブジェクト対応範囲を拡張し、統一された検索インターフェースを導入します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
候補者候補者
アプリケーション応募
ジョブジョブ
オファーオファー
ユーザーユーザー
スコアカードスコアカード
見込み候補者プール見込み候補者プール

Degree、School、およびDisciplineには直接のv3検索エンドポイントがありません。

Upload attachment(v1)とCreate attachment(v3)

v3のCreate attachmentアクションは、応募へのファイルアップロードをサポートします。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
応募の添付添付ファイル

候補者の添付には直接のv3同等機能がありません。

Advance application(v1)とMove application(v3)

v3のMove applicationアクションはadvance applicationに置き換わり、ステージ移動とジョブ転送をサポートします。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
アプリケーションアプリケーション

Reject application(v1)とReject application(v3)

v3のReject applicationアクションは同じ主要な動作を維持し、任意のメール制御を追加します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
アプリケーションアプリケーション

Mark candidate as hired(v1)とMark candidate as hired(v3)

v3のMark candidate as hiredアクションは同じ動作を維持し、開始日や求人枠などの任意フィールドを追加します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
アプリケーションアプリケーション

トリガー

次のマッピングでは、レガシー(v1)トリガーがv3トリガーおよびサポート対象オブジェクトにどのように対応するかを説明します。

New object(v1)とNew object(v3)

v3トリガーは、カーソルベースのポーリングで新規作成されたレコードを検出します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
候補者候補者
アプリケーションアプリケーション
スケジュール済み面接スケジュール済み面接

New/updated object(v1)とNew/updated object(v3)

v3トリガーは、作成および更新されたレコードを検出し、結果をバッチで返します。

次の表は、v1オブジェクトがv3にどのように対応するかを示しています:

v1オブジェクトv3オブジェクト
候補者候補者
アプリケーションアプリケーション
ジョブ投稿ジョブ投稿
ジョブジョブ
オファーオファー
スケジュール済み面接スケジュール済み面接
スコアカードスコアカード

Last updated: