ATS(採用支援システム) と Indeed 連携

本リソースは、ATSパートナー企業に向けた、 Indeed 連携の手順が記載したものです。Indeed と連携することで、採用プロセスを最適化し、求職者のエクスペリエンスを向上させ、採用を迅速化できるようになります。

注意:Indeed とATS連携に関するドキュメントは、Indeed との連携を理解し、連携を計画するための参考資料として公開されていますが、ドキュメントに記載されている連携は、Indeed と基本サービス契約を結んだATSパートナーのみが利用できます。

本リソースの使用方法

Indeed と適切に連携するには、本リソースの全文をよくお読みください。ご不明な点がございましたら、マーケットプレイスプラットフォームマネージャーまでお問い合わせください。必ず、以下の順序で連携してください。

  1. XML Jobフィード
  2. Indeed エントリー(IA)の追加
  3. 応募データの受信スクリーニング用の質問
  4. エンドツーエンドで連携をテストして、XMLの信頼性、Indeed エントリーの利用、そしてスクリーニング用の質問の取得を、企業側で継続的に監視できることを確認
Back to top

XML Jobフィード

始める前に、こちらの提携に関するページを再度ご確認ください。

Indeed の XML フィードは、Indeed サイト上に表示される求人情報をリストにします。お客様に XML フィードのメンテナンスを行っていただくことで、求人がどのように表示されるかを管理することができます。また、Indeed エントリーのラベルを求人に掲示することができます。

フィードの連携に際して、担当者より詳細のフィード修正指摘が入った場合は、入稿者によって都度修正をいただく必要がございます。修正がされない場合、読み込み依頼の差し戻し、またはすでに読み込まれているフィードの読み込み停止などの対応をさせていただく可能性がございます。

顧客がお客様のシステムで求人を作成する場合、求人の一覧はXMLフィード経由で直接 Indeed XMLフィードに送信されます。お客様にXMLフィードのメンテナンスを行っていただくことで、求人がどのように表示されるかを管理できます。

XMLフィードの利用

全ての求人情報を含む XML ドキュメントを作成し、メンテナンスを行って下さい。Indeed は以下の 3 つの手段のいずれかによって、ファイルの変更をモニターしています。

  • XML URLのクローリング
  • 企業がホストするFTPサイトのクローリング(SFTPもサポート対象)
  • Indeed のFTPサーバーに直接ファイルを受信(zipファイルを推奨)

重要:採用ページに掲載されているすべての求人をXMLフィードに含めてください。Indeed は、情報が不十分なXMLフィードや、一部の求人情報のみを対象としたオプトインには対応しておりません。すべての求人情報が含まれていないXMLファイルは拒否されるか、求職者への露出が制限される可能性があります。XMLには、お客様のWebサイトから求職者が入手できる情報がすべて含まれている必要がありますが、Webサイトで現在採用していない求人をXMLに含めないようにしてください。例えば、Webサイトで給与情報が示されているのであれば、XMLフィードには給与を指定する要素、すなわち<salary>を含める必要があります。Webサイトで給与情報が示されていないのであれば、その必要はありません。

XMLで示されているURLは求人の詳細ページにリンクされ、詳細ページで求職者がログインせずに求人のすべての詳細を確認できるようにする必要があります。XMLで示されるコンテンツはすべて、現在募集している職務に関するものとしてください。

XMLフィードの例

1件の求人を含む基本的なXMLフィードの例を以下に示します。

例:基本的なXMLフィード

<?xml version="1.0" encoding="utf-8"?>
<source>
    <publisher>ATS Name</publisher>
    <publisherurl>http://www.atssite.com</publisherurl>
    <job>
        <title><![CDATA[Sales Executive]]></title>
        <date><![CDATA[Tue, 29 Jun 2021 22:49:39 GMT]]></date>
        <referencenumber><![CDATA[unique123131]]></referencenumber>
        <requisitionid><![CDATA[ab1212]]></requisitionid>        
        <url>
            <![CDATA[http://www.examplesite.com/viewjob.cfm?jobid=unique123131&amp;source=Indeed]]>
        </url>
        <company><![CDATA[ABC Hospital]]></company>
        <sourcename><![CDATA[ABC Medical Group]]></sourcename>
        <city><![CDATA[Phoenix]]></city>
        <state><![CDATA[AZ]]></state>
        <country><![CDATA[US]]></country>
        <postalcode><![CDATA[85003]]></postalcode>
        <streetaddress><![CDATA[123 fake street Phoenix AZ, 85003]]></streetaddress>
        <email><![CDATA[example@abccorp.com]]></email>
        <description>
            <![CDATA[1~3年以上のセールスの経験をお持ちで、取引成立に向けて全力で挑める方、
            セールス業界で、急成長を続けるわくわくした環境でのキャリアを
            お探しの方からのご連絡をお待ちしています。
            [...]ストックオプションや充実した福利厚生を含む、
            魅力的な給与体系が用意されています。
            急成長を続ける企業として、私たちはわくわくしてやりがいのある仕事の機会を提供しています。
            成長を続ける弊社内には、キャリア向上のさまざまなチャンスがあります。 ]]>
        </description>
        <salary><![CDATA[$50K per year]]></salary>
        <education><![CDATA[Bachelors]]></education>
        <jobtype><![CDATA[fulltime, parttime]]></jobtype>
        <category><![CDATA[Category1, Category2, CategoryN]]></category>
        <experience><![CDATA[5+ years]]></experience>
        <expirationdate><![CDATA[Mon, 08 Nov 2021]]></expirationdate>
        <indeed-apply-data>COVERED IN A LATER SECTION</indeed-apply-data>
    </job>
</source>

XML フィードの要素(エレメント)

XML フィードは、フィードごとに1回使用されている基本的な要素と、各求人フィードで使用されている求人の要素のセットを含みます。

基本的な要素


基本的な要素
要素 必須/任意 内容 値の例
<?xml ?> 必須 XML宣言 <?xml version="1.0" encoding="utf-8"?>
<source> 必須 XMLフィードのルートノード。
<publisher> 任意 この求人が投稿された採用支援システム(ATS)の名前。 ATS名
<publisherurl> 任意 この求人が投稿されたATSのURL。 http://www.atssite.com/
<job> 必須 求人固有のメタデータをすべて含みます。Indeed で表示するには、各求人に<job>の要素を1つ含めてください。 以下の項目に記載した詳細をご確認ください。

求人情報の要素

注意

  • 求人内容は、オリジナルのWebサイトと同様に、生HTMLとして<![CDATA[]]>セクションに記述する必要があります。HTMLは、XMLエンティティやエスケープ文字(&lt;、&gt;、&amp;)ではなく、実体参照(<,>,&)として指定する必要があります。
  • 以下のガイドラインに従わない場合、その求人は Indeed の検索結果に表示されなくなる可能性があります。必須フィールドが欠落している求人や、Indeed の掲載基準を満たしていない求人は、破棄されるか非表示になる可能性があります。掲載する求人に不安な点がある場合は、Indeed の掲載基準をご確認いただきますようお願いいたします。サポートが必要な場合は、採用企業様向けのページからお問い合わせください。

求人情報の要素
要素 必須/任意 内容 値の例
<title> 必須 職種名。職種名以外の雇用形態、勤務地、働き方に関する情報、キャッチコピーや見出しなどの入力はできません。 サイト上のタイトルに職種名以外の文言が含まれている場合は、XMLファイルでは職種名のみに修正ください。 <![CDATA[セールス担当]]>
<date> 必須 求人が最初に掲載された日。
注意:貴社のサイトにこの日付が掲載されている場合、サイトでの日付とXML内での日付が一致している必要があります。
<![CDATA[Fri, 19 Dec 2014 22:49:39 GMT]]>
<referencenumber> 必須 この求人固有の識別番号。求人の読み込みに必要なので、必ずご入力ください。掲載・更新日程等、定期的に変わる数字を使うことはNG。異なる求人に対して案件番号が重複している場合は非掲載となる場合がございます。応募が終了するまで変更しないよう注意してください。また、停止した応募を再開する際も番号は変更しないでください。 <![CDATA[unique123131]]>
<requisitionid> 任意 求人に対する請求id(旧「外部求人ID」)。貴社のシステムで、これを使用して元の職務とその応募者を追跡する場合があります。また、貴社の公開採用サイトで表示される識別子である場合があります。
異なるフィードや場所で掲載される1つの求人に対し、同一である必要があります。ただし、固有である必要はありません。
<![CDATA[ab1212]]>
<apijobid> 任意 採用管理システムにAPIコールを送るのに使用される求人id。<apijobid><requisitionid>と異なる場合にのみ、この要素の値を指定してください。 <![CDATA[ab1212]]>
<url> 必須 貴社のサイト上での求人のURL。求人応募のページではなく、仕事内容を記載したページのURLを記入してください。Indeed から流入したクリック数を追跡するには、source=Indeedトークンを含めてください。 <![CDATA[http://www.examplesite.com/viewjob.cfm?
jobid=unique123131&source=Indeed]]>
<company> 必須 検索結果に表示される企業名。例えば、同じブランドが子会社やフランチャイズ社によって複数の異なる店舗が運営されている場合、<company>には、求職者にとって雇用主が最も分かりやすい名称を記載してください。これには 直接雇用関係を結ぶ法人名(事業部、物流拠点などを除く正式名称のみ)や屋号名、勤務先施設名、ブランド名などが該当します。 <![CDATA[[Wavewood病院]]>
<sourcename> 必須 その職務を採用している親組織。たとえば、同じ企業の元で複数の店舗を経営している子会社やフランチャイズがある場合、それらの求人はすべて、 <sourcename>ノードで同じ値を持つ必要があります。 <![CDATA[Wavewoodメディカルグループ]]>
<city> 必須 求人の勤務地の市区町村及び町域まで。
注意:都道府県全体、または国全体を対象とした求人については、このドキュメント後半の「XMLフィードに関するよくある質問」を参照してください。
<![CDATA[港区六本木]]>
<state> 必須 求人の勤務地の都道府県。正しい郵便用の省略名を記載してください。もし、求人が米国外の勤務地である場合、地方名や地域名など対応する地理情報を使用してください。
注意:都道府県全体、または国全体を対象とした求人については、このドキュメント後半の「XMLフィードに関するよくある質問」を参照してください。
<![CDATA[東京都]>
<station> 求人サイトに記載されている場合は、必須 近くに駅がない場合は必要ありません。
原則駅名は1つのみ追加ください。複数の駅が追加されている場合、正しくロケーションの設定ができない場合があります。電車・地下鉄駅名のみ掲載してください。鉄道会社名・路線名・バス停の記載はご遠慮ください。
<![CDATA[赤羽橋駅]]>
<country> 必須 求人の勤務地の国名。ISO Alpha-2国コードを指定してください。 <![CDATA[JP]]>
<postalcode> 求人サイトに記載されている場合は、必須 求人の勤務地の郵便番号 <![CDATA[100-8602]]>
<streetaddress> 求人サイトに記載されている場合は、必須 求人の主要な勤務地の住所。町名と番地を入れてください。可能であれば、都道府県、市区町村、郵便番号など、住所をすべて入力します。住所は、勤務地に基づく求人検索の精度を上げるために Indeed が使用し、求職者に表示されることもあります。 <![CDATA[〒108-0073
東京都港区三田1-4-1]]>
<email> 必須 クライアントの Indeed アカウントとひもづいたメールアドレス。クライアントの連絡先メールアドレスは Indeed のサーチクオリティチームが必要とし、求人投稿を行う企業の合法性を確認する際に使用されます。 <![CDATA[example@abccorp.com]]>
<description> 必須 この求人情報の職務内容。<description>に記載される情報と<url>ページに記載される情報を必ず一致させてください。求人関連のすべての情報や掲載元サイトでのそれらの順序を含め、コンテンツが完全に一致している必要があります。Indeed では、この情報にフィルターを適用して、Indeed に関係のないボタンやリンクテキストなどの項目を削除することがあります。このフィールドに基づくプレーンテキストが Indeed の求職者に表示されます。そのためこのフィールドには、学歴や経験など、XMLの他のフィールドでも提供されるテキストが含まれ、求人関連のすべての情報が含まれている必要があります。
注意:仕事内容はHTML形式で記載する必要があります。対応しているHTML要素の一覧については、フォーマットのガイドラインをご確認ください。
<![CDATA[ 1~3年のセールスの 経験をお持ちの方。[...] ]]>
<salary> 求人サイトに記載されている場合は、必須 給与情報。Indeedでは、時給・日給・月給・年収で設定できます。一覧表で表示されるため表記例に基づきシンプルな形で記載ください。 <![CDATA[日給10,000円]]>
<![CDATA[年収400万円~500万円]]>
<education> 求人サイトに記載されている場合は、必須 該当する求人に求められる最終学歴。 <![CDATA[四年制大学卒業]]>
<jobtype> 求人サイトに記載されている場合は、必須 求人の雇用形態(正社員、アルバイト・パート、派遣社員、契約社員など)。複数該当する場合は複数記載可。半角コンマで区切って下さい。

正社員:「正社員」「正規職員」「正職員」が一般的に使用される文言であり、正社員として反映されます。
正社員という意味で「常勤」や「フルタイム」とテキスト記入しないようご注意ください。

契約社員:「契約社員」「契約職員」が一般的に使用される文言であり、契約社員として反映されます。
他の文言ですと、契約社員として反映されない可能性がございます。

アルバイト・パート:「アルバイト・パート」「パート」「アルバイト」「非常勤」が一般的に使用される文言であり、アルバイト・パートとして反映されます。
他の文言ですと、アルバイト・パートとして反映されない可能性がございます。
<![CDATA[フルタイム, パートタイム]]>
<category> 任意 カンマで区切られた求人のカテゴリのリスト。この要素は必須ではありませんが、例えば、求人を管理するために施設や部門に関する情報を追加できます。 <![CDATA[カテゴリ1, カテゴリ2, カテゴリN]]>
<experience> 求人サイトに記載されている場合は、必須 求人応募の際に望ましい経験。 <![CDATA[5年以上]]>
<expirationdate> 求人サイトに記載されている場合は、必須 求人の積極的な採用をやめる日付。 <![CDATA[Mon, 08 Nov 2021]]>
<tracking_url> 任意 Indeed から流入したクリック数を追跡するための、各求人に固有のURL。Indeed は、この求人がクリックされるたびに、このURLに対してGETリクエストを作成します。 <![CDATA[https://www.examplesite.com/
trackjob1234]]>
<lastactivitydate> 任意 採用企業のシステム内で行われた、この求人に対するアクションの最新のタイムスタンプ。応募者の選考や求人の修正などのアクションがあります。 <![CDATA[Fri, 19 Dec 2014 22:49:39 GMT]]>

新エレメント設定について

既存のエレメントに加えて下記エレメントを新しく設定できます。(任意)


新エレメント設定の表
要素 (エレメント) 内容
<timeshift> 勤務時間、作業時間、シフトなど
<subwayaccess> 交通アクセス情報、’○○○駅から○分’など
<rawlocation> ‘番地やビルまでの詳細勤務地情報’
<expdate> ‘掲載終了日’
<benefits> 待遇・福利厚生、’交通費全額支給’など
<rawsalary> 詳細な給与情報
<hires> 採用予定人数
<keywords> ‘未経験OK’、‘残業無し’などのキーワードリスト
※Indeedの検索結果、詳細案件ページで表示したい文言に対応するコード表があり、Feedに該当コードを表記することでタグ情報を表示できます。
※コード表は、Indeed担当にお問い合わせください。
<imageUrls> 写真のURL。.png, .jpg, .bmp, .wbmp, .gif(静止画のみ対応)といった拡張子を含むものです。3:2のアスペクト比で表示されます。標準サイズは375 * 250pxで、これに合わせて写真のサイズを調整し、クロップされます。
複数掲載する場合は半角コンマ(,)区切りで表記してください。
  • キーワード、イメージURLについてはカンマ区切りで複数記載できます。
  • 新エレメントについては現在テストを行いつつ Indeed へ反映を進めています。記載いただいたものが必ず表示されるとは限りません。詳しくは担当のプラットフォームパートナーシップマネジャーにお問い合わせください。
  • 既存エレメント、新エレメントともに、新しくエレメントを追加(修正)した場合、Indeed側で該当エレメントの追加設定が必要になります。変更した際はその旨お教えください。

その他注意事項

  • フィードは1日1回は更新をお願いします。
  • XMLフィードの内容と求人サイトの内容が全く同じ情報になるように作成をお願いします。
  • 原則1フィードでの連携ですが、派遣・紹介企業の案件がある場合、直接企業案件と分けて2フィード提出をお願いします。
  • 初期設定において、連携には最低 5 社以上の掲載が必要になります。
  • テスト案件、求人サイトの案件、ショッピングモールの案件は含めないようにお願いします。

フォーマットのガイドライン

XML内の仕事内容は、貴社のウェブサイトで使用されているものと同じHTMLフォーマットで記載してください。フォーマットはCDATAタグの中に記述してください。HTMLコンテンツは正規化され、HTML標準に厳格には準拠していない標準化された形式で求職者に表示されます。

注意:エスケープを使用したHTMLの文字には対応していません。たとえば、&lt;ではなく<を使用してください。対応していないHTMLの文字が記載されている場合、Indeed で求人が拒否されたり、フォーマットの問題が発生したりする可能性があります。以下は対応しているタグの一部です。


フォーマットのガイドラインの表
タグ 内容
<b> 太字
<h1><h6> ヘッダー。 注意:ヘッダータグ内のテキストは、Indeed のページ上で表示される際には、一定のサイズに変換されます。
<br> 単一改行
<p> 段落。Indeed では、段落タグ間に自動的に空白行が挿入されます。
<ul> 順序のないリスト(箇条書き)
<li> リストアイテム
<strong> 太字
<em> 強調文字(斜体)
<table><tbody><th><tr><td> 基本的な表。Indeed ではセルごとに改行して表示します。

また、以下のような算出スタイルノードに対応しています。

  • <font style="font-weight:bold">Some bold text</font>は太字で表示されます。
  • <div><h2 style="display:inline">Label: </h2>Text</div>は 「Label: Text」をインラインで表示します。ただし<h2>は、デフォルトではブロック要素となります。
  • 段落タグの上下のmarginおよびpaddingの値は、必ず正数を入力してください。これは<p>タグのデフォルトの挙動です。

フォーマットの例

仕事内容のフォーマットの例

<description><![CDATA[
 <h2 id="job_description">仕事内容</h2>
 <ul>
 <li>1~3年のセールスの経験をお持ちの方。</li>
 <li> 取引成立に向けて全力で挑める方。 </li>
 <li>セールス業界で、急成長を続けるわくわくした環境でのキャリアをお探しの方。</li></ul>
 <font style="font-weight:bold">福利厚生</font>
 <p>ストックオプションや充実した福利厚生を含む、魅力的な給与体系が用意されています。急成長を続ける企業として、私たちはわくわくしてやりがいのある仕事の機会を提供しています。成長を続ける弊社内には、キャリア向上のさまざまなチャンスがあります。 </p>
 ]]>
 </description>

Indeed 上での表示

求人内容

  • 1~3年のセールスの経験をお持ちの方。
  • 取引成立に向けて全力で挑める方。
  • セールス業界で、急成長を続けるわくわくした環境でのキャリアをお探しの方。

福利厚生

ストックオプションや充実した福利厚生を含む、魅力的な給与体系が用意されています。急成長を続ける企業として、私たちはわくわくしてやりがいのある仕事の機会を提供しています。成長を続ける弊社内には、キャリア向上のさまざまなチャンスがあります。

よくある問題

以下のような問題がある場合、Indeed は貴社のXMLフィードを処理できません。また、求人が Indeed の検索結果に表示されない可能性があります。


よくある問題一覧
問題 解決策
不正な特殊文字のエンコーディング ブラウザの「ソースを表示」機能を使用して、フィードのURLで括弧(< >)などの文字が正しく表示されているかどうかを確認してください。フィードがUTF-8文字エンコーディングなど、XML宣言を使用していることを確認します。ファイルには、エンコーディングを宣言するヘッダーが必要です。UTF-8が最もよく使用されていますが、UTF-8以外のエンコーディングを使用することもできます。XMLでは、XML標準で許容されている文字範囲を使用する必要があります。
求人情報がフィードにない、または求人数がフィードとオリジナル採用ページで異なる 各クライアントのフィードにすべての求人を含めてください。Web上で公開されていて募集中の求人はすべてフィードに含めてください。Indeed は検索エンジンであるため、より網羅性の高い情報のインデックス化を行います。
求人内容が不完全または欠落している 求人に関連する全ての文字情報を含めてください。たとえば、「必須要件」 が貴社のデータベースでは別のカテゴリに分類されている場合も、Indeed のシステムでは、<description>フィールドに該当する情報をご記載いただく必要があります。
詐欺または詐欺の疑いがある求人 Indeed は、詐欺の疑いのあるものを除外するように設計されています。職務内容を分かりやすく明記してください。他企業の求人を送信する場合は、該当企業が合法的な企業であり、記載された求人が実際に募集中の案件であることを確認できるように、該当企業を入念に調査してください。
ファイルに古い求人がある 古い求人や休止中の求人をXMLに含めないでください。採用が決定したら、XMLファイルから求人を削除してください。Indeed が古い求人や休止中の求人を見つけた場合、XMLの利用を続けていただけるよう、挙動の修正の依頼を貴社にご連絡します。

要素のNG例


要素のNG例
要素 NG例
<title> 職種名以外の雇用形態、勤務地、働き方に関する情報、キャッチコピーや見出しなどの入力はできません。
<title><![CDATA[ 5日以上の連休取得可!県内トップクラスのカットスキルが身に付く美容師アシスタント(正社員) ]]></title>
<title><![CDATA[ 美容師アシスタント ]]></title>
<date> 必ず依頼日より前の日付にご設定ください(求人が非表示になります。)
日付が未来の日付になっている。
<company> 同じ企業の元で複数の店舗を経営している子会社やフランチャイズがある場合、求職者がすぐに理解できるような、最もシンプルな形の事業名またはブランド名を記載。
よみがなは記載しないでください。

(例1)施設名・サロン名などがある企業様の場合そちらを記載
株式会社Aが運営する『Hair Salon XX』の場合
<company><![CDATA[ 株式会社A ]]></company>
<company><![CDATA[ Hair Salon XX ]]></company>

(例2)会社名に() カッコをつけない
<company><![CDATA[ 株式会社A(Hair Salon XX) ]]></company>
<company><![CDATA[ Hair Salon XX ]]></company>

(例3)(株)、(有)などは不可。事業部名などを含まない正式名称のみを記載
<company><![CDATA[ (株)A 関東事業部 ]]></company>
<company><![CDATA[ 株式会社 A ]]></company>

(例4)よみがなは記載しない
<company><![CDATA[ 株式会社FREE (フリー) ]]></company>
<company><![CDATA[ 株式会社FREE ]]></company>
<city>,<streetaddress> <city>タグには市区町村。
<streetaddress>へは都道府県、市区町村、郵便番号など、住所をすべて記載。
例)「東京都港区三田1-4-1住友不動産麻布十番ビル6階」の場合
<city><![CDATA[ 港区三田1-4-1住友不動産麻布十番ビル6階 ]]></city>
<city><![CDATA[ 港区三田 ]]></city>
<streetaddress><![CDATA[108-0073 東京都港区三田1-4-1住友不動産麻布十番ビル6階 ]]></streetaddress>

注意 勤務地の記載に不備がある場合、求人の勤務地が正しく読み込まれません。
<station> 電車の駅名のみを記載。(バス停の情報などは<description>タグへ記載(<description>に記載される情報と<url>ページに記載される情報を必ず一致させる必要がある為。))
例「最寄り 六本木駅 〇〇バス停」の場合。
<station><![CDATA[ 最寄り 六本木駅 〇〇バス停 ]]></station>
<station><![CDATA[ 六本木駅 ]]></station>
注意 勤務地の記載に不備がある場合、求人の勤務地が正しく読み込まれません。
<description> <description>に記載される情報と<url>ページに記載される情報(順番なども含む)を必ず一致させてください。
このフィールドに基づくプレーンテキストが Indeed の求職者に表示される。 そのためこのフィールドには、学歴や経験など、XMLの他のフィールドでも提供されるテキストを含め、求人関連のすべての情報が含まれていることが必要。
注意 仕事内容はHTML形式で記載する必要があります。
<salary> 給与情報のみを記載(給与の内訳やモデル年収等は<description>タグ内に記載)
例)経験有無によって年収が異なるケース
<salary><![CDATA[ 年収400万円~500万円 経験者の場合年収500万円~700万円 経験5年の場合 各種手当+インセンティブを含めたモデル給与:年収650万円]]></salary>
<salary><![CDATA[ 年収400万円~700万円]]></salary>
注意 給与情報は<salary>タグ以外からも抽出される可能性があるため、必ず<salary>タグのデータが表示されるとは限りません。
その他 その他1
初回XML申請時のサイト構成から、大幅なサイト構成の変更する場合は事前にご相談下さい。

その他2
エスケープ文字 (&lt; &gt; &amp; &nbsp; 等) は使用不可となります。

その他3
タグはすべての求人に追加する必要があります。例えばを一つの求人に設定する場合はすべての求人にも設定する必要があります。タグはブランクにしておくことは可能です( <imageURLs> </imageURLs> または <imageURLs />)。

その他4
最寄りの交通機関がバス停の場合は <description><subwayaccess>タグ内に記載。

XMLフィードに関するよくある質問(FAQ)

Indeed は、どれくらいの頻度でXMLフィードをインデックス化していますか?

URLまたはATSで指定されているFTPサイトでクローリングされるXMLについては、最後のリクエストから6時間ごとに求人データが1日に4回更新されます。Indeed がホストしているFTPについては、新しいファイルが最大6時間ごとに受信されると、XMLフィードが更新されます。ファイルをアップロードする頻度が高くなると、事前処理が停止し、求人情報の更新が行われなくなる場合があります。

どのようなメタデータを含めることができますか?

標準フィールドが記載されてさえいれば、あとは好きなフィールド(例:<job_type><branch_id>)を含めることができます。

フィードの求人は、すべて Indeed の検索結果に表示されますか?

検索結果への表示は、Indeed の表示ルールに基づきます。Indeed のサーチクオリティチームによって、合法かつ独自性があり、職務内容と勤務地が詳細に記載され、簡単に応募できる求人が優先的に表示されます。これらの条件を満たさない求人は、検索結果に表示されないことがあります。クライアントが、Indeed のサーチクオリティチームの投稿に関するベストプラクティスに従っていることを確認してください。クライアントが Indeed で自社の求人を検索できない場合、Indeed に問い合わせる必要があります。

Indeed エントリーを利用しており、求職者が Indeed から直接応募できるようにしているのに、なぜURLを提供しなければいけないのでしょうか?

3つの理由から(Indeed エントリーのページではなく)求人内容へ誘導するURLが必要となります。

  • もし Indeed エントリーに問題が発生した際には、求職者は求人 URL へと誘導されます。
  • クライアントが Indeed エントリーの利用を停止する場合に、Indeed は求職者に応募する方法を提示する必要があります。
  • 求人内容と実際の求人活動を確認するために、Indeed のアグリゲーションエンジンでは有効なURLが必要です。

複数の言語で同じ求人を掲載している場合はどうなりますか?

XMLでは、各言語の求人それぞれを、固有の求人として提供してください。XML内で同じ参照番号を使用した場合、最初に記載されている求人だけが Indeed に掲載されます。

複数の国で同じ求人を掲載している場合はどうなりますか?

募集中の職種がある勤務地ごとに求人情報を記載してください。広い地域を対象とした求人でないものを広い地域に対して投稿した場合、Indeed 上でオーガニック検索では表示されません。各求人には、固有の勤務地や参照番号が含まれていることが必要です。固有の情報が含まれていない場合、求人が Indeed で目に留まりにくくなります。

都道府県全体、または国全体を対象とした求人はどうなりますか?

Indeed では、市町村や都道府県、郵便番号などの要素が必須項目となっています。これらの要素に関する情報がない場合、求人はオーガニック検索では表示されません。

もし、合法的に幅広い地域を対象とした求人や、在宅勤務の求人を掲載する場合、ファイル内に含め、オーガニック検索でも表示されるように、クライアントの代わりにリクエストをお送りください。クライアントが Indeed のアカウントを持っている場合は、ログインしてサポートを受けることができます。アカウントを持っていないクライアントは、Indeed のWebサイトから Indeed に直接質問を送信できます。

なぜ各求人にメールアドレスが必要なのですか?

Indeed を初めてご利用いただく企業さまや、すでに Indeed をご利用いただいている企業の新しい求人情報に対して、アカウント認証とオーガニックシンジケーションの有効化を行うために、連絡先のメールアドレスが必要となります。メールアドレスが使用されない場合もありますが、メールアドレスはすべての求人で必須となっています。

クライアントが Indeed の利用停止(オプトアウト)を求めている場合はどうすればよいですか?

クライアントの求人の<job>要素をXMLからすべて削除します。クライアントは求人ごとに利用を停止することはできず、Indeed への配信を完全に停止することが必要です。XMLとクライアントの求人ポータルの間で求人掲載数に相違がある場合は、正確性を確保するために、求人掲載数が最大の掲載元が優先されます。

Back to top

Indeed エントリー(IA)の追加

Indeed で求人に「簡単応募」のラベルを追加し、求職者が Indeed のサイト上のみで応募を完結できるように、Indeed エントリーAPIをご利用ください。

Indeed エントリーAPIを実装しデプロイするまでに、およそ2~3週間かかります。

APIトークンの生成

Indeed エントリーを実装する前に、次の手順を実行してください。

  1. 貴社の Indeed アカウントにサインインするか、次のページから新しいアカウントを作成します:https://secure.indeed.com/account/login
  2. ログインしたら、次のページで「認証情報を管理する」に移動します:https://secure.indeed.com/account/apikeys
  3. [新しいアプリケーションの登録]ボタンをクリックします。
  4. アプリケーションとWebサイトの名前を入力します。
  5. 認証タイプとして「Indeed エントリー」を選択し、[保存]をクリックします。

注意:Indeed の他の場所でもOAuthを使用している場合、Indeed エントリー連携用のトークンは別途保持してください。

アカウントに保存された新しい認証情報が表示されます。

Indeed エントリーのAPIトークンとして「クライアントID」を使用します。

XMLフィードを利用した Indeed エントリーの追加

Indeed XMLフィードでは、Indeed エントリーの設定属性をフィード内の<indeed-apply-data>要素の中に追加してください。

Indeed エントリーの設定属性は Indeed エントリー設定パラメータの表にまとめられています。

Indeed エントリーXML要素の例

以下の例は、1件の求人と Indeed エントリー要素を含む基本的なXMLフィードを表しています。

注意:基本的な求人情報は、ここでは分かりやすく記載するために省略されていますが、実際のフィードには記載する必要があります。

基本的なXMLフィードの例

<?xml version="1.0" encoding="utf-8"?>
<source>
    <publisher/>
    <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+B
            asket+Weaver&indeed-apply-jobId=Sample+ID&indeed-apply-jobCompanyName=My+Favo
            rite+Company&indeed-apply-jobLocation=Austin+TX&indeed-apply-jobUrl=http%3A%2
            F%2Fwww.indeed.com&indeed-apply-postUrl=https%3A%2F%2Fhookb.in%2FPxOjJqJELNH8
            lZLZDkpz&indeed-apply-questions=https%3A%2F%2Fpastebin.com%2Fraw%2F0vXq9q9b%2
            3]]>
        </indeed-apply-data>
    </job>
</source>

Indeed エントリーXML要素の制限

XMLフィードを利用して Indeed エントリーを追加する場合、以下の制限があります。

  1. 属性はURLエンコードされている必要があります。
  2. Indeed エントリーフィールドが XML フィードに含まれている場合、空白にしないでください。

Indeed エントリーの設定属性は Indeed エントリー設定パラメータの表にまとめられています。

Indeed エントリー設定パラメータ

以下の設定パラメータを使用して、Indeed エントリーAPIを設定してください。


パラメータの一覧表
パラメータ名 必須/任意 内容
jobUrl 任意 仕事内容がすべて記載されたページの正規URL。XMLファイル内に、このURLをエンコードしてください。
注意:Indeed での応募では、応募が行われている Indeed のURLの応募ボタンにjoburlが設定されます。
http%3A%2F%2Fwww.yourcompany.com
%2F%0Acareers%2Fyourjob123.html
jobId 任意 求人のID。求人を内部で追跡するために使用されます。
注意:このフィールドには最大256字のASCII文字を含めることができます。
7775e2bc62b7f77e
jobTitle 必須 サイトの外部で表示される求人の職種名。(50文字まで)
注意:XMLの<title>フィールドと一致している必要があります。
テストエンジニア
jobCompanyName 必須 採用企業名。(50文字まで) XML内の<company>フィールドで指定されている値と一致している必要があります。 Indeed
jobLocation 必須 勤務地。(50文字まで) 東京都港区
jobMeta 任意 記載したい任意の情報。外部には表示されませんが、post URLからの応募の際に送信されます。 right-rail-apply-button
apiToken 必須 Indeed エントリーの認証情報を使用して生成された「クライアントID」の値。APIトークンの生成を参照してください。 your-api-token
postUrl 必須 Indeed が応募データを投稿するURL。XMLファイル内に、このURLを記載してください。HTTPSである必要があります。 https%3A%2F%2Fwww.yourcompany.com
%2Fprocess-applications
phone 任意 求人に電話番号のフィールドを表示するかどうかを示す文字列の値。 設定可能な値は、optionalhiddenrequiredのいずれかです。デフォルト値はoptionalに設定されています。 optional
coverletter 任意 採用企業への質問、自己PR、備考のフィールドが必須かどうかを示す文字列値。 設定可能な値は、optionalhiddenrequiredのいずれかです。デフォルト値はoptionalに設定されています。注意:これは自由に記述できるフィールドです。添付書類が必要な場合は、スクリーニング用の質問を使用して、ファイルのアップロードを依頼することをご検討ください。 required
resume 任意 履歴書の提出を必須とするかを設定したり、履歴書のアップロードのオプションがユーザーに表示されないように設定したりします。設定可能な値は、optionalhiddenrequiredのいずれかです。このパラメータを含めない場合、値はデフォルトでrequiredに設定されます。optionalまたはhiddenを選択し、resumefieldsoptionalまたはresumefieldsrequiredを含めない場合、スクリーニング用の質問を含める必要があります。
注意:履歴書のファイル形式として、.pdf、.doc、.docx、.rtf、.txtに対応している必要があります。
required
resumefieldsrequired 任意 求職者の履歴書に含まれている必要のあるresumeフィールドのカンマ区切りリスト。このフィールドが入力されている場合、上記のphoneの設定パラメータを上書きします。詳細については、Indeed エントリーのResumeフィールドの標準化セクションを参照してください。 phone, gender, dateOfBirth
resumefieldsoptional 任意 求職者の履歴書に含まれていることが望ましいresumeフィールドのカンマ区切りリスト。このフィールドが入力されている場合、上記のphoneの設定パラメータを上書きします。詳細については、Indeed エントリーのResumeフィールドの標準化セクションを参照してください。 languages, education
name 任意 エントリーフォームの名前フィールドを姓と名に分割するか(name="firstlastname")、氏名を1つのフィールドにまとめるか(name="fullname")を示す文字列値。デフォルトの値は、氏名を1つのフィールドにまとめます。name="firstlastname"の使用をお勧めします。 firstlastname
questions 任意 Indeed エントリーでの応募の際に尋ねる質問をJSON形式の文字列で返すURL。質問の作成については、スクリーニング用の質問項目の追加を参照してください。HTTPSである必要があります。 https%3A%2F%2Fwww.yourcompany.com
%2Fjob1234%2Fquestions.json

Indeed エントリーのResumeフィールドの標準化

resumefieldsrequiredおよびresumefieldsoptionalは、指定された応募URLに送信される応募JSONデータの一部として含まれる履歴書関連情報を指定および管理するために使用できます。Indeed は、これらの指定フィールドを収集するだけでなく、応募者の履歴書ファイルの収集に努めます。

  • 求人へのすべての応募は、指定されたresumefieldsrequiredフィールドを含み、応募者に履歴書ファイルの提出を要求します。
  • 指定されたresumefieldsoptionalフィールドは応募者の任意となります。resumefieldsrequiredが指定されていない場合、履歴書ファイルの添付は応募者の任意となります。

注意:resumeパラメータがhiddenに設定されている場合、応募者から履歴書ファイルは収集されませんが、resumefieldsrequiredまたはresumefieldsoptionalで収集されたデータは、応募JSONデータの一部として提供されます。resumeパラメータがrequiredまたはoptionalに設定されている場合、そのパラメータは無視され、resumefieldsrequiredまたはresumefieldsoptionalによって履歴書ファイルが収集されます。

resumefieldsrequiredまたはresumefieldsoptionalフィールドが指定されている場合、phoneパラメータは無視されます。

以下は、resumefieldsrequiredまたはresumefieldsoptionalに含めることができるresumeフィールドのリストです。両方に同じresumeフィールド名が指定されている場合は、必須として処理されます。


resumefieldsrequiredおよびresumefieldsoptionalで使用可能なresumeフィールドおよび設定時に応募データ内で回答が設定されるJSONノードの位置
Resumeフィールド標準化パラメータ名 回答が設定される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
Back to top

スクリーニング用の質問

スクリーニング用の質問は、indeed-apply-questionsパラメータの各<job>に含まれるURL(HTPPS)にJSONの形式で投稿してください。Indeed が採用企業に代わってスクリーニング用の質問をホストすることはありません。システムでスクリーニング用の質問がサポートされている場合は、連携を承認するために、Indeed エントリーにそれらを実装する必要があります。

質問項目の追加にあたって

注意事項

  • 最大500個の質問を入力できます。ただし、Indeed のデータによると、質問項目が20件以上ある場合はコンバージョン率が急激に下がります。
  • 質問のファイルのサイズは1MB以下にしてください。
  • 質問のファイルは、固有の質問URLによってサーバーサイドでキャッシュされ、20分ごとに更新されます。注意:求職者が Indeed エントリープロセスを開始する際に、Indeed が要求する場合のみ、質問がキャッシュされます。
  • 履歴書標準化対応の時には、Question URLの中身(JSONデータ)をご変更いただく際にURLを新規のものにご変更ください。(キャッシュを削除するため)
  • type=dateの形式は、応募がサードパーティに渡される方法や、最小値と最大値の解析方法に影響します。求職者は、指定の形式ではなくロケールに応じて日付を入力しますが、検証エラーメッセージはロケールの形式になります。
  • type=dateでは、混乱を防ぐため、yyではなくyyyyを使用してください。

注意:Indeed エントリー質問用ツールを使用してJSONファイルのシンタックスを確認し、スクリーニング用の質問項目の体裁を確認してください。

ベストプラクティス

  • 求人に関連する質問のみを含めてください。
  • スクリーニング用の質問の数はなるべく少なくしてください。求職者の中にはモバイル端末から質問に回答する方もいることを念頭に置く必要があります。
  • 応募書類を妥当な項目で区切るには、pagebreakという質問(type)を使用します。JSONにpagebreakが何も含まれていない場合は、デフォルトのページ区切りが挿入されますが、これにより応募が意図しない方法で分割されてしまう場合があります。Indeed では、モバイルとPCの両方で1ページにつき最大10個の質問を表示します。
  • ユーザーが履歴書から回答できる質問や、Indeed エントリーの応募プロセスですでに収集した情報(例: 連絡先情報など)についての質問は、スクリーニング用の質問には含めないでください。
  • どのような質問を含めるかについては、現地の法律を遵守してください。現地の法律に抵触するおそれのある質問については、貴社の法務部にご確認ください。
  • 特定の形式での回答が必要な場合、求職者がわかるように説明を記載してください。
  • Indeed ではSimpleDateFormatを使用しており、mmを使用すると混乱する可能性があるため、月のフォーマットはMMにする必要があります。

スクリーニング用の質問項目のためのJSON

この項目は、すべての質問で使用されるパラメータを記載しています。具体的な質問の種類に関しては、スクリーニング用の質問項目の種類をご覧ください。

JSONスクリーニング用の質問項目パラメータ


JSONスクリーニング用の質問項目パラメータの表
パラメータ名 必須/任意 内容 設定可能な値
id 必須 この質問の固有ID。 任意の文字列 強み
type 必須 質問の種類を示します。各種類についての詳しい説明は、以下の項目をご覧ください。 textarea
text
select
multiselect
hierarchical
date
file
information
pagebreak
textarea
question type=informationおよびtype=pagebreakの場合は無効、 その他のすべての種類では必須 応募者に表示される質問のテキスト。 任意の文字列 販売の経験はありますか ?
text type=informationの場合は必須 その他のすべての種類では無効 応募者に表示されるテキスト。 任意の文字列 以下の質問は任意項目です。
options type=selecttype=multiselectの場合は必須 ドロップダウンメニューで選択できるオプションのリスト。 JSON [{ "value":"1", "label":"女性" }]
value type=selecttype=multiselectの場合は必須 ドロップダウンメニュー形式の質問に返される、各選択肢に対応する値。 任意の文字列 1
label type=selecttype=multiselectの場合は必須 ドロップダウンメニューの中の選択肢のテキスト。 任意の文字列 女性
required 任意 質問を回答必須に設定が可能。required:trueが指定されていると、Indeed エントリーでは、回答フィールドに何も入力しないまま、あるいは何も選択しないままでは、回答者は先に進むことができません。requiredが指定されていない場合、回答は任意となり、空の回答も可能になります。 true "required":true
format type=dateの場合は必須type=textの場合は任意 使用できる入力形式。 type:textの場合、回答を整数(integer)、小数(decimal)、または番号(numeric_text)に限定できます。type:dateの場合、MMを使用するSimpleDateFormatのみが回答として有効です。 テキストの形式
  • integer(整数)
  • decimal (小数)
  • numeric_text (0を整数として表示したい時に使用)
  • その他のロケール特有の形式(Unicode CLDRを参照してください)
日付の形式
  • integer(整数)
  • dd/MM/yyyy
integer、 dd/MM/yyyy
limit 任意 type=textおよびtype=textareaの場合に、回答の文字数の上限を設定します。 任意の整数 100
min 任意 format=integerまたはformat=decimalの場合は、回答の最小値を設定します。type=dateの場合は、回答は指定した日付以降のものである必要があります。 format=integer
の場合は任意の整数、format=decimal
の場合は任意の小数、type=dateの場合は任意の日付(指定の形式で)
0
max 任意 format=integerまたはformat=decimalの場合は、回答の最大値を設定します。type=dateの場合は、回答は指定した日付以前のものである必要があります。 format=integer
の場合は任意の整数、format=decimal
の場合は任意の小数、type=dateの場合は任意の日付(指定の形式で)
100
condition 任意 前項のselect質問がどう回答されたかという条件が、質問に付随する場合に使用。この質問を有効にする、前項の質問のidと選択肢のvalueを指定してください。
例えば、応募者に販売の経験について質問したとします。経験があると答えた場合、どの業種での販売経験があるのかを尋ねる、条件付の質問を表示出来ます。
JSON "condition": { "id": "parent1", "value": 0}

スクリーニング用の質問項目の種類

textarea

複数行のテキスト入力のフィールドが表示される質問。長い回答が予想される質問に使用します。

textareaの例
{
  "id":"envirotext",
  "type":"textarea",
  "question":"Describe your ideal work environment:"
}

text

1行のテキスト入力のフィールドが表示される質問。回答が短いと予想される質問に使用します。

注意:textの質問に利用できる各種のフォーマット(integer、decimal、numeric_text)については下記の例と上記の表をご覧ください。

textの例

形式の指定がない場合:

{
  "id": "city",
  "type": "text",
  "question": "What city are you located in?",
  "required": true
}

Integer(整数):整数を表示。少数や先行ゼロは表示できません。

{
  "id":"age",
  "type":"text",
  "question":"Age?",
  "format":"integer",
  "min":"16",
  "max":"75"
}

Numeric text (数値): 先行ゼロも含む数字を表示しますが、小数点は表示されません。

{
  "id": "ssn",
  "type": "text",
  "format": "numeric_text",
  "question": "Enter last 4 digits of your SSN.",
  "required" : false
}

Decimal (小数): 小数や先行ゼロも含む数字が表示できます。

{
  "id": "gpa",
  "type": "text",
  "format":"decimal",
  "question": "What was your GPA?",
  "required": true
}

select

応募者が1つの回答を選択できるドロップダウンメニューが表示される質問。複数の選択肢から回答を選ぶ質問に使用します。

注意:回答の選択肢が6つ以下である場合、選択肢はラジオボタンとして表示されます。選択肢が7つ以上である場合、選択肢はドロップダウンメニューとして表示されます。

selectの例
{
  "id": "gender",
  "type": "select",
  "question": "Gender?",
  "options": [{
      "value": "0",
      "label": "Decline to answer"
    },
    {
      "value": "1",
      "label": "Male"
    },
    {
      "value": "2",
      "label": "Female"
    }
  ]
}

multiselect

応募者が複数の回答を選択できるチェックボックスが表示される質問。複数の選択肢から回答を選ぶ質問を設定する際に使用します。

multiselectの例
{
  "id": "favoritecolors",
  "type": "multiselect",
  "question": "Select your two favorite colors:",
  "options": [{
      "value": "0",
      "label": "Maize"
    },
    {
      "value": "1",
      "label": "Blue"
    },
    {
      "value": "2",
      "label": "Green"
    }
  ]
}

conditional

前の質問の回答に基づいて、追加で質問と応答を表示します。例えば、応募者に「18歳以上かどうか」と尋ねた場合、もし、「いいえ」と回答したら、「就労に関する必要書類の提示が可能か」などと質問できます。

conditionalの例
[{
    "id": "profile-atLeast18",
    "question": "Are you at least 18 years of age?",
    "required": true,
    "options": [{
        "value": "1",
        "label": "Yes"
      },
      {
        "value": "0",
        "label": "No"
      }
    ],
    "type": "select"
  },
  {
    "id": "profile-permit",
    "question": "Can you provide a work permit?",
    "required": true,
    "condition": {
      "id": "profile-atLeast18",
      "value": "0"
    },
    "options": [{
        "value": "1",
        "label": "Yes"
      },
      {
        "value": "0",
        "label": "No"
      }
    ],
    "type": "select"
  }
]

hierarchical

前の回答に基づいて質問と応答をさらに表示します。例えば、応募者に県を選択してもらうとします。すると、選択肢に応じて、その県内の市のドロップダウンリストを表示できます。hierarchicalの質問は、それぞれ、都道府県、市区町村、郡のように、3つの階層まで利用可能です。

注意:hierarchicalの質問は、conditionalと類似していますが、最初の選択肢がその後に続く質問の回答を決定する階層の多い質問に対しては、 hierarchical の方がより適切です。hierarchical機能を使用することで、関連情報を収集するまでに必要になる質問の合計数を削減することができます。

hierarchicalの例
[{
  "id": "hierarchical",
  "type": "hierarchical",
  "question": "State",
  "required": true,
  "options": [{
    "value": "0",
    "label": "California"
  }, {
    "value": "1",
    "label": "Texas"
  }, {
    "value": "2",
    "label": "New York"
  }],
  "hierarchicalOptions": [{
      "id": "cali_cities",
      "options": [{
        "value": "0",
        "label": "San Francisco"
      }, {
        "value": "1",
        "label": "Los Angeles"
      }],
      "condition": {
        "id": "hierarchical",
        "value": "0"
      }
    }, {
      "id": "texas_cities",
      "options": [{
        "value": "0",
        "label": "San Antonio"
      }, {
        "value": "1",
        "label": "Austin"
      }],
      "condition": {
        "id": "hierarchical",
        "value": "1"
      }
    },
    {
      "id": "sa_zipcodes",
      "options": [{
        "value": "0",
        "label": "78212"
      }, {
        "value": "1",
        "label": "78209"
      }],
      "condition": {
        "id": "texas_cities",
        "value": "0"
      }
    }
  ]
}]

date

日付だけを入力できるテキストフィールドを含む質問。日付を含む回答が必要な際に使用します。

注意:このスクリーニング用の質問項目を使用する場合はformatが必要です。このformatは、dd/MM/yyyyか、Unicode CLDRに準拠したその他のロケール固有のフォーマットにする必要があります。Indeed ではSimpleDateFormatを使用しており、mmを使用すると混乱する可能性があるため、月のフォーマットはMMにする必要があります。

dateの例
{
  "id":"startdate",
  "required":true,
  "type":"date",
  "question":"Start date?",
  "format":"dd/MM/yyyy",
  "min":"01/02/2014",
  "max":"03/04/2014"
}

file

ファイルをアップロードするインターフェースが表示される質問。回答で証明書、ポートフォリオ、仕事のサンプルなど、ファイルのアップロードが必要な質問に使用します。応募データの受信方法のオプションに関する項で説明したとおり、回答データはcontentTypedatafileNameの3つのフィールドが含まれたJSON POSTリクエストとして返されます。

対応しているファイル形式:doc、docx、gif、jfif、jif、jpe、jpeg、jpg、pdf、png、rtf、tif、tiff、txt

ファイルの最大サイズ:5MB。応募ごとの最大合計サイズは15MBです(履歴書ファイルを含む)。

注意:この質問を履歴書の取得に使用しないでください。履歴書を取得するには、Indeed エントリー設定パラメータである「Resume」を使用してください。

fileの例
{
  "id": "file2",
  "type": "file",
  "question": "Please attach a recent example of your work.",
  "required": true,
  "min":"1",
  "max": "3"
}

information

回答を必要としないテキストを表示します。説明用のテキストや、各項目の見出しを記載するために使用します。テキスト内には、<b><p><br><li><ul><ol><a href=" ">のHTML要素を使用できます。URLにはHTTPおよびHTTPSプロトコルのみが許可されています。リンクは新しいタブで開きます。

注意:<br>を使用して、段落後の改行を強制しないでください。Indeed では、自動的に段落間に改行が挿入されます。

informationの例
[{
  "id": "first_header",
  "type": "information",
  "text": "The next set of questions are <b>optional</b> and are for recording purposes only. 
 Make sure to view the <a href='http://www.eeoc.gov/employers/upload/poster_screen_reader_optimized.pdf'> EEO is the Law</a> poster.",
  "fontsize": 8
}]

pagebreak

ページ上で、質問をグループごとにまとめる際に使用されます。2つのpagebreak間に含まれるすべての質問は、同じページに表示されます。最大20問の質問を同じページにまとめることができます。デスクトップの場合は各ページに3つの質問が表示され、モバイルの場合は1ページにすべての質問がまとめて表示されるように、デフォルトで設定されています。

pagebreakの例
[{
    "id": "page1_open",
    "type": "pagebreak"
  },
  {
    "id": "question_sample",
    "type": "text",
    "question": "Age?"
  },
  {
    "id": "page1_close",
    "type": "pagebreak"
  }
]

JSON postの例

注: このセクションでは、採用企業に提出された応募データの内容について説明します。Indeed に提供するJSON質問ファイルの形式を変更する必要はありません。

現在、JSON postには「スクリーニング用の質問」とその「回答」が、次の2つのフォーマットで含まれています。

  • 現在*のフォーマット
  • 変更後のフォーマット

この2つのフォーマットについて以下で説明します。今後、「現在のフォーマット」は2021/12/31時点で廃止する予定です。

現在*のフォーマット

現在のフォーマットでは、スクリーニング用の質問とその回答は、JSONファイルの「questions」セクションに含まれています。

  • question:
  • questions:前の項目で説明された全質問のリスト
  • answers:全回答のリスト
  • url:質問が取得されたURL
  • retrievedOnMillis:質問が取得された日付と時刻(単位:ms)

変更後のフォーマット

変更後のフォーマットでは、スクリーニング用の質問とその回答は、JSONファイルの「questionsAndAnswers」セクションに含まれています。

  • questionsAndAnswers:(改善されたフォーマット)
  • questionsAndAnswers:以下のリスト
  • questions:前の項目で説明された質問
  • answer:上記の質問への回答
  • url:質問が取得されたURL
  • retrievedOnMillis:質問が取得された日付と時刻(単位:ms)

JSON postファイルの完全な例を表示またはダウンロードするには、こちらをクリックしてください(現在のフォーマットと変更後のフォーマットが含まれています)。

*現在のフォーマット:現在のフォーマットは今後廃止される予定です。現在のフォーマットを使用して「スクリーニング用の質問とその回答」を読み込んでいる場合は、Indeed エントリーで引き続き正確な情報をすべて受信できるように速やかにご変更ください。現在のフォーマットを使用しており、変更後のフォーマットへの移行を希望している既存の採用企業またはATSは、この移行ガイドをご参照ください。

スクリーニング用の質問のテスト

Indeed エントリー質問用ツールを使用してJSONファイルのシンタックスを確認し、スクリーニング用の質問項目の体裁を確認してください。

Indeed エントリー経由の応募プロセスのフロー全体をテストする場合は、外部のテストツールを使用します。このフローには、スクリーニング用の質問プロセス全体を含めることができます。

Back to top

応募データの受信について

PostUrl

応募をプログラムで処理する場合は、Indeed エントリーがPOSTリクエストを送信する宛先URLを指定してください。indeed-apply-postUrlのデータ属性は、Indeed が応募データをPOSTする宛先のURLを含む文字列にする必要があります。URLはHTTPSである必要があります。

PostUrlの例

<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=Austi
n+TX&indeed-apply-jobUrl=http%3A%2F%2Fwww.indeed.com&indeed-apply-postUr
l=https%3A%2F%2Fhookb.in%2FPxOjJqJELNH8lZLZDkpz&indeed-apply-questions=h
ttps%3A%2F%2Fpastebin.com%2Fraw%2F0vXq9q9b%23]]></indeed-apply-data>

応募データはHTTP POSTリクエストの生の本文として送信されるので、一般的なフォームと同じようにリクエストは処理されません。リクエストボディには、読み込んでパースする必要があるJSONドキュメントが含まれます。JSONフィールドが未入力の場合、未入力フィールドを空白として扱い、認識されないフィールドを無視する堅牢なJSONパーサを使用する必要があります。

注意:JSONデータのペイロードの最大サイズはありません。

POSTの本文はUTF-8でエンコードされ、Indeed が応募を送信していることを証明する、信頼性のあるヘッダーを含みます。

Applicantフィールドのファイル部分にはcontentType、data、fileNameという3つのフィールドが含まれます。

  • ContentTypeは、fileNameに基づいて判定されます。
  • dataフィールドには、Base64でエンコードされた生の履歴書ファイルが含まれます。
  • サードパーティは、txt、pdf、doc、docx、rtfの各ファイル形式に対応している必要があります。

注意:POSTを別のURLにリダイレクトしないでください(301および302リダイレクト等)。Indeed エントリーでは、リダイレクトが処理されません。

JSON応募データの例

JSON履歴書のアップロードの例

{
	"id": "2b806761c722b0bf431e67168a74bfaf4d67e6070d6ac0160cace3277f6b99df",
	"job": {
		"jobId": "123456",
		"jobKey": "8q2w4e4r5t6y7u8i",
		"jobTitle": "Test Engineer",
		"jobCompany": "Your Company",
		"jobLocation": "Austin TX",
		"jobUrl": "http://www.yourcompany.com/careers/yourjob123",
		"jobMeta": "job-meta"
	},
	"applicant": {
    "fullName": "Indeed Tester",
    "coverletter": "Cover Letter of Indeed Tester for Your Company",
    "email": "Indeed.Tester@indeed.com",
    "phoneNumber": "+123321-1111111",
	 "resume": {
      "file": {
        "id": "13ffsffc30b0737c5b2927c0sfqq24rr8a214ef4ca6cacded5dcaa3032e8fcd3",
        "fileName": "Indeed_Tester-Upload-Resume.pdf",
        "contentType": "application/pdf",
        "data": "VBeead131ERi0x"
      }
    },
    "verified": true
    },
  "questions": {
    "url": "https://apply.qa.indeed.net/indeedapply/static/questions/basic.json",
    "retrievedOnMillis": 0,
    "questions": [
      {
        "id": "automation_exp",
        "question": "How many years of Automation experience do you have?",
        "type": "text",
        "required": true,
        "format": "integer",
        "min": "0",
        "max": "99",
        "limit": "300",
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "japanese",
        "question": "Do you speak Japanese?",
        "type": "select",
        "required": true,
        "options": [
          {
            "label": "Yes",
            "value": "0"
          },
          {
            "label": "No",
            "value": "1"
          }
        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "experience",
        "question": "Describe your most favourite ice cream flavor",
        "type": "textarea",
        "required": false,
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "extra",
        "question": "Website Url",
        "type": "text",
        "required": false,
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "multi",
        "question": "Which countries would you relocate to? (you can select multiple)",
        "type": "multiselect",
        "required": false,
        "options": [
          {
            "label": "United States",
            "value": "0"
          },
          {
            "label": "Canada",
            "value": "1"
          },
          {
            "label": "Mexico",
            "value": "2"
          },
          {
            "label": "Belize",
            "value": "3"
          },
          {
            "label": "Other",
            "value": "4"
          }
        ],
        "hierarchicalOptions": [

        ]
      }
    ],
    "answers": [
      {
        "id": "automation_exp",
        "value": "12"
      },
      {
        "id": "japanese",
        "value": "0"
      },
      {
        "id": "experience",
        "value": "Ice Cream"
      },
      {
        "id": "extra",
        "value": "www.testurl.com"
      },
      {
        "id": "multi",
        "values": [
          "1",
          "2",
          "3"
        ]
      }
    ]
  },
  "questionsAndAnswers": {
    "url": "https://apply.qa.indeed.net/indeedapply/static/questions/basic.json",
    "retrievedOnMillis": 0,
    "questionsAndAnswers": [
      {
        "question": {
          "id": "automation_exp",
          "question": "How many years of Automation experience do you have?",
          "type": "text",
          "required": true,
          "format": "integer",
          "min": "0",
          "max": "99",
          "limit": "300",
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "12"
      },
      {
        "question": {
          "id": "japanese",
          "question": "Do you speak Japanese?",
          "type": "select",
          "required": true,
          "options": [
            {
              "label": "Yes",
              "value": "0"
            },
            {
              "label": "No",
              "value": "1"
            }
          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": {
          "label": "Yes",
          "value": "0"
        }
      },
      {
        "question": {
          "id": "experience",
          "question": "Describe your most favourite ice cream flavor",
          "type": "textarea",
          "required": false,
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "Ice Cream"
      },
      {
        "question": {
          "id": "extra",
          "question": "Website Url",
          "type": "text",
          "required": false,
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "www.testurl.com"
      },
      {
        "question": {
          "id": "multi",
          "question": "Which countries would you relocate to? (you can select multiple)",
          "type": "multiselect",
          "required": false,
          "options": [
            {
              "label": "United States",
              "value": "0"
            },
            {
              "label": "Canada",
              "value": "1"
            },
            {
              "label": "Mexico",
              "value": "2"
            },
            {
              "label": "Belize",
              "value": "3"
            },
            {
              "label": "Other",
              "value": "4"
            }
          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": [
          {
            "label": "Canada",
            "value": "1"
          },
          {
            "label": "Mexico",
            "value": "2"
          },
          {
            "label": "Belize",
            "value": "3"
          }
        ]
      }
    ]
  },
  "analytics": {
		"ip": "0.0.0.0",
		"advNum": "1212121212121",
		"userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36",
		"device": "desktop",
		"sponsored": false
	},
	"appliedOnMillis": 1629153774243,
	"locale": "nl"
}

JSON履歴書のアップロードの例 (Resume Fieldsがある場合)

{ 
   "applicant":{ 
      "email":"john.doe@indeed.com",
      "fullName":"John Doe",
      "phoneNumber":"555-555-4321",
      "fullnamePronunciation":"じょん どー",
      "gender":"FEMALE",
      "dateOfBirth":"2000-01-20",
      "verified":true,
      "resume":{ 
         "file":{ 
            "contentType":"text/plain",
            "data":"SGVsbG8h",
            "fileName":"resume.txt"
         },
         "json":{ 
           "firstName":"John",
            "lastName":"Doe",
            "phoneNumber":"555-555-4321",
            "location":{ 
               "country": "JP",
               "city": "東京都 新宿区",
               "addressLine": "西新宿 7-18-10",
               "addressLine2": "エクシール新宿 #201",
               "postalcode": "111-1111",
            },
            "skills":"Microsoft Office, Java (10 年以上)",
            "positions":{ 
               "_total":1,
               "values":[ 
                  { 
                     "title":"Product Manager",
                     "company":"Indeed",
                     "location":"Austin, TX",
                     "startDateMonth":"09",
                     "startDateYear":"2007",
                     "endDateMonth":"-1",
                     "endDateYear":"-1",
                     "endCurrent":true,
                     "description":"I am the current product manager for Indeed Apply."
                  }
               ]
            },

            "educations":{ 
               "_total":1,
               "values":[ 
                  { 
                     "degree":"B.A.",
                     "field":"Computer Science",
                     "school":"University of Texas, Austin",
                     "location":"Austin, TX",
                     "startDate":"2002",
                     "endDate":"2006",
                     "endCurrent":false
                  }
               ]
            },
            "links":{ 
               "_total":1,
               "values":[ 
                  { 
                     "url":"http://www.indeed.com"
                  }
               ]
            },
            "awards":{ 
               "_total":1,
               "values":[ 
                  { 
                     "title":"Best PM at Indeed",
                     "dateMonth":"04",
                     "dateYear":"2008",
                     "description":"Best PM is voted on by Indeed employees and given to the PM with the most votes."
                  }
               ]
            },
            "certifications":{ 
               "_total":1,
               "values":[ 
                  { 
                     "title":"cert-title",
                     "startDateMonth":"02",
                     "startDateYear":"2007",
                     "endDateMonth":"02",
                     "endDateYear":"2008",
                     "endCurrent":false,
                     "description":"cert-description"
                  }
               ]
            },
           "languages": {
               "_total": 2,
               "values": [{
                    "language": "English",
                    "proficiency": "fluent"
               },{
                    "language": "Japanese",
                    "proficiency": "native"
               }]
            },
            "associations":{ 
               "_total":1,
               "values":[{ 
                     "title":"group-title",
                     "startDateMonth":"01",
                     "startDateYear":"2009",
                     "endDateMonth":"-1",
                     "endDateYear":"-1",
                     "endCurrent":true,
                     "description":"group-description"
                  }]
            },
            "patents":{ 
               "_total":1,
               "values":[ 
                  { 
                     "patentNumber":"patent-number",
                     "title":"patent-title",
                     "url":"patent-url",
                     "dateMonth":"02",
                     "dateYear":"2009",
                     "description":"patent-description"
                  }
               ]
            },
            "publications":{ 
               "_total":1,
               "values":[ 
                  { 
                     "title":"pub-title",
                     "url":"pub-url",
                     "dateDay":"14",
                     "dateMonth":"10",
                     "dateYear":"2004",
                     "description":"pub-description"
                  }
               ]
            },
            "militaryServices":{ 
               "_total":1,
               "values":[ 
                  { 
                     "serviceCountry":"mil-country",
                     "branch":"mil-branch",
                     "rank":"mil-rank",
                     "startDateMonth":"02",
                     "startDateYear":"2003",
                     "endDateMonth":"12",
                     "endDateYear":"2008",
                     "endCurrent":false,
                     "commendations":"mil-commendations",
                     "description":"mil-description"
                  }
               ]
            }
         }
      }
   },
   "appliedOnMillis":1325276227653,
   "job":{ 
      "jobCompany":"Your Company",
      "jobId":"7775e2bc62b7f77e",
      "jobLocation":"New York, NY 10110",
      "jobMeta":"",
      "jobTitle":"Test Engineer",
      "jobUrl":"http://www.yourcompany.com/careers/yourjob123.html"
   },
   "locale":"en_US"
}

JSON Indeed 履歴書の例

{
  "id": "2b806761c722b0bf431e67168a74bfaf4d67e6070d6ac0160cace3277f6b99df",
  "job": {
    "jobId": "123456",
    "jobKey": "8q2w4e4r5t6y7u8i",
    "jobTitle": "Test Engineer",
    "jobCompany": "Your Company",
    "jobLocation": "Austin TX",
    "jobUrl": "http://www.yourcompany.com/careers/yourjob123",
    "jobMeta": "job-meta"
  },
  "applicant": {
    "fullName": "Indeed Tester",
    "firstName": "Indeed",
    "lastName": "Tester",
    "coverletter": "Cover Letter of Indeed Tester for Your Company",
    "email": "Indeed.Tester@indeed.com",
    "phoneNumber": "+123321-1111111",
    "resume": {
      "file": {
        "fileName": "Indeed_Tester.pdf",
        "contentType": "application/pdf",
        "data": "JVBERi0xL=="
      },
      "html": "<html><head></head><body>Resume Content</body></html>",
      "json": {
        "firstName": "Indeed",
        "lastName": "Tester",
        "email": "Indeed.Tester@indeed.com",
        "headline": "headline",
        "summary": "summary",
        "additionalInfo": "additionalinfo",
        "phoneNumber": "555-555-4321",
        "location": {
          "country": "US",
          "city": "Austin, TX",
          "postalcode": "12345"
        },
        "personalDetails": {

        },
        "skills": "Skill 1, Skill 2, Skill 3",
        "positions": {
          "_total": 2,
          "values": [
            {
              "startDateMonth": "01",
              "startDateYear": "2015",
              "endCurrent": true,
              "title": "Product Manager",
              "company": "Indeed",
              "location": "Austin, TX",
              "description": "This is a job I had. This is a description of what I did there. Resume used for testing purposes only."
            },
            {
              "startDateMonth": "04",
              "startDateYear": "2010",
              "endDateMonth": "01",
              "endDateYear": "2015",
              "endCurrent": false,
              "title": "Software Engineer",
              "company": "Indeed",
              "location": "Austin, TX",
              "description": "This is a job I had. This is the description of what I did. Used for testing purposes only."
            }
          ]
        },
        "educations": {
          "_total": 1,
          "values": [
            {
              "degree": "Bachelor of Arts",
              "field": "Graphic Design",
              "school": "University of Texas",
              "location": "Austin, TX",
              "startDate": "2014",
              "endDate": "2019",
              "startDateYear": "2014",
              "endDateYear": "2019",
              "startDateMonth": "01",
              "endDateMonth": "02",
              "endCurrent": false
            }
          ]
        },
        "languages": { 
          "_total": 1, 
          "values": [ 
            { 
              "language": "French", 
              "proficiency": "Fluent" 
            } 
          ] 
        },
        "links": {
          "_total": 1,
          "values": [
            {
              "url": "http://www.indeed.com"
            }
          ]
        },
        "awards": {
          "_total": 1,
          "values": [
            {
              "dateMonth": "04",
              "dateYear": "2020",
              "title": "Award Title",
              "description": "award description"
            }
          ]
        },
        "certifications": {
          "_total": 0,
          "values": [

          ]
        },
        "associations": {
          "_total": 1,
          "values": [
            {
              "startDateMonth": "01",
              "startDateYear": "2014",
              "endDateMonth": "06",
              "endDateYear": "2018",
              "endCurrent": false,
              "title": "Group Title",
              "description": "group description"
            }
          ]
        },
        "patents": {
          "_total": 1,
          "values": [
            {
              "dateMonth": "04",
              "dateYear": "2012",
              "title": "Patent Title",
              "description": "patent description",
              "patentNumber": "12345",
              "url": "http://www.indeed.com"
            }
          ]
        },
        "publications": {
          "_total": 1,
          "values": [
            {
              "dateMonth": "08",
              "dateYear": "2019",
              "title": "Publication Title",
              "description": "publication description",
              "url": "http://www.indeed.com"
            }
          ]
        },
        "militaryServices": {
          "_total": 1,
          "values": [
            {
              "startDateMonth": "02",
              "startDateYear": "2003",
              "endDateMonth": "05",
              "endDateYear": "2009",
              "endCurrent": false,
              "serviceCountry": "US",
              "branch": "military branch",
              "rank": "rank",
              "commendations": "military commendations",
              "description": "military service description"
            }
          ]
        }
      },
      "text": "resume in text format"
    },
    "verified": true
  },
  "questions": {
    "url": "https://apply.qa.indeed.net/indeedapply/static/questions/basic.json",
    "retrievedOnMillis": 0,
    "questions": [
      {
        "id": "automation_exp",
        "question": "How many years of Automation experience do you have?",
        "type": "text",
        "required": true,
        "format": "integer",
        "min": "0",
        "max": "99",
        "limit": "300",
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "japanese",
        "question": "Do you speak Japanese?",
        "type": "select",
        "required": true,
        "options": [
          {
            "label": "Yes",
            "value": "0"
          },
          {
            "label": "No",
            "value": "1"
          }
        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "experience",
        "question": "Describe your most favourite ice cream flavor",
        "type": "textarea",
        "required": false,
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "extra",
        "question": "Website Url",
        "type": "text",
        "required": false,
        "options": [

        ],
        "hierarchicalOptions": [

        ]
      },
      {
        "id": "multi",
        "question": "Which countries would you relocate to? (you can select multiple)",
        "type": "multiselect",
        "required": false,
        "options": [
          {
            "label": "United States",
            "value": "0"
          },
          {
            "label": "Canada",
            "value": "1"
          },
          {
            "label": "Mexico",
            "value": "2"
          },
          {
            "label": "Belize",
            "value": "3"
          },
          {
            "label": "Other",
            "value": "4"
          }
        ],
        "hierarchicalOptions": [

        ]
      }
    ],
    "answers": [
      {
        "id": "automation_exp",
        "value": "12"
      },
      {
        "id": "japanese",
        "value": "0"
      },
      {
        "id": "experience",
        "value": "Ice Cream"
      },
      {
        "id": "extra",
        "value": "www.testurl.com"
      },
      {
        "id": "multi",
        "values": [
          "1",
          "2",
          "3"
        ]
      }
    ]
  },
  "questionsAndAnswers": {
    "url": "https://apply.qa.indeed.net/indeedapply/static/questions/basic.json",
    "retrievedOnMillis": 0,
    "questionsAndAnswers": [
      {
        "question": {
          "id": "automation_exp",
          "question": "How many years of Automation experience do you have?",
          "type": "text",
          "required": true,
          "format": "integer",
          "min": "0",
          "max": "99",
          "limit": "300",
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "12"
      },
      {
        "question": {
          "id": "japanese",
          "question": "Do you speak Japanese?",
          "type": "select",
          "required": true,
          "options": [
            {
              "label": "Yes",
              "value": "0"
            },
            {
              "label": "No",
              "value": "1"
            }
          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": {
          "label": "Yes",
          "value": "0"
        }
      },
      {
        "question": {
          "id": "experience",
          "question": "Describe your most favourite ice cream flavor",
          "type": "textarea",
          "required": false,
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "Ice Cream"
      },
      {
        "question": {
          "id": "extra",
          "question": "Website Url",
          "type": "text",
          "required": false,
          "options": [

          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": "www.testurl.com"
      },
      {
        "question": {
          "id": "multi",
          "question": "Which countries would you relocate to? (you can select multiple)",
          "type": "multiselect",
          "required": false,
          "options": [
            {
              "label": "United States",
              "value": "0"
            },
            {
              "label": "Canada",
              "value": "1"
            },
            {
              "label": "Mexico",
              "value": "2"
            },
            {
              "label": "Belize",
              "value": "3"
            },
            {
              "label": "Other",
              "value": "4"
            }
          ],
          "hierarchicalOptions": [

          ]
        },
        "answer": [
          {
            "label": "Canada",
            "value": "1"
          },
          {
            "label": "Mexico",
            "value": "2"
          },
          {
            "label": "Belize",
            "value": "3"
          }
        ]
      }
    ]
  },
  "analytics": {
    "ip": "0.0.0.0",
    "advNum": "1212121212121",
    "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/92.0.4515.107 Safari/537.36",
    "device": "desktop",
    "sponsored": false
  },
  "appliedOnMillis": 1629153774243,
  "locale": "nl"
}

Indeed エントリーのJSONフィールド

最上部階層のフィールド


最上部階層のフィールドの表
フィールド名 内容
id Indeed が指定した応募の固有ID。
Indeed と評価データを共有する際に、 このIDと応募状況を含めてください。
5156eb63c9a0a8ac
9358c3a444a2818c
8a5ffdbcba5960ec
0cace3277f6b99df
appliedOnMillis standard Unix time形式で表示された、ユーザーが応募した日付と時間。 1324051581711
job ボタンのHTMLデータ属性によって提供されるデータを表す求人のオブジェクト。 Jobオブジェクトをご覧ください。
applicant 応募者を表すApplicantオブジェクト。 Applicantオブジェクトをご覧ください。
analytics

以下の情報を含むオブジェクトです。

  • ip:ユーザーのIPアドレス
  • referer:「簡単応募」ボタンを利用している場合、ボタンの表示されているページ
  • userAgent:ユーザーのデバイスおよびユーザーエージェント
  • targetedApplyAd:Indeed エントリーの求人が Indeed に掲載されている場合、trueを返します
  • trackingUid:Indeed チームが社内で使用している値
  • sponsored:Indeed 検索結果ページで求人が有料掲載されている場合はtrue、求人がオーガニックであり、無料掲載の場合はfalseを返します

注意:sponsoredは、ユーザーがサードパーティのWebサイトから応募する場合や、求職者が Indeed のターゲット広告(ITA)製品から応募するよう指示されている場合など、Indeed サイト上でクリックが発生しない場合にempty/absentを返します。サードパーティのサイトでは、求人が有料掲載されているかどうかを判定できません。

サードパーティのサイトで発生した有料掲載求人のクリックをトラッキングするには、URLのトラッキングを有効にしてください。JSONの応答には「sponsored」のパラメータが含まれていないので、XML-onlyの応答を有効にする必要があります。サードパーティのサイト上で有料掲載求人をトラッキングするには、クライアントの採用企業アカウント内の求人ごとに設定し、joburlに埋め込む必要があります。これにより、ATSでの追跡が可能になります。

locale 求人への応募の際に使用されたロケール。 ja_JP

Jobオブジェクトのフィールド

注意:これらのフィールドはボタンの設定に基づきます。


Jobオブジェクトのフィールドの表
フィールド名 内容
jobTitle 表示する求人の職種名。 テストエンジニア
jobCompany 採用企業名。

注意:データ属性(data-attributes)ではjobCompanyNameです。
貴社のお名前
jobLocation 勤務地。 東京都港区

Applicantフィールド


Applicantフィールドの表
フィールド名 入力の有無 内容
fullName 必須 応募者の名前。ユーザーが Indeed 履歴書を使用している場合はfirstName+lastNameとなります。 田中一郎
firstName 任意 応募者の名。「name」フィールドで「firstlastname」が指定されます 一郎
lastName 任意 応募者の姓。「name」フィールドで「firstlastname」が指定されます 田中
email 必須 応募者のメールアドレス。 ichiro.tanaka@indeed.com
phoneNumber 任意 応募者が入力している場合、電話番号を表示。 +81 90 0000 0000
fullNamePronunciation 任意 氏名のふりがな。日本でresumefieldsrequiredまたはresumefieldsoptionalが入力されている場合は常に入力されます。ひらがな・カタカナでの入力が可能。 せな かな
firstNamePronunciation 任意 応募者の名前のふりがな。「name」フィールドで「firstlastname」が指定されている場合に入力されます。 日本でresumefieldsrequiredまたはresumefieldsoptionalが入力されている場合は常に入力されます。ひらがな・カタカナでの入力が可能。 かな
lastNamePronunciation 任意 応募者の姓のふりがな。「name」フィールドで「firstlastname」が指定されている場合に入力されます。 日本でresumefieldsrequiredまたはresumefieldsoptionalが入力されている場合は常に入力されます。ひらがな・カタカナでの入力が可能。 せな
dateOfBirth 任意 応募者が入力している場合、生年月日を表示。日、月、年が入力され、順序は市場ごとにローカライズされます。 利用できる国:アラブ首長国連邦、アルゼンチン、バーレーン、ブラジル、クック諸島、中国、コロンビア、コスタリカ、エクアドル、エジプト、スペイン、フランス、香港、インドネシア、インド、イタリア、日本、韓国、クウェート、モロッコ、メキシコ、マレーシア、ナイジェリア、オマーン、パナマ、ペルー、ポルトガル、カタール、ロシア、サウジアラビア、シンガポール、トルコ、台湾、ウクライナ、ウルグアイ、ベネズエラ、ベトナム、南アフリカ 2010-03-04
gender 任意 応募者が入力している場合、性別を表示。利用できる国:日本。取りうる値はNONE, MALE, FEMALE。ただしoptional設定で応募者が入力しなかった場合は空欄となります。 FEMALE
coverletter 任意 応募者の送付状。ユーザーが送付状を提供していない場合、このフィールドはJSONオブジェクトに表示されません。 送付状
resume 任意 ユーザーの履歴書を表すオブジェクト。 Resumeフィールドの項目をご覧ください。
verified 必須

求職者のメールアドレスが認証済みかどうかを示すフラグ。以下の場合はtrueが表示されます。

  • ユーザーが認証済みのアカウントにログインしており、応募のメールアドレスがそのアカウントに関連付けられたメールアドレスと一致している
  • ユーザーはログアウトしているが、メールアドレスがワンタイムパスワードによって認証されている

これ以外の場合、フラグはfalseに設定されます。

true

Resumeフィールド


Resumeフィールドの表
フィールド名 履歴書のアップロードの有無 Indeed 履歴書の有無 内容
file 必須 必須 バイナリの履歴書ファイルを含むオブジェクト
text 任意 必須 テキスト形式の履歴書。ユーザーが Indeed 履歴書を使用している場合にのみ提供されます。
html 任意 必須 履歴書の形式。ユーザーが Indeed 履歴書を使用している場合にのみ提供されます。
json 任意 必須 JSON形式の履歴書データ。以下の Indeed 履歴書をご覧ください。

Resumeファイルフィールド


Resumeファイルフィールドの表
名前 内容
data Base 64を使用してエンコードされた、ファイルの生のバイナリバイト。 SGVsbG8h=
fileName アップロードされた履歴書のファイル名。Indeed 履歴書を使用している場合、ファイル名は自動生成されます。 resume.txt
contentType 履歴書ファイルの拡張子で識別されるコンテンツの種類。 application/octet-stream

Indeed 履歴書フィールド

配列のような(Array-like)オブジェクトには、_totalフィールドとvaluesフィールドが含まれます。_totalフィールドは、配列の長さを示す整数です。valuesフィールドは、_totalオブジェクトを含むJSON配列です。


Indeed 履歴書フィールドの表
フィールド名 種類 内容
firstName 文字列 応募者の名前。
lastName 文字列 応募者の姓。
headline 文字列 応募者の履歴書の見出し。
summary 文字列 応募者の履歴書の概要。
publicProfileUrl url ユーザーの Indeed 履歴書を閲覧するためのURL(公開されている場合)。
additionalInfo 文字列 その他の追加情報。
phoneNumber 文字列 ユーザーの電話番号(ユーザーの Indeed 履歴書に記載がある場合)。
location オブジェクト ユーザーの位置情報を表すJSONオブジェクト(入力されている場合)。
location.city 文字列 応募者の居住する都道府県・市区町村。
location.country 文字列 応募者の居住国。
location.postalcode 文字列 応募者の居住地の郵便番号。
location.addressLine 文字列 応募者の住所の地名・番地。
location.addressLine2 文字列 応募者の住所の建物名・部屋番号。
Personal details オブジェクト 応募者から提出された個人情報詳細
注意:これらは各フィールドに記載されている一部の市場でのみ該当します。
skills 文字列 応募者のスキル。
positions array-like 職務内容オブジェクトのarray-likeオブジェクト。
educations array-like 学歴オブジェクトのarray-likeオブジェクト。
languages array-like 言語オブジェクトのarray-likeオブジェクト。
links array-like リンクオブジェクトのarray-likeオブジェクト。
awards array-like 功績オブジェクトのarray-likeオブジェクト。
certifications array-like 資格オブジェクトのarray-likeオブジェクト。
associations array-like 関連団体オブジェクトのarray-likeオブジェクト。
patents array-like 特許オブジェクトのarray-likeオブジェクト。
publications array-like 出版物オブジェクトのarray-likeオブジェクト。
militaryServices array-like 兵役オブジェクトのarray-likeオブジェクト。
languages array-like 言語オブジェクトの矢印のようなオブジェクト。

個人情報詳細フィールド


個人情報詳細フィールドの表
フィールド名 種類 該当市場 内容
highestLevelOfEducation 単一値 アラブ首長国連邦、オーストラリア、ベルギー、ブラジル、カナダ、チリ、コロンビア、コスタリカ、チェコ、デンマーク、エクアドル、スペイン、英国、香港、ハンガリー、アイルランド、イタリア、ルクセンブルク、メキシコ、ナイジェリア、オランダ、ノルウェー、パナマ、ペルー、ポーランド、ポルトガル、ルーマニア、ロシア、スウェーデン、トルコ、台湾、ウクライナ、ウルグアイ、ベネズエラ、ベトナム、南アフリカ 応募者が最終学歴を選択できる、該当市場向けの学歴のドロップダウン。 GCSEまたは同等の
高等教育ディプロマ
employmentEligibility 単一値 アラブ首長国連邦、オーストラリア、バーレーン、エジプト、英国、香港、イタリア、クウェート、モロッコ、ニュージーランド、オマーン、カタール、ロシア、サウジアラビア、シンガポール 求職者がその国で就労する資格を持つかどうかを尋ねる質問。 必須
highestCareerLevel 単一値 フランス、香港、インド、韓国、ベトナム、南アフリカ 求職者は業務経験を4つのレベルから選択可能。 新卒
industry 複数値 アラブ首長国連邦、アルゼンチン、バーレーン、ブラジル、チリ、中国、コロンビア、コスタリカ、エクアドル、エジプト、スペイン、フランス、英国、アイルランド、インド、韓国、クウェート、ルクセンブルク、モロッコ、メキシコ、ナイジェリア、オマーン、パナマ、ペルー、カタール、ロシア、サウジアラビア、トルコ、台湾、ウクライナ、ウルグアイ、ベネズエラ、南アフリカ 応募者が働いている、または専門とする業界を選択できるドロップダウン。 芸術および娯楽
driversLicense 複数値 アルゼンチン、ベルギー、チリ、コロンビア、コスタリカ、チェコ、エクアドル、スペイン、英国、イタリア、日本、メキシコ、オランダ、パナマ、ペルー、ロシア、トルコ、ウルグアイ、ベネズエラ、南アフリカ 各市場向けにローカライズされた運転免許のオプションのドロップダウン。 普通免許
dateOfBirth 日付 アラブ首長国連邦、アルゼンチン、バーレーン、ブラジル、クック諸島、中国、コロンビア、コスタリカ、エクアドル、エジプト、スペイン、フランス、香港、インドネシア、インド、イタリア、日本、韓国、クウェート、モロッコ、メキシコ、マレーシア、ナイジェリア、オマーン、パナマ、ペルー、ポルトガル、カタール、ロシア、サウジアラビア、シンガポール、トルコ、台湾、ウクライナ、ウルグアイ、ベネズエラ、ベトナム、南アフリカ 日、月、年の3つのドロップダウン。順序は市場ごとにローカライズされています。 年月日(dd/MM/yyyy)
educationDescription 自由記述 スイス、ドイツ、ノルウェー、スウェーデン、ウクライナ、ウルグアイ、ベトナム 求職者が学歴を記載可能。 自由記述
gender 単一値 日本 求職者の性別。 女性
disability 単一値 ブラジル、イタリア、メキシコ、南アフリカ ブラジルでは、さまざまな障がいに関するオプションのドロップダウンが表示されます。その他の市場では、「はい」および「いいえ」が表示されます。 認知障がい
または
「はい」
ethnicity 単一値 南アフリカ 民族に関するオプションのドロップダウン。 アフリカ人
veteranStatus 単一値 韓国 求職者の兵役の経験。 該当する
NYSCStatus 単一値 ナイジェリア 求職者のNYSCステータスに関するドロップダウン。 継続中
employmentSupportStatus 単一値 韓国 求職者の就労支援の状況。 該当する
willingToTravel 単一値 アルゼンチン、チリ、コロンビア、コスタリカ、エクアドル、スペイン、メキシコ、パナマ、ペルー、ウルグアイ、ベネズエラ 求職者の出張への意欲に関するドロップダウン。 はい
europeanUnionWorkPermit 単一値 アイルランド 求職者が欧州での就労許可を持っているかどうかを尋ねる質問。 はい
citizenship 単一値 フィリピン、シンガポール、南アフリカ 求職者の市民権に関するドロップダウン。 南アフリカ共和国の市民
IDP チェックボックス ウクライナ 求職者が国内避難民であるかどうかを尋ねる質問。 IDP(国内避難民)
employmentEligibilityMultiCountries 複数値 スペイン、インド 求職者が就労資格を有する国について尋ねる質問のドロップダウン。 アフガニスタン
idNumber 数値 ブラジル、イタリア、トルコ、南アフリカ 求職者にID番号の入力を促す質問。 数値
totalYearsOfExperience 数値 インドネシア、インド 求職者に経験年数を尋ねる質問。 3
hobbiesAndInterests 自由記述 チェコ、ハンガリー、韓国、ルクセンブルク、ポーランド、ロシア 求職者に趣味や興味を尋ねる質問。 自由記述
spouse 文字列 日本 2022年4月以降で順次対応(詳細はお問い合わせください)
求職者の配偶者の有無を表示。 以下のいずれかの値が入力されます。 はい、いいえ、無回答(無回答は、求職者が質問に回答しなかったことを示します)
はい
spouseAsDependent 文字列 日本 2022年4月以降で順次対応(詳細はお問い合わせください)
求職者の配偶者が扶養家族であるかどうか。 以下のいずれかの値が入力されます。 はい、いいえ、無回答(無回答は、求職者が質問に回答しなかったことを示します)
はい

Indeed 履歴書の職歴情報(position)フィールド


Indeed 履歴書の職歴情報(position)フィールドの表
フィールド名 種類 内容
title 文字列 職種名。 プロダクトマネージャー
company 文字列 会社名。 Indeed
location 文字列 勤務地。 テキサス州オースティン
description 文字列 職務内容。 --------
startDateMonth 文字列 就業を開始した⽉を表す1から12の間の整数を含む文字列。 "09"
startDateYear 文字列 就業を開始した年度の整数を含む文字列。 "2007"
endDateMonth 文字列 退職した⽉を表す1から12の間の整数を含む文字列。 "09"
endDateYear 文字列 退職した年度の整数を含む文字列。 "2007"
endCurrent boolean この仕事がユーザーの現職かどうかを示すフラグ。 true

Indeed 履歴書の学歴情報(education)フィールド


Indeed 履歴書の学歴情報(education)フィールドの表
フィールド名 種類 内容
degree 文字列 この教育機関で取得した学位。 学士
field 文字列 この教育機関で専攻した分野。 コンピュータサイエンス
school 文字列 教育機関の名称。 テキサス大学
location 文字列 教育機関の所在地。 テキサス州オースティン
startDateMonth 文字列 入学した⽉を表す1から12の間の整数を含む文字列。 "09"
startDateYear 文字列 入学した年度の整数を含む文字列。 "2007"
endDateMonth 文字列 卒業した⽉を表す1から12の間の整数を含む文字列。 "09"
endDateYear 文字列 卒業した年度の整数を含む文字列。 "2007"
endCurrent boolean この教育機関に在学中であることを示すフラグ。 true

Indeed 履歴書の言語(language)フィールド


Indeed 履歴書の言語(language)フィールドの表
フィールド名 種類 説明
language 文字列 話し言葉、書き言葉、手話。 フランス語
proficiency 文字列 話し言葉、書き言葉、手話の習得レベル。 流暢に話せる(上級者)

Indeed 履歴書のリンク(link)フィールドの表
フィールド名 種類 内容
url 文字列 リンクのURL。 https://www.indeed.com

Indeed 履歴書の功績(award)フィールド


Indeed 履歴書の功績(award)フィールドの表
フィールド名 種類 内容
title 文字列 功績の名称。 Indeed 最優秀PM
description 文字列 功績の内容。 社内で最も優秀なPMとして表彰。
dateMonth 文字列 受賞した⽉を表す1から12の間の整数を含む文字列。 "09"
dateYear 文字列 受賞した年度の整数を含む文字列。 "2007"

Indeed 履歴書の資格情報(certification)フィールド


Indeed 履歴書の資格情報(certification)フィールドの表
フィールド名 種類 内容
title 文字列 資格の名称。 PMP
description 文字列 資格の内容。 プロジェクトマネジメントプロフェッショナルの資格
startDateMonth 文字列 資格の開始⽉を表す1から12の間の整数を含む文字列。 "09"
startDateYear 文字列 資格の開始年度の整数を含む文字列。 "2007"
endDateMonth 文字列 資格が失効した⽉を表す1から12の間の整数を含む文字列。 "09"
endDateYear 文字列 資格が失効した年度の整数を含む文字列。 "2007"
endCurrent boolean この資格が現在も有効であることを示すフラグ。 true

Indeed 履歴書の関連団体(association groups)フィールド


Indeed 履歴書の関連団体(association groups)フィールドの表
フィールド名 種類 内容
title 文字列 団体の名称。 ソサエティ・フォー・テクニカル・コミュニケーション
description 文字列 この団体についての説明。 テクニカルコミュニケーションに携わるプロフェッショナルの団体。
startDateMonth 文字列 ⼊会した⽉を表す1から12の間の整数を含む文字列。 "09"
startDateYear 文字列 ⼊会した年度の整数を含む文字列。 "2007"
endDateMonth 文字列 退会した⽉を表す1から12の間の整数を含む文字列。 "09"
endDateYear 文字列 退会した年度の整数を含む文字列。 "2007"
endCurrent boolean 現在もこの団体に所属していることを示すフラグ。 true

Indeed 履歴書の特許(patent)フィールド


Indeed 履歴書の特許(patent)フィールドの表
フィールド名 種類 内容
title 文字列 特許の名称。 --------
description 文字列 この特許についての説明。 --------
patentNumber 文字列 特許番号。 --------
url 文字列 この特許のURL。 --------
dateMonth 文字列 特許を取得した⽉を表す1から12の間の整数を含む文字列。 "09"
dateYear 文字列 特許を取得した年度の整数を含む文字列。 "2007"

Indeed 履歴書の出版物(publication)フィールド


Indeed 履歴書の出版物(publication)フィールドの表
フィールド名 種類 内容
title 文字列 出版物の名称。 --------
description 文字列 この出版物についての説明。 --------
url 文字列 この出版物のURL。 --------
dateDay 文字列 ⽇付を表す整数を含む文字列。 "03"
dateMonth 文字列 ⽉を表す1から12の間の整数を含む文字列。 "09"
dateYear 文字列 出版年の整数を含む文字列。 "2007"

Indeed 履歴書の兵役(military service)フィールド


Indeed 履歴書の兵役(military service)フィールドの表
フィールド名 種類 内容
serviceBranch 文字列 所属する五軍の軍種。 --------
branch 文字列 五軍内所属時の組織。 --------
rank 文字列 所属時の階級。 --------
description 文字列 所属時についての説明。 --------
commendations 文字列 所属時に受けた表彰。 --------
startDateMonth 文字列 入隊した⽉を表す1から12の間の整数を含む文字列。 "09"
startDateYear 文字列 ⼊隊した年度の整数を含む文字列。 "2007"
endDateMonth 文字列 除隊した⽉を表す1から12の間の整数を含む文字列。 "09"
endDateYear 文字列 除隊した年度の整数を含む文字列。 "2007"
endCurrent boolean 現在軍隊に所属していることを示すフラグ。 true

POSTの信頼性

postUrlに対して送信されるPOSTリクエストには、そのPOSTの信頼性の証明に使用されるHTTPヘッダーが含まれています。Indeed エントリーは、共有APIシークレットを使用して、HMAC-SHA1アルゴリズムを利用したメッセージの署名を計算します。この署名はX-Indeed-Signature HTTPヘッダーとして送信されます。以下のコード例は、メッセージの署名がどのように生成されるかを示します。

C#(version 6.0)を利用した場合

using System;
using System.Security.Cryptography;
using System.Text;

class MainClass
{
  public static void Main(string[] args)
  {
    String message = getMessage();
    // This is a sample api Secret for demonstration do not alter
    String apiSecret = "Y0ur api secret key not shared &$%@";
    String signature = computeSignature(message, apiSecret);
    // Compare the message paylod signature hashed value to the pre-determined signature from the send...
    if (signature.Equals("SGadPKocf3HD1LYXm3xGObB6hzk="))
    {
      Console.WriteLine("Successful signature validation using B64 HMAC SHA1: " + signature);
    }
    else
      Console.WriteLine("Invalid Signature: " + signature);
  }

  static string computeSignature(string input, String key)
  {
    byte[] keyBytes = Encoding.UTF8.GetBytes(key);
    HMACSHA1 myhmacsha1 = new HMACSHA1(keyBytes);
    byte[] inputBytes = Encoding.UTF8.GetBytes(input);
    byte[] hash = myhmacsha1.ComputeHash(inputBytes);
      
    return System.Convert.ToBase64String(hash);
  }

  static string getMessage()
  {
    string msg = "{'locale':'en_US','applicant':{'fullName':'John Doe','email':'john.doe@example.com'}}";
    return msg;
  }

}

Java(openjdk version 17.0.4.1)を利用した場合

import javax.crypto.Mac;
import javax.crypto.spec.*;
import javax.crypto.SecretKey;
import java.util.Base64;
 
public class App {
  public static void main(String[] args) {
 
    String message = getMessage();
    String apiSecret = "Y0ur api secret key not shared &$%@";
    String signature = computeSignature(message, apiSecret);
    if(!signature.equals("SGadPKocf3HD1LYXm3xGObB6hzk="))
      System.out.println("Invalid Signature: "+signature);
    else
      System.out.println("Successful signature validation using B64 HMAC SHA1: " + signature);
  }
 
  static String computeSignature(String message, String apiSecret) {
    try{
      byte[] keyBytes = apiSecret.getBytes();
      SecretKey signingKey = new SecretKeySpec(keyBytes, "HmacSHA1");
      Mac mac = Mac.getInstance("HmacSHA1");
      mac.init(signingKey);
      return new String(Base64.getEncoder().encode(mac.doFinal(message.getBytes("UTF-8"))));
    } catch(Exception e) {
      System.out.println(e.getMessage());
      throw new RuntimeException(e);
    }
  }
 
  public static String getMessage() {
    return "{'locale':'en_US','applicant':{'fullName':'John Doe','email':'john.doe@example.com'}}";
  }
}

Perl(version 5.0)を利用した場合

use Digest::SHA qw(hmac_sha1_base64);
use Encode qw(encode);
 
# your secret key
$key = "Y0ur api secret key not shared &\$\%\@";

# test message
$message = get_message();
# compute signature
$signature = hmac_sha1_b64_string($key, $message);

if ($signature eq "SGadPKocf3HD1LYXm3xGObB6hzk=") {
  print "Successful signature validation using B64 HMAC SHA1: " . $signature, "n";
} else{
  print "Invalid Signature: ", $signature, "n";
}
 
sub hmac_sha1_b64_string {
  $keybtes = encode("UTF8", $key);
  $databytes = encode("UTF8", $message);
  $b64digest = hmac_sha1_base64($databytes, $keybtes);
  # Perl does not pad b64 output, so we have to do it manually
  while(length($b64digest) % 4) {
    $b64digest.= '=';
  }
  return $b64digest;
}
 
sub get_message {
  return "{'locale':'en_US','applicant':{'fullName':'John Doe','email':'john.doe\@example.com'}}";
}

PHP(version 7.0)を利用した場合

function sign($str, $key) {
  $opts= OPENSSL_RAW_DATA;
  $digest= hash_hmac("sha1", $str, $key, $raw_output = TRUE);
  $signature= base64_encode($digest);
  return$signature;
}
         
$api_secret= "Y0ur api secret key not shared &$%@";
$message= "{'locale':'en_US','applicant':{'fullName':'John Doe','email':'john.doe@example.com'}}";
         
$signature= sign($message,$api_secret);
         
if( $signature!= "SGadPKocf3HD1LYXm3xGObB6hzk=")
  print("Invalid Signature ". $signature);
else
  print("Successful signature validation using B64 HMAC SHA1: " . $signature);

Python(version 3.10)を利用した場合

from hashlib import sha1
import hmac
import base64

# your secret key
secret = "Y0ur api secret key not shared &$%@".encode("utf-8")
# test message
message = "{'locale':'en_US','applicant':{'fullName':'John Doe','email':'john.doe@example.com'}}".encode('UTF-8')
print(message)
# compute the hash
message_hashed = hmac.new(secret, message, sha1)
digest = message_hashed.digest()
# b64 encode the hash...this is the message authentication value
signature = base64.b64encode(digest)
if signature != b'SGadPKocf3HD1LYXm3xGObB6hzk=':
  print("Invalid Signature: " + str(signature))
else:
  print('Successful Signature Validation using B64 HMAC SHA1: ' + str(signature))

Node JS(LTS 16)を利用した場合

// Dependencies
const fs = require('fs');
const crypto = require('crypto');

const secret = "Your secret key - this the secret key associated with your Indeed Apply"

const xIndeedSignature = "This is the value of the X-Indeed-Signature return as part of the request headers";

/* Read data.json, this is the raw payload indeed send you in the body of the response.
create a data.json in the same directory with your index.js file
*/
const data = fs.readFileSync('data.json', { encoding: 'utf8', flag: 'r+' });

// Encode data in base64
const encodedStr = new Buffer.from(data).toString('base64');

//compute the hash
const signature = crypto.createHmac('SHA1', secret).update(encodedStr, 'base64').digest('base64');

// check the computed signature against the X-Indeed-Signature provided in the request_headers of your application
if (signature !== xIndeedSignature) {
console.log(`invalid signature: ${signature}`, `\nX-Indeed-Signature: ${xIndeedSignature}`);
} else {
console.log(`Computed signature matches: ${signature}`);
}
Back to top

SSLの利用

対応している証明書を確認するには、信頼されたルートSSL証明書の一覧をご覧ください。使用している証明書が一覧に記載されていない場合は、マーケットプレイスプラットフォームマネージャーに問い合わせて、連携をテストおよび確認してください。

Back to top

Indeed エントリー連携のテストと監視

Indeed では、Indeed を利用する求職者と採用企業のエクスペリエンスを向上させることを目標としています。連携の問題を避けるために、以下のセクションを再度確認してください。

Indeed エントリーのテスト

Indeed エントリーテストツールを使用して、Indeed エントリーのコードをテストしてください。テストツールを利用すると、求人のメタデータを入力し、適切なXML要素またはHTMLコードを生成できます。また、独自のXML要素またはHTMLコードを入力して、Indeed で正しくメタデータが読み込まれるかご確認いただけます。

Indeed エントリー質問用ツールを使用してJSONファイルのシンタックスを確認し、スクリーニング用の質問項目の体裁を確認してください。

連携の状態の監視

Indeed エントリーと連携する際、以下のことを監視できるように設定してください。

  • 連携で求人への応募がきちんと送信されている。
  • 質問のファイルが一貫して利用可能であり、有効なものになっている。

Indeed は応募書類が提携企業に正しく送信されているかどうかを、その他のステータスと共に監視します。問題が発生した際には、Indeed からご連絡いたします。場合によっては問題が解決するまで、一部またはすべての求人に対しての応募機能が無効となる場合があります。

注意: 未送信の状態の応募は消失するわけではありません。エラーが発生した場合は、最初の応募から一定の期間が経過すると自動的に応募が再試行されます。送信できなかった場合、応募書類は30日間保持され、要望に応じて再度送信を試みることができます。

連携の問題を避けるため、送信が正常に完了したすべての応募にHTTPのステータスコード200を必ず返してください。Indeed エントリーはその他のHTTPステータスコード、POSTタイムアウト、接続タイムアウトをエラーとみなします。

加えて、以下の状況に応じたステータスを返してください。

  • 409 (Conflict):重複した応募がすでにお客様のシステム内に存在する場合に使用してください。重複した応募とは、求職者が120日以内に同じメールアドレスから同じjobidに対して行った応募を指します。
  • 410 (Gone):Indeed が投稿しようとしている求人の有効期限が切れている場合、または応募が終了している場合に使用してください。HTTP 410で応答する場合、検索結果の求人が有効期限切れとなります。次のフィード実行時にも求人がXMLに記載されている場合は、求人が有効期限切れとなることはありません。

求人がスクリーニング用の質問を導入している場合、それらのファイルをホストするページが、以下の状態であることを確認してください。

  • 一貫して常に利用可能。
  • リダイレクトを行わない。
  • 適切な形式になっている。

連携に関するよくある問題

以下のよくある問題が、POST や Question URL などを利用した連携のエラーの原因となる可能性があります。


よくある問題一覧
問題 解決策
別ページへのリダイレクト(例:301リダイレクト)

POSTやQuestion URLがリダイレクトを含まないように必ず確認してください。

プロトコルの変更(例:HTTPをHTTPSに変更)が必要な場合は、以下の手順を必ず行ってください。

  • 301のリダイレクトエラーを送信する
  • ロケーションヘッダーにURLの正確なHTTPSバージョンを含める
これ以外の動作はエラーの原因となります。
有効期限の切れたSSL証明書 SSL証明書を更新してください。詳細については、信頼されたルート証明書の一覧をご覧ください。
誤って設定されたSSL

問題の分析と診断を行えるように、SSLサーバーテストを使用してください(例:https://www.ssllabs.com/ssltest/)。

以下の手順を行ってください。

  • 完全な証明書チェーンを送信する
  • チェーン内のいずれの証明書もダウンロードを追加で必要としないことを確認する
これ以外の動作はエラーの原因となります。

質問のJSONが無効、または Indeed が提示する必須条件に従っていない。 スクリーニング用の質問の要件を確認してください。変更のプレビューを行うには、Indeed エントリー質問のテストツールをご利用ください。
リソースにアクセスする際のその他の問題(404エラー、500エラー、タイムアウト)

通信量の多い期間に対応できるように、採用企業のリソースが確実に拡張できるような対策を実装してください。また、発生する可能性のある問題を Indeed が調査できるように、適切なHTTPレスポンスコードを使用してください。

Indeed では投稿のサイズを制限していないため、Indeed からのあらゆるサイズの投稿を確実に処理できるようにしてください。このリクエストに対応できない場合は、投稿が大きすぎることを示すHTTP 413エラーを返してください。

連携チェックリスト

マーケットプレイスプラットフォームマネージャーにXMLフィードをお送りいただく前に、以下のチェックリストを確認してください。お客様と Indeed 双方でXML提出作業を円滑に進められるように、本チェックリストの内容を行ってください。

  1. XMLファイルの上部にバージョン、エンコーディング、パブリッシャー情報含まれているか確認してください。
    <?xml version=”1.0” encoding=”utf-8”?>
        <source>
        <publisher> Example Job Site</publisher>
        <publisherurl>http://www.examplejobsite.com</publisherurl>
    
  2. XMLファイルにすべての採用企業を記載してください。多くの求人情報は Indeed 側にすでにリストとして存在しているため、採用企業の記載が漏れている場合にはXMLファイルが公開されなくなります。
  3. 親会社のサブブランドや子会社の求人も含め、自社Webサイトに掲載されているすべての求人を確実に含めるようにしてください。キャリアポータルに記載された求人掲載数とXMLに記載された求人掲載数に相違があると、提供されたXMLを介して提示される求人が目に留まりにくくなる可能性があります。 注意:すべての求人で、<url>タグの中に固有のURLを記載する必要があります。
  4. XMLフィードの要素のセクションに記載された、すべてのフィールドが存在し、正しい形式になっているか確認してください。
  5. ファイルからすべてのテスト用求人を削除してください。残っている場合、ファイルが却下されます。
  6. フィードに含めた Indeed エントリーデータを必ずテストしてください。問題が発生した場合、トラブルシューティングを行えるようにプラットフォームパートナーシップマネージャーまでご連絡ください。
    • Indeed エントリーボタンのテストツールとXML内の Indeed エントリーコードを使用して、フィードが正しく動作するか確認してください。
    • メタデータに含まれているすべてのURL(joburl、posturl、questions)が完全にURLエンコードされていることを確認してください。
    • analyticsのフィールドで、応募をオーガニック、有料掲載、Indeed ターゲット広告に分類できることを確認してください。
      詳しくは、Indeed エントリーのトップレベルのJSONフィールドをご覧ください。
    • すべての求人が、<job>ノード内に Indeed エントリーを含んでいるか確認してください。
    • メールを受信方法として選択している場合、メールアドレスが適切に暗号化されていることを必ず確認してください。
    • SSL証明書が有効で最新の状態であることを確認してください。
    • 質問項目テストツールを使用して、質問のJSONを確認してください。 注意:このテストツールは、有料掲載のデータ情報を提供しません。
    • スクリーニング用の質問項目が、ベストプラクティスに従っていることを確認してください。
    • マーケットプレイスプラットフォームマネージャーに、Indeed エントリーのオプトアウト手順のスクリーンショットを送ります。すべてのパートナーは、クライアントが使用できるように、システム内で Indeed エントリーのオプトアウトを開発する必要があります。
  7. 上記のステップをすべて完了していただくと、以下の手順のいずれかが実行可能になります。
    • XMLを Indeed のFTPにアップロードする(アカウントが必要な場合は、マーケットプレイスプラットフォームマネージャーまでご連絡ください)。
    • FTPまたはURLのGETリクエストにホストされているファイルを更新する。
  8. XMLを提出する前に内容を確認し、品質に関する問題があるかどうかを確認するツールを提供しますので、マーケットプレイスプラットフォームマネージャーにお問い合わせください。