Update Candidate（候補を更新）

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

オプション

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

入力

フィールド	定義	タイプ	必須
候補（Candidates）
ID	この候補の一意の識別子。	数値	正
名（First Name）	候補の新しい名。	テキスト	FALSE
姓（Last Name）	候補の新しい姓。	テキスト	FALSE
希望呼称（Preferred Name）	候補者の希望する名前。	テキスト	FALSE
タイムゾーン	候補者の新しいタイムゾーン。	ドロップダウン	FALSE
会社（Company）	候補の新しい企業。	テキスト	FALSE
役職名（Title）	候補の新しい役職。	テキスト	FALSE
プライベート（Is Private）	候補者プロファイルがプライベートである場合はtrueを選択します。	True/False	FALSE
メール送信可能	候補者にメールを送信できます。	True/False	FALSE
電話番号（Phone Numbers）	候補の一連の電話番号。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	オブジェクトのリスト	FALSE
住所（Addresses）	候補者のプロファイルにある郵便住所。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	オブジェクトのリスト	FALSE
メールアドレス（Email Addresses）	候補の一連のメールアドレス。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	オブジェクトのリスト	FALSE
Webサイトアドレス（Website Addresses）	候補の一連のWebサイトアドレス。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	オブジェクトのリスト	FALSE
ソーシャルメディアアドレス（Social Media Addresses）	候補の一連のソーシャルメディアアドレス。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	オブジェクトのリスト	FALSE
タグ	候補の一連のタグ。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	テキストのリスト	FALSE
リンクされたユーザーID（Linked User IDs）	社内応募者の場合、候補者にリンクされているGreenhouseユーザーID。空白の値を渡す？（Pass Empty Values?）が`Yes`に設定されている場合、空の配列を渡すとすべての値が消去されます。	数値のリスト	FALSE
カスタムフィールド（Custom Fields）	この候補者を更新するためのすべてのカスタムフィールドが含まれるカスタムフィールドオブジェクトのリスト。注: 各オブジェクトは、候補者を更新（Update Candidate） APIのドキュメントのカスタムフィールドパラメーター（Edit User）セクションに記載されている形式に厳密に従う必要があります。	オブジェクトのリスト	FALSE

出力

フィールド	定義	タイプ
基本情報（Basic Information）
ID	候補の一意の識別子。	数値
名（First Name）	候補者の名。	テキスト
姓（Last Name）	候補者の姓。	テキスト
希望呼称（Preferred Name）	候補者の希望する氏名。	テキスト
タイムゾーン	候補者のタイムゾーン。注: このフィールドの出力は他の候補者カードの入力には使用できません。	テキスト
会社（Company）	候補が現在勤務する企業。	テキスト
役職名（Title）	候補の現在の役職。	テキスト
作成日時（Created At）	候補者プロファイルの作成日時。この値の形式はISO-8601です。	日時
更新日時（Updated At）	候補者プロファイルの更新日時。この値の形式はISO-8601です。	日時
最終アクティビティ日時（Last Activity At）	候補が最後にアクティブになっていた日時。この値の形式はISO-8601です。	日時
プライベート（Is Private）	trueの場合、候補者はプライベート候補者の表示（View Private Candidates）アクセス権を持つユーザーに制限されます。	True/False
電話番号（Phone Numbers）	候補の一連の電話番号。	オブジェクトのリスト
住所（Addresses）	候補者の住所の配列。	オブジェクトのリスト
メールアドレス（Email Addresses）	候補の一連のメールアドレス。	オブジェクトのリスト
Webサイトアドレス（Website Addresses）	候補の一連のWebサイトアドレス。	オブジェクトのリスト
ソーシャルメディアアドレス（Social Media Addresses）	候補の一連のソーシャルメディアアドレス。	オブジェクトのリスト
メール送信可能	候補へのメール連絡が可能であればtrueが返されます。	True/False
タグ（Tags）	候補の一連のタグ。	テキストのリスト
リンクされたユーザーID（Linked User IDs）	社内応募者の場合、候補者にリンクされているGreenhouseユーザーID。	数値のリスト
カスタムフィールド（Custom Fields）
候補レコードのカスタムフィールド。	実際のカスタムフィールド定義に基づきます。	実際のカスタムフィールドタイプによって異なる
すべてのカスタムフィールド（All Custom Fields）	この候補のすべてのカスタムフィールド。	オブジェクト

一般的なカスタムフィールドを容易に取得できるように、このカードにはカスタムフィールド（Custom Fields）出力グループに一覧表示される30の個別フィールドがあります。

返されるこれら30のカスタムフィールドは、候補のカスタムオプション（Candidates Custom Options）構成ページに表示される順序で上位30のカスタムフィールドです。この順序は、特定の候補を編集する際に情報ページに表示されるカスタムフィールドの順序とも同じです。

注:

既存のカスタムフィールドが500を上回り、500より上の位置から最初の30フィールド内に手動で移動した場合、30のカスタムフィールド出力には含まれない可能性があります。この場合、Object.Get関数カードを使ってすべてのカスタムフィールド（All Custom Fields）出力内の任意のカスタムフィールドを特定できます。

候補のカスタムオプション（School Name）構成ページには、学校名（School Name）（Degree）、学位（Degree）（Discipline）、学科（Discipline）（Candidates Custom Options）は表示されません。これらのフィールドはシステムがデフォルトで構成するため、候補者の読み取り（Read Candidate）エンドポイントからのcustom_fieldsペイロードには返されません。