Update Candidate(候補を更新)

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

オプション

フィールド 定義 タイプ 必須

Pass Empty Values?(空の値を渡す?)

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

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

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

[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ステータスコードを返します。例:

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

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

数値

関連項目

Greenhouseコネクター

Workflows要素

Greenhouse Harvest API