Update Candidate（候補を更新）

Greenhouse内の候補の基本情報を編集します。

オプション

フィールド	定義	タイプ	必須
Pass Empty Values?（空の値を渡す？）	フィールドの更新をスキップする代わりに、リモートシステムに空の値を渡すかどうかを示します。［はい］：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、その空のフィールドが更新に含まれます。これにより、リモートシステム上にあるそのフィールドの既存の値が消去されます。［いいえ］：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、リモートシステム上のそのフィールドには何も送信されません。リモートシステム上の既存の値は変更されません。このオプションはリストまたはオブジェクトにも影響しますが、ドロップダウンタイプには影響しません。［Pass Empty Values?（空白の値を渡す？）］を［Yes（はい）］に設定し、［First Name（名）］と［Last Name（姓）］を入力として選択した場合、これらのフィールドを空白にすることはできません。	ドロップダウン	正

フィールド

定義

タイプ

必須

Pass Empty Values?（空の値を渡す？）

フィールドの更新をスキップする代わりに、リモートシステムに空の値を渡すかどうかを示します。

［はい］：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、その空のフィールドが更新に含まれます。これにより、リモートシステム上にあるそのフィールドの既存の値が消去されます。
［いいえ］：カードの入力フィールドが空白の場合、またはnull値が指定されている場合、リモートシステム上のそのフィールドには何も送信されません。リモートシステム上の既存の値は変更されません。

このオプションはリストまたはオブジェクトにも影響しますが、ドロップダウンタイプには影響しません。

［Pass Empty Values?（空白の値を渡す？）］を［Yes（はい）］に設定し、［First Name（名）］と［Last Name（姓）］を入力として選択した場合、これらのフィールドを空白にすることはできません。

ドロップダウン

正

入力

すべての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（はい）］に設定されている場合、空の配列を渡すとすべての値が消去されます。	テキストのリスト	誤
Custom Fields（カスタムフィールド）	この候補の、更新されるすべてのカスタムフィールドが含まれるオブジェクト。	オブジェクトのリスト	誤

出力

フィールド	定義	タイプ
Response （レスポンス）
Status Code（ステータスコード）	操作の結果。コネクターは、カードによって実行されたアクションが成功したか失敗したかを示す、HTTPステータスコードを返します。例： 201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。 403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。発生する可能性があるステータスコードの完全なリストについては、「HTTPステータスコード」を参照してください。	数値

フィールド

定義

タイプ

Response （レスポンス）

Status Code（ステータスコード）

操作の結果。コネクターは、カードによって実行されたアクションが成功したか失敗したかを示す、HTTPステータスコードを返します。例：

201 Createdステータスコードは、アクションが成功し、新しいリソースが作成されたことを示します。
403 Forbiddenエラーは、必要な権限が不足していたためにHTTPリクエストが処理されなかったことを示します。

発生する可能性があるステータスコードの完全なリストについては、「HTTPステータスコード」を参照してください。

数値

Update Candidate（候補を更新）

オプション

入力

出力

関連項目