Update Candidate（候補を更新）
Greenhouse内の候補の基本情報を編集します。
オプション
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
Pass Empty Values?（空の値を渡す？） |
フィールドの更新をスキップする代わりに、リモートシステムに空の値を渡すかどうかを示します。
このオプションはリストまたはオブジェクトにも影響しますが、ドロップダウンタイプには影響しません。 ［Pass Empty Values?（空白の値を渡す？）］を［Yes（はい）］に設定し、［First Name（名）］と［Last Name（姓）］を入力として選択した場合、これらのフィールドを空白にすることはできません。 |
ドロップダウン |
TRUE |
入力
すべてのJSONオブジェクト（オブジェクトリスト内のオブジェクトを含む）は、Edit Candidate APIのドキュメントの「カスタムフィールドパラメーター」セクションに記載されている形式に厳密に従う必要があります。
キー名には、常に小文字のテキストを使用します。
| フィールド | 定義 | タイプ | 必須 |
|---|---|---|---|
|
On Behalf Of（～に代わって） |
|||
|
User ID（ユーザーID） |
このリクエストを発行するユーザーのID。 監査目的では必須。 |
数値 | TRUE |
|
Candidates（候補） |
|||
|
ID |
この候補の一意の識別子。 |
数値 | TRUE |
|
Update（更新） |
|||
|
First Name（名） |
候補の新しい名。 選択した場合、このフィールドは空白にできません。 |
テキスト | FALSE |
|
Last Name（姓） |
候補の新しい姓。 選択した場合、このフィールドは空白にできません。 |
テキスト | FALSE |
|
Company（会社） |
候補の新しい企業。 |
テキスト | FALSE |
|
Title（役職） |
候補の新しい役職。 |
テキスト | FALSE |
|
Is Private（プライベート） |
ユーザーがプライベートである場合はtrueを選択します。 |
True/False | FALSE |
|
Phone Number（電話番号） |
候補の一連の電話番号。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
オブジェクトのリスト | FALSE |
|
Addresses（住所） |
候補の一連の住所。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
オブジェクトのリスト | FALSE |
|
Email Addresses（メールアドレス） |
候補の一連のメールアドレス。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
オブジェクトのリスト | FALSE |
|
Website Addresses（Webサイトアドレス） |
候補の一連のWebサイトアドレス。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
オブジェクトのリスト | FALSE |
|
Social Media Addresses（ソーシャルメディアアドレス） |
候補の一連のソーシャルメディアアドレス。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
オブジェクトのリスト | FALSE |
|
Recruiter（リクルーター） |
候補の新しいリクルーターを表すオブジェクト。 リクルーターのIDまたはメールアドレスが存在する必要があります。 |
オブジェクト | FALSE |
|
Coordinator（コーディネーター） |
候補の新しいコーディネーターを表すオブジェクト。 コーディネーターのIDまたはメールアドレスが存在する必要があります。 |
オブジェクト | FALSE |
|
Tags（タグ） |
候補の一連のタグ。 ［Pass Empty Values?（空白の値を渡す？）］が［Yes（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。 |
テキストのリスト | FALSE |
|
Custom Fields（カスタムフィールド） |
この候補の、更新されるすべてのカスタムフィールドが含まれるオブジェクト。 |
オブジェクトのリスト | FALSE |
出力
| フィールド | 定義 | タイプ |
|---|---|---|
|
Response （レスポンス） |
||
|
Status Code（ステータスコード） |
操作の結果。コネクターは、カードによって実行されたアクションの成否を示すHTTPステータスコードを返します。例：
発生する可能性があるステータスコードの完全なリストについては、「HTTPステータスコード」を参照してください。 |
数値 |