Indeed エン トリー設定リファレンス
XMLフィードを通じてIndeed エントリーを設定するためのパラメーター、例、および制限事項です。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
Indeed エントリー設定パラメーターの制限事項
XMLフィードを使用してIndeed エントリーを設定する場合は、次の制限事項に従ってください。
-
パラメーター値はURLエンコードしてください。
パラメーター値に
&または=が含まれる場合は、ペイロードが壊れないようにURLエンコードしてください。区切り文字として使用する
&と=はURLエンコードしないでください。たとえば、
&indeed-apply-jobId=Sample+ID&indeed-apply-jobCompanyName=My+Favorite&のように指定します。 -
フィード内のすべてのIndeed エントリーパラメーターに値を指定してください。値がない場合はエラーが発生します。
-
要素は大文字と小文字を区別しません。
たとえば、
<indeed-apply-jobCompanyName>と<indeed-apply-jobcompanyname>は同じです。 -
すべてのIndeed エントリー設定パラメーターは
<indeed-apply-で始めてください。Indeed エントリー要素は、改行と余分な空白を除去するために、設定を
CDATAセクションで囲みます。Indeed エントリー設定パラメーター パラメーター 説明 例 indeed-apply-jobUrl完全な求人説明の正規URLです。このURLはXMLファイル内でエンコードしてください。
Indeed上の応募では、応募ボタンの
jobUrlは応募が行われるIndeedのURLです。https%3A%2F%2Fwww.yourcompany.com%2F%0Acareers%2Fyourjob123.htmlindeed-apply-jobId必須内部追跡用の求人IDです。
Indeed エントリーではこの値を使用し、重複する応募を識別するために確認します。
409ステータスコードの説明でもこの求人IDに触れています。最大256 ASCII文字です。
7775e2bc62b7f77eindeed-apply-jobTitle必須外部に表示する求人タイトルです。最大50文字です。
XML内の
<title>フィールド値と一致している必要があります。Test Engineerindeed-apply-jobCompanyName必須会社名です。最大50文字です。
XML内の
<company>フィールド値と一致している必要があります。Your Companyindeed-apply-jobLocation必須求人の勤務地です。最大50文字です。
このフィールドには
<city>、<state>、<country>が必要です。New York, NY 10110indeed-apply-jobMeta追加情報です。この情報は外部には表示されませんが、候補者が投稿URLを通じて応募したときにIndeedが送信します。
right-rail-apply-buttonindeed-apply-apiToken必須Indeed エントリーの認証情報をリクエストしたときに受け取るclient IDの値です。
your-api-tokenindeed-apply-postUrl必須Indeedが応募データを送信するURLです。
このURLはXMLファイル内でエンコードしてください。
URLではHTTPSと貴社のドメインを使用する必要があります。
POSTURLには、ユーザー名、パスワード、その他のPIIなどの識別情報を含めることはできません。POSTURLに認証情報を埋め込まないでください。https%3A%2F%2Fwww.yourcompany.com%2Fprocess-applicationsindeed-apply-phone文字列です。求人に電話番号フィールドを表示するかどうかを制御します。
有効な値は
optional、hidden、requiredです。デフォルトは
optionalです。optionalindeed-apply-coverletter文字列です。
coverletterフィールドを必須にするかどうかを制御します。有効な値は
optional、hidden、requiredです。デフォルトは
optionalです。Indeedはカバーレターを自由記述テキストとして送信します。添付ファイルを想定している場合は、ファイルアップロードを求める審査用の質問の使用を検討してください。
requiredindeed-apply-resume履歴書を必須、任意、または非表示にするかどうかを制御します。
有効な値は
optional、hidden、requiredです。デフォルトはrequiredです。このパラメーターを含めない場合、値は
requiredに設定されます。optionalまたはhiddenを選択し、かつindeed-apply-resumefieldsoptionalまたはindeed-apply-resumefieldsrequiredを含めない場合は、審査用の質問を含める必要があります。.pdf、.doc、.docx、.rtf、.txtの履歴書形式をサポートする必要があります。候補者はアップロードの代わりにIndeed履歴書を使用することもできます。
requiredindeed-apply-resumefieldsrequired日本のみ求職者の履歴書に必ず表示する必要がある履歴書フィールドのカンマ区切り一覧です。このフィールドを設定すると、
phone設定パラメーターより優先されます。詳しくは、Indeed エントリー履歴書フィールドの標準化をご覧ください。phone,gender,dateOfBirthindeed-apply-resumefieldsoptional日本のみ求職者の履歴書にできれば表示してほ しい履歴書フィールドのカンマ区切り一覧です。このフィールドを設定すると、
phone設定パラメーターより優先されます。詳しくは、Indeed エントリー履歴書フィールドの標準化をご覧ください。languages,educationindeed-apply-name文字列です。氏名を名と姓に分割するか（
indeed-apply-name=firstlastname）、単一のフィールドで表示するか（indeed-apply-name=fullname）を制御します。デフォルトは単一フィールドです。Indeedでは
name=firstlastnameを推奨しています。firstlastnameindeed-apply-questions求人で必要な場合は必須Indeed エントリーの応募プロセス用に、質問をJSON形式の文字列で返すURLです。
このURLはXMLファイル内でエンコードしてください。URLではHTTPSを使用する必要があります。
質問の作成方法について詳しくは、ATSパートナー向けIndeed エントリー連携ガイド > Indeed エントリーの審査用の質問を追加するをご覧ください。
審査用の質問JSONファイルの例については、Example Indeed Apply Screener Questions JSON fileをご覧ください。
https%3A%2F%2Fwww.yourcompany.com%2Fjob1234%2Fquestions.jsonindeed-apply-advNum応募コンバージョンの帰属に使用する広告主番号です。
このフィールドはDirect Employer連携にのみ適用されます。
1432700306306892
Indeed エントリー履歴書フィールドの標準化
indeed-apply-resumefieldsrequiredとindeed-apply-resumefieldsoptionalを使用して、指定した応募URLに送信される応募JSONデータに含める履歴書情報を指定し、管理できます。Indeedはこれらのフィールドを収集し、求職者の履歴書ファイルも収集しようとします。
- その求人へのすべての応募には、指定した
indeed-apply-resumefieldsrequiredフィールドが含まれ、求職者は履歴書ファイルを送信する必要があります。 - 指定した
indeed-apply-resumefieldsoptionalフィールドは求職者にとって任意です。indeed-apply-resumefieldsrequiredを指定しない場合、履歴書ファイルも求職者にとって任意です。
注: resumeパラメーターがhiddenに設定されている場合、Indeedは求職者から履歴書ファイルを収集しません。ただし、indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを通じて収集したデータは応募JSONデータに含まれます。resumeパラメーターがrequiredまたはoptionalに設定されている場合、Indeedはそのパラメーターを無視し、indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを使用して履歴書ファイルを収集します。
indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを指定すると、Indeedはphoneパラメーターを無視します。
indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを指定すると、IndeedはnamePronunciationを設定していなくても自動的に任意フィールドとして含めます。必須にするには、明示的にrequiredに設定してください。
indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalには、次の履歴書フィールドを含めることができます。両方に同じフィールド名を指定した場合、Indeedはそれを必須として処理します。
| 履歴書フィールド標準化パラメーター名 | 回答が設定されるJSONノード位置 |
|---|---|
namePronunciation | applicant.fullNamePronunciation/firstNamePronunciation/lastNamePronunciation |
phone | applicant.phoneNumber |
dateOfBirth | applicant.dateOfBirth |
gender | applicant.gender |
location | applicant.resume.json.location |
positions | applicant.resume.json.positions |
education | applicant.resume.json.educations |
skills | applicant.resume.json.skills |
languages | applicant.resume.json.languages |
certifications | applicant.resume.json.certifications |
<indeed-apply-data> を含むXMLフィード
このXMLフィード例では、1件の求人と<indeed-apply-data>要素を定義しています。
この例では、わか りやすさのために基本的な求人要素を省略しています。実際のXMLフィードにはそれらを含める必要があります。
<?xml version="1.0" encoding="utf-8"?><source> <!--publisher is applicable to ATS developers only--> <publisher/> <!--publisherurl is applicable to ATS developers only--> <publisherurl/> <job> <title/> <date/> <referencenumber/> <requisitionid/> <url/> <company/> <sourcename/> <city/> <state/> <country/> <email/> <postalcode/> <description/> <salary/> <education/> <jobtype/> <category/> <experience/> <indeed-apply-data> <![CDATA [indeed-apply-apiToken=1234ABCDE&indeed-apply-jobTitle= Professional+Basket+Weaver&indeed-apply-jobId=Sample+ID &indeed-apply-jobCompanyName=My+Favorite+Company &indeed-apply-jobLocation=Austin+TX&indeed-apply-jobUrl= http%3A%2F%2Fwww.indeed.com&indeed-apply-postUrl= https%3A%2F%2Fhookb.in%2FPxOjJqJELNH8lZLZDkpz&indeed-apply-questions =https%3A%2F%2Fpastebin.com%2Fraw%2F0vXq9q9b%23]]> </indeed-apply-data> </job></source>Indeed エントリーメタデータをテストする
審査用の質問プロセス全体を含むIndeed エントリーの応募フローをテストするには、Indeed エントリーのXML configuration testing toolを使用します。詳しくは、直接連携の採用企業向けIndeed エントリー連携ガイド > Indeed エントリーの設定をテストするをご覧ください。