Indeed エントリー設定リファレンス
XMLフィードを通じてIndeed エントリーを設定するためのパラメーター、例、および制限事項です。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
Indeed エントリー設定パラメーターの制限事項
#XMLフィードでIndeed エントリーを設定する場合は、次の制限事項に従ってください。
-
パラメーター値は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です。XMLファイル内でURLエンコードしてください。
Indeed上の応募では、応募ボタンの
jobUrlは候補者が応募するIndeedのページです。https%3A%2F%2Fwww.yourcompany.com%2F%0Acareers%2Fyourjob123.htmlindeed-apply-jobId必須内部追跡用の求人IDです。
Indeed エントリーはこのIDを使用して重複する応募を検出します。
409ステータスコードをご覧ください。最大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候補者に表示されない追加情報です。Indeedは、各応募と共にこの情報を貴社の投稿URLに送信します。
right-rail-apply-buttonindeed-apply-apiToken必須Indeed エントリーの認証情報をリクエストしたときに受け取るclient IDです。
your-api-tokenindeed-apply-postUrl必須Indeedが応募データを送信するURLです。
XMLファイル内でURLエンコードしてください。URLではHTTPSと貴社のドメインを使用する必要があります。
このURLには、ユーザー名、パスワード、その他の個人を特定できる情報（PII）、埋め込みの認証情報を含めることはできません。
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です。optionalまたはhiddenを設定し、かつindeed-apply-resumefieldsoptionalまたはindeed-apply-resumefieldsrequiredを含めない場合は、審査用の質問を含める必要があります。.pdf、.doc、.docx、.rtf、.txt形式の履歴書を受け付ける必要があります。候補者は、ファイルをアップロードする代わりにIndeed Resumeで応募することもできます。
requiredindeed-apply-resumefieldsrequired日本のみ求職者にとって必須の履歴書フィールドのカンマ区切り一覧です。
phoneパラメーターより優先されます。Indeed エントリー履歴書フィールドの標準化をご覧ください。phone,gender,dateOfBirthindeed-apply-resumefieldsoptional日本のみ求職者にとって任意の履歴書フィールドのカンマ区切り一覧です。
phoneパラメーターより優先されます。Indeed エントリー履歴書フィールドの標準化をご覧ください。languages,educationindeed-apply-name文字列です。氏名を名と姓の別々のフィールドで表示するか（
indeed-apply-name=firstlastname）、1つのフィールドで表示するか（indeed-apply-name=fullname）を制御します。デフォルトは
fullnameです。Indeedではfirstlastnameを推奨しています。firstlastnameindeed-apply-questions求人に審査用の質問がある場合は必須求人の審査用の質問をJSONで返すURLです。
XMLファイル内でURLエンコードしてください。URLではHTTPSを使用する必要があります。
質問を作成するには、ATSパートナー向けIndeed エントリー連携ガイド > Indeed エントリーの審査用の質問を追加するをご覧ください。
https%3A%2F%2Fwww.yourcompany.com%2Fjob1234%2Fquestions.jsonindeed-apply-advNumIndeedが応募コンバージョンの帰属に使用する広告主番号です。
直接連携の採用企業の連携にのみ適用されます。
1432700306306892
Indeed エントリー履歴書フィールドの標準化
#indeed-apply-resumefieldsrequiredとindeed-apply-resumefieldsoptionalを使用して、Indeedが収集し、応募JSONデータに含める履歴書フィールドを選択します。Indeedは、求職者の履歴書ファイルの収集も試みます。
-
Indeedは各
indeed-apply-resumefieldsrequiredフィールドの入力を求め、resumeがhiddenでない限り、履歴書ファイルを必須にします。必須フィールドの情報を提供できない求職者は、そのフィールドをスキップして応募できます。たとえば、
positionsを必須にした場合、職歴のない求職者はそのステップをスキップでき、応募データからpositionsは省略されます。 -
indeed-apply-resumefieldsoptionalフィールドは求職者にとって任意です。indeed-apply-resumefieldsrequiredを設定しない場合、履歴書ファイルも任意になります。
resumeがhiddenの場合、Indeedは履歴書ファイルを収集しませんが、応募JSONデータにはindeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalのフィールドが含まれます。resumeがrequiredまたはoptionalの場合、Indeedはこのパラメーターを無視し、indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを使用して履歴書ファイルを収集します。
indeed-apply-resumefieldsrequiredまたはindeed-apply-resumefieldsoptionalを設定すると、Indeedはphoneパラメーターを無視し、namePronunciationを任意フィールドとして追加します。namePronunciationを必須にするには、indeed-apply-resumefieldsrequiredに追加してください。
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フィード例には、<indeed-apply-data>要素を含む1件の求人がありま す。
この例では、基本的な求人要素を空にしています。実際のフィードでは、必須要素に値を指定する必要があります。採用サイトに給与情報が掲載されていない場合、給与は任意です。
<?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 エントリーのXML configuration testing tool （新しいウィンドウで開きます）を使用します。直接連携の採用企業向けIndeed エントリー連携ガイド > Indeed エントリーの設定をテストするをご覧ください。