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.html
  indeed-apply-jobId	必須 内部追跡用の求人 ID です。 Indeed エントリーではこの値を使用し、重複する応募を識別するために確認します。409 ステータスコードの説明でもこの求人 ID に触れています。 最大 256 ASCII 文字です。	7775e2bc62b7f77e
  indeed-apply-jobTitle	必須 外部に表示する求人タイトルです。最大 50 文字です。 XML 内の <title> フィールド値と一致している必要があります。	Test Engineer
  indeed-apply-jobCompanyName	必須 会社名です。最大 50 文字です。 XML 内の <company> フィールド値と一致している必要があります。	Your Company
  indeed-apply-jobLocation	必須 求人の勤務地です。最大 50 文字です。 このフィールドには <city>、<state>、<country> が必要です。	New York, NY 10110
  indeed-apply-jobMeta	追加情報です。この情報は外部には表示されませんが、候補者が投稿 URL を通じて応募したときに Indeed が送信します。	right-rail-apply-button
  indeed-apply-apiToken	必須 Indeed エントリーの認証情報をリクエストしたときに受け取る client ID の値です。 API トークンを生成するをご覧ください。	your-api-token
  indeed-apply-postUrl	必須 Indeed が応募データを送信する URL です。 この URL は XML ファイル内でエンコードしてください。 URL では HTTPS と貴社のドメインを使用する必要があります。 POST URL には、ユーザー名、パスワード、その他の PII などの識別情報を含めることはできません。POST URL に認証情報を埋め込まないでください。	https%3A%2F%2Fwww.yourcompany.com %2Fprocess-applications
  indeed-apply-phone	文字列です。求人に電話番号フィールドを表示するかどうかを制御します。 有効な値は optional、hidden、required です。 デフォルトは optional です。	optional
  indeed-apply-coverletter	文字列です。coverletter フィールドを必須にするかどうかを制御します。 有効な値は optional、hidden、required です。 デフォルトは optional です。 Indeed はカバーレターを自由記述テキストとして送信します。添付ファイルを想定している場合は、ファイルアップロードを求めるスクリーナー質問の使用を検討してください。	required
  indeed-apply-resume	履歴書を必須、任意、または非表示にするかどうかを制御します。 有効な値は optional、hidden、required です。デフォルトは required です。 このパラメーターを含めない場合、値は required に設定されます。optional または hidden を選択し、かつ indeed-apply-resumefieldsoptional または indeed-apply-resumefieldsrequired を含めない場合は、スクリーナー質問を含める必要があります。 .pdf、.doc、.docx、.rtf、.txt の履歴書形式をサポートする必要があります。候補者はアップロードの代わりに Indeed 履歴書を使用することもできます。	required
  indeed-apply-resumefieldsrequired	日本のみ 求職者の履歴書に必ず表示する必要がある履歴書フィールドのカンマ区切り一覧です。このフィールドを設定すると、上記の phone 設定パラメーターより優先されます。詳しくは、Indeed エントリー履歴書フィールドの標準化をご覧ください。	phone, gender, dateOfBirth
  indeed-apply-resumefieldsoptional	日本のみ 求職者の履歴書にできれば表示してほしい履歴書フィールドのカンマ区切り一覧です。このフィールドを設定すると、上記の phone 設定パラメーターより優先されます。詳しくは、Indeed エントリー履歴書フィールドの標準化をご覧ください。	languages, education
  indeed-apply-name	文字列です。氏名を名と姓に分割するか（indeed-apply-name=firstlastname）、単一のフィールドで表示するか（indeed-apply-name=fullname）を制御します。 デフォルトは単一フィールドです。Indeed では name=firstlastname を推奨しています。	firstlastname
  indeed-apply-questions	求人で必要な場合は必須 Indeed エントリーの応募プロセス用に、質問を JSON 形式の文字列で返す URL です。 この URL は XML ファイル内でエンコードしてください。URL では HTTPS を使用する必要があります。 質問の作成方法について詳しくは、Indeed エントリーのスクリーナー質問を追加するをご覧ください。 スクリーナー質問 JSON ファイルの例については、Example Indeed Apply Screener Questions JSON file をご覧ください。	https%3A%2F%2Fwww.yourcompany.com %2Fjob1234%2Fquestions.json
  indeed-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 はそれを必須として処理します。

indeed-apply-resumefieldsrequired と indeed-apply-resumefieldsoptional で使用できる履歴書フィールドと、応募データ内で回答が表示される JSON ノード位置

履歴書フィールド標準化パラメーター名	回答が設定される 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 エントリーをテストするをご覧ください。

&nbsp;

このページは役に立ちましたか？