スクリーナー質問用 JSON

JSON スクリーナー質問のパラメーター。

 

法的注意

• この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。

スクリーナー質問をサポートするシステムでは、連携承認のために Indeed エントリーで JSON スクリーナー質問パラメーターを実装する必要があります。

Indeed エントリーの応募フローでスクリーナー質問を表示するには、次のいずれかを使用します。

• JSON 形式で作成し、HTTPS URL にホストして、その URL を各 <job> の <indeed-apply-data> 要素配下にある <indeed-apply-questions> パラメーターに含めます。Indeed エントリーのスクリーナー質問を追加するをご覧ください。

• Job Sync API を呼び出して、スクリーナー質問付きの求人投稿を作成します。

スクリーナー質問 JSON ファイルの構文を検証するには、Indeed Apply Questions tool を使用してください。

スクリーナー質問に電話番号や email アドレスを含めないでください。デフォルトでは、応募データ に email アドレスが含まれます。電話番号を取得するには、Indeed エントリーのパラメーター を使用してください。

質問セクション

schemaVersion

必須

説明	Indeed エントリーのスクリーナー質問スキーマのバージョンです。 demographicQuestions と qualification を使用する場合は、JSON スキーマの先頭にこのフィールドを含めてください。省略するとエラーが発生します。 現在のバージョンは 1.3 です。Indeed は機能を追加すると、マイナーバージョンの更新をリリースします。配信 postbody には、1.1 や 1.2 などの 1.X 形式でスキーマバージョンが含まれます。 マイナーバージョンの更新で統合に支障が出ないように、この値は柔軟に扱ってください。
値	バージョン番号
例	"schemaVersion": "1.3"

screenerQuestions

必須

説明	このフィールドは、職歴、スキル、資格など、求人に関する一般的で適切に構成された質問に使用します。民族、性別、障害に関する人口統計の質問は含めないでください。保護対象クラス に関連する質問は、一部の法域で規制されており、Indeed のシステムとお客様のシステムの両方で特別に処理する必要があります。人口統計の質問は、代わりに demographicQuestions フィールドに配置してください。
値	オブジェクトです。 JSON questions parameters をご覧ください。
例	"screenerQuestions": { "questions": [{ "id": "license", "type": "select", "question": "Do you have a valid license?", "required": true, "options": [{ "label": "false", "value": "0" }, { "label": "true", "value": "1" }] }] }

demographicQuestions

説明	このフィールドは、民族、性別、障害など、応募者の 保護対象クラス に関する特定の、適切に構成された質問に使用します。これらの質問は一部の法域で規制されており、Indeed のシステムとお客様のシステムの両方で特別に処理する必要があります。 Indeed は EEO コンプライアンスのため、人口統計の質問を米国の求人に限定します。 職歴、スキル、資格に関する一般的なスクリーナー質問は含めないでください。これらの質問は、代わりに screenerQuestions フィールドに配置します。 demographicQuestions は hierarchical または file の質問タイプをサポートしていません。
値	オブジェクトです。 JSON questions parameters をご覧ください。
例	"demographicQuestions": { "questions": [{ "id": "disabilities", "type": "select", "question": "Do you have a disability?", "options": [{ "label": "false", "value": "0" }, { "label": "true", "value": "1" }], "required": false }] }

---

JSON 質問パラメーター

id

必須

説明	この質問の一意の ID です。
値	任意の文字列です。
例	strengths

type

必須

説明	質問のタイプです。 詳細については、各値の説明をご覧ください。
値	textarea text select hierarchical multiselect date file information pagebreak
例	textarea

question

"type": "information"

と

"type": "pagebreak"

を除き必須

説明	応募者に表示される質問テキストです。
値	任意の文字列です。
例	退役軍人のステータスは何ですか？

text

"type": "information"

の場合は必須

説明	応募者に表示されるテキストです。他の質問タイプではこのフィールドはサポートされません。
値	任意の文字列です。
例	次の質問は任意です。

options

"type": "select"

および

"type": "multiselect"

の場合は必須

説明	使用可能な選択肢です。
値	JSON です。
例	[{ "value": "1", "label": "女性" }]

value

"type": "select"

および

"type": "multiselect"

の場合は必須

説明	各オプションの値です。
値	任意の文字列です。
例	1

label

"type": "select"

および

"type": "multiselect"

の場合は必須

説明	メニューオプションのテキストです。select または multiselect の質問では、各 label はその質問内で一意である必要があります。
値	任意の文字列です。
例	女性

required

説明	true に設定すると質問が必須になり、空でないテキストフィールドまたは選択が必要になります。質問を任意にするには、このパラメーターを省略します。質問が任意で応募者が回答しない場合、Indeed は回答値として "" を送信します。
値	true
例	"required":true

format

"type": "date"

の場合は必須ですが、

"type": "text"

の場合は必須ではありません

説明	入力が受け付ける形式です。 "type": "text" では、integer、decimal、または numeric_text の検証ルールのみを使用できます。 "type": "date" では、SimpleDateFormat のみを使用できます。詳細については、date の質問タイプ をご覧ください。
値	テキスト形式: integer decimal numeric_text 日付形式: SimpleDateFormat
例	integer, dd/MM/yyyy

limit

説明	"type": "text" および "type": "textarea" での回答の文字数制限です。
値	任意の整数です。
例	100

minCharCount

説明	"type": "text" および "type": "textarea" での回答の最小文字数です。minCharCount は非数値形式にのみ適用されます。
値	任意の整数です。
例	50

min

説明	受け付ける最小値です。 "format": "integer" または "format": "decimal" の場合: 受け付ける最小の数値です。 "type": "date" の場合: 受け付ける最も早い日付です。 min は max 以下である必要があります。そうでない場合、検証は失敗します。
値	"format": "integer" の場合は任意の整数です。 "format": "decimal" の場合は任意の小数です。 "type": "date" の場合は任意の日付です（指定された形式）。
例	0

max

説明	受け付ける最大値です。 "format": "integer" または "format": "decimal" の場合: 受け付ける最大の数値です。 "type": "date" の場合: 受け付ける最も遅い日付です。 max は min 以上である必要があります。そうでない場合、検証は失敗します。
値	"format": "integer" の場合は任意の整数です。 "format": "decimal" の場合は任意の小数です。 "type": "date" の場合は任意の日付です（指定された形式）。
例	100

minSelectionCount

説明	"multi-select" の場合に、応募者が選択する必要があるオプションの最小数です。
値	任意の整数です。
例	2

maxSelectionCount

説明	"multi-select" の場合に、応募者が選択できるオプションの最大数です。
値	任意の整数です。
例	4

condition

説明	前の select 質問への回答に応じて、質問を条件付きで表示します。前の質問の id と、この質問を有効にするオプションの value を指定します。 たとえば、応募者に兵役経験があるかどうかを尋ねます。回答が「はい」の場合は、どの軍種に所属していたかを尋ねる条件付き質問を表示します。
値	JSON です。
例	"condition": { "id": "parent1", "value": 0 }

hierarchicalOptions

説明	前の選択に基づいて後続の質問と回答を表示します。たとえば、応募者に州を選択させ、その後に選択した州の都市のドロップダウンを表示できます。各 hierarchical 質問は最大 3 レベルをサポートします。
値	JSON です。
例	"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" } }]

qualification

説明	求人で必要になる可能性がある資格について応募者に尋ねる質問です。応募者の回答は、雇用主が指定する条件を満たす必要があります。Indeed は、応募者が適格条件を満たしているかどうかにかかわらず、すべての応募を雇用主に配信します。 応募者の 保護対象クラス に関する質問など、demographicQuestions はサポートしません。質問セクション をご覧ください。 サポートされる質問タイプは select、multiselect、text、date です。
値	オブジェクトです。 qualification パラメーター をご覧ください。
例	{ "type": "non-blocking", "match": { "type": "any", "values": ["1", "2"] } }

---

Qualification パラメーター

type

必須

説明	qualification のタイプを示します。non-blocking または knockout のいずれかです。 knockout と non-blocking のどちらを使用しても、回答が qualification を満たさない場合でも応募者は次のセクションに進めます。このパラメータは、要件を満たさない応募を絞り込むために使用します。
値	enum: "non-blocking" "knockout"
例	"non-blocking"

match

説明	この質問の評価方法が match であることを示します。質問タイプは select と multiselect です。
値	オブジェクトです。 match パラメータ をご覧ください。
例	{ "type": "any", "values": ["1", "2"] }

range

説明	この質問の評価方法が range であることを示します。ユーザーの回答は、min または max、あるいはその両方で定義する範囲内に収まる必要があります。この qualification パラメータでは、次のいずれかを設定する必要があります。 min max min と max の両方 この評価方法は、text:integer、text:decimal、date の質問タイプでのみサポートされます。
値	JSON です。
例	{ "min": 1, "max": 10 }

Match パラメーター

type

説明	応募者の回答が、指定した値の "any" または "all" の条件に一致する必要があるかどうかを示します。
値	enum: "any" "all" "all" は "multiselect" タイプの質問でのみ使用します。 デフォルトは "any" です。
例	"any"

values

必須

説明	応募者の回答が一致する必要がある値です。
値	配列です。
例	["1", "2"]

Range パラメーター

min

説明	受け付ける範囲の最小値です。
値	format=integer の場合は任意の整数です。 format=decimal の場合は任意の小数です。 type=date の場合は任意の日付です（指定した形式）。
例	4, '04/02/2023'

max

説明	受け付ける範囲の最大値です。
値	format=integer の場合は任意の整数です。 format=decimal の場合は任意の小数です。 type=date の場合は任意の日付です（指定した形式）。
例	8, '07/02/2023'

質問タイプ

textarea

複数行のテキスト入力フィールドを表示する質問です。長文の回答には、この質問タイプを使用します。

{
  "id": "envirotext",
  "type": "textarea",
  "question": "理想の職場環境を説明してください。"
}

text

単一行のテキストフィールドを表示する質問です。短い回答には、この質問タイプを使用します。

text 質問で使用できる形式については、次の例と JSON スクリーナー質問パラメータの表 をご覧ください。使用できる形式は integer、decimal、numeric_text です。

形式の指定なし

{
  "id": "city",
  "type": "text",
  "question": "現在お住まいの都市を入力してください。",
  "required": true
}

整数

整数を表示します。小数や先頭のゼロは受け付けません。

{
  "id": "age",
  "type": "text",
  "question": "年齢を入力してください。",
  "format": "integer",
  "min": "16",
  "max": "75"
}

数値テキスト

先頭のゼロを含む数字を受け付けます。小数は受け付けません。

{
  "id": "experience",
  "type": "text",
  "format": "numeric_text",
  "question": "この分野での経験年数を入力してください。",
  "required": false
}

小数

小数を表示します。先頭のゼロを受け付けます。

{
  "id": "gpa",
  "type": "text",
  "format": "decimal",
  "question": "GPA を入力してください。",
  "required": true
}

select

応募者が 1 つの回答を選択できるドロップダウンメニューを表示する質問です。多肢選択式の質問には、この質問タイプを使用します。

回答オプションが 1 個から 5 個の場合、Indeed はラジオボタンとして表示します。6 個以上の場合、Indeed はドロップダウンメニューとして表示します。

{
  "id": "gender",
  "type": "select",
  "question": "性別を選択してください。",
  "options": [{
    "value": "0",
    "label": "回答しない"
  }, {
    "value": "1",
    "label": "男性"
  }, {
    "value": "2",
    "label": "女性"
  }]
}

multiselect

応募者が複数の回答を選択できるチェックボックスのリストを表示する質問です。複数の回答がある質問には、この質問タイプを使用します。

{
  "id": "favoritecolors",
  "type": "multiselect",
  "question": "好きな色を 2 つ選択してください。",
  "options": [{
    "value": "0",
    "label": "黄"
  }, {
    "value": "1",
    "label": "青"
  }, {
    "value": "2",
    "label": "緑"
  }]
}

condition

前の質問への回答に応じて表示または非表示になる質問です。たとえば、応募者が 18 歳以上かどうかを尋ねます。応募者が no と回答した場合は、必要な就労書類を提示できるかどうかを尋ねます。

[{
  "id": "profile-atLeast18",
  "question": "18 歳以上ですか？",
  "required": true,
  "options": [{
    "value": "1",
    "label": "はい"
  }, {
    "value": "0",
    "label": "いいえ"
  }],
  "type": "select"
}, {
  "id": "profile-permit",
  "question": "就労許可証を提出できますか？",
  "required": true,
  "condition": {
    "id": "profile-atLeast18",
    "value": "0"
  },
  "options": [{
    "value": "1",
    "label": "はい"
  }, {
    "value": "0",
    "label": "いいえ"
  }],
  "type": "select"
}]

hierarchical

前の選択に基づいて後続の質問と回答を表示する質問です。たとえば、応募者に州を選択させ、その後にその州の都市のドロップダウンを表示できます。各 hierarchical 質問は、state/city/county のように最大 3 レベルをサポートします。

hierarchical 質問は条件付き質問に似ていますが、最初の選択が後続の質問の回答セットを決定するケースに適しています。関連情報の収集に必要な質問数を減らすには、このパターンを使用します。

demographicQuestions はこの質問タイプをサポートしません。

[{
  "id": "hierarchical",
  "type": "hierarchical",
  "question": "州を選択してください",
  "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 を指定します。dd/MM/yyyy、または Unicode CLDR 書式に従う他のロケール固有の形式を使用します。

Indeed は SimpleDateFormat を使用するため、月は MM として書式設定します。mm を使用すると設定ミスになります。

type=date の format は、Indeed が ATS に応募を送信する方法と、Indeed が最小値および最大値を解析する方法に影響します。求職者は指定した形式ではなく、自身のロケールに基づいて日付を入力し、Indeed は検証エラーを求職者のロケールで表示します。混乱を避けるため、yy ではなく yyyy を使用します。

{
  "id": "startdate",
  "required": true,
  "type": "date",
  "question": "開始日を入力してください。",
  "format": "dd/MM/yyyy",
  "min": "01/06/2023",
  "max": "03/10/2023"
}

file

ファイルアップロードコントロールを表示する質問です。資格証明書、ポートフォリオ、作業サンプルなど、回答としてファイルが必要な質問には、この質問タイプを使用します。応募データのリファレンス に記載されているとおり、JSON POST リクエストは 3 つの回答フィールドである contentType、data、fileName を返します。

有効なファイルタイプは次のとおりです。

• doc
• docx
• gif
• jfif
• jif
• jpe
• jpeg
• jpg
• pdf
• png
• rtf
• tif
• tiff
• txt

各ファイルの上限は 5 MB です。各応募の合計上限は、履歴書ファイルを含めて 15 MB です。

履歴書の収集にこの質問タイプを使用しないでください。代わりに、Indeed エントリーの Resume 設定パラメーターを使用します。

demographicQuestions はこの質問タイプをサポートしません。

{
  "id": "file2",
  "type": "file",
  "question": "最近の作業サンプルを添付してください。",
  "required": true,
  "min": "1",
  "max": "3"
}

information

回答を必要としないテキスト表示です。説明テキストやセクション見出しには、この質問タイプを使用します。

テキストには次の HTML 要素を含めることができます。

• <b>
• <p>
• <br>
• <li>
• <ul>
• <ol>
• <a href=" ">

URL で使用できるのは HTTP と HTTPS プロトコルのみです。リンクは新しいタブで開きます。

段落の後に改行を強制するために <br> を使用しないでください。Indeed は段落の間に自動で改行を挿入します。

information 質問タイプは condition JSON 質問パラメーターをサポートしません。JSON 質問パラメータ をご覧ください。

[{
  "id": "first_header",
  "type": "information",
  "text": "次の質問は<b>任意</b>であり、記録目的でのみ使用されます。 
  必ず<a href = 'http://www.eeoc.gov/employers/upload/poster_screen_reader_optimized.pdf'> EEO is the Law </a>ポスターを確認してください。",
  "fontsize": 8
}]

pagebreak

ページ上で質問をグループ化します。Indeed は 2 つの pagebreak タイプの間にあるすべての質問を同じページに表示します。同じページには最大 20 問をグループ化できます。デフォルトでは、Indeed はデスクトップでは 1 ページあたり 3 問を表示し、モバイルではすべての質問を 1 ページにまとめます。

[{
  "id": "page1_open",
  "type": "pagebreak"
}, {
  "id": "question_sample",
  "type": "text",
  "question": "年齢を入力してください。"
}, {
  "id": "page1_close",
  "type": "pagebreak"
}]

スクリーナー質問の回答の自動入力

日本のみ。

Indeed は、求職者の以前の応募から特定のスクリーナー質問の回答を自動的に事前入力する場合があります。

Indeed は、質問テキストまたは質問タイプが特定のルールに一致する場合にのみ、回答を事前入力します。

自動入力

項目カテゴリ	推奨される Question のサンプル
姓のフリガナ	Last name furigana, last name furigana
名のフリガナ	First name furigana, first name furigana
氏名の読み方	Furigana, furigana
生年月日（年）	Date of birth (year), Date of birth year
生年月日（月）	Date of birth (month), Date of birth month
生年月日（日）	Date of birth (day), Date of birth day
生年月日	Date of birth
性別	Gender
都道府県	Prefecture
最寄り駅	Nearest train station
職業	Occupation, current occupation
郵便番号	Postal code
市区町村	Municipality, city or ward / town or village
町名・番地	Town name and address number, Town name / address number
建物名・部屋番号	Building name, building name / room number, address
配偶者の有無	Married, unmarried

質問のスキーマ

このスキーマは、ATS がホストし、Indeed がクエリするエンドポイントを表します。これは、Indeed エントリーが管理する求人応募で、雇用主が求職者に提示したい質問を表します。

質問の例（JSON）

{
  "schemaVersion": "1.0",
  "screenerQuestions": {
    "questions": [{
      "id": "favorite-widget-color",
      "type": "text",
      "question": "What is your favorite widget color?"
    }, {
      "id": "last-four-social-security",
      "type": "text",
      "question": "What are the last four digits of your social security number??",
      "format": "numeric_text"
    }, {
      "id": "org-annual-widget-volume",
      "type": "text",
      "question": "How many widgets can you craft in an hour?",
      "required": true,
      "format": "integer",
      "min": 0,
      "max": 100
    }, {
      "id": "widget-passion",
      "type": "textarea",
      "question": "What makes you passionate about widget crafting?"
    }, {
      "id": "widget-crafting-license",
      "type": "select",
      "question": "Do you have a widget crafting license issued by the Widget Organization for Widgets?",
      "required": true,
      "options": [{
        "label": "false",
        "value": "0"
      }, {
        "label": "true",
        "value": "1"
      }]
    }, {
      "id": "widget-crafting-license-certifications",
      "type": "multiselect",
      "question": "Please select all certifications on your widget crafting license.",
      "required": true,
      "options": [{
        "label": "Wooden Widget Certification",
        "value": "0"
      }, {
        "label": "Plastic Widget Certification",
        "value": "1"
      }, {
        "label": "Quantum Foam Widget Certification",
        "value": "3"
      }],
      "condition": {
        "id": "widget-crafting-license",
        "value": "1"
      },
      "qualification": {
        "type": "non-blocking",
        "match": {
          "type": "any",
          "values": ["1", "3"]
        }
      }
    }, {
      "id": "widget-crafting-state",
      "type": "hierarchical",
      "question": "What is the most recent US state, city, and zip code in which you've crafted widgets?",
      "options": [{
        "label": "California",
        "value": "0"
      }, {
        "label": "Texas",
        "value": "1"
      }],
      "hierarchicalOptions": [{
        "id": "cali-cities",
        "options": [{
          "label": "SanFrancisco",
          "value": "0"
        }],
        "condition": {
          "id": "widget-crafting-state",
          "value": "0"
        }
      }, {
        "id": "texas-cities",
        "options": [{
          "label": "San Antonio",
          "value": "0"
        }, {
          "label": "Austin",
          "value": "1"
        }],
        "condition": {
          "id": "widget-crafting-state",
          "value": "1"
        }
      }, {
        "id": "san-antonio-zips",
        "options": [{
          "label": "78212",
          "value": "0"
        }, {
          "label": "78209",
          "value": "1"
        }],
        "condition": {
          "id": "texas-cities",
          "value": "0"
        }
      }]
    }, {
      "id": "widget-crafting-license-expiration",
      "type": "date",
      "question": "When does your widget crafting license expire?",
      "required": true,
      "format": "dd/MM/yyyy",
      "condition": {
        "id": "widget-crafting-license",
        "value": "1"
      }
    }, {
      "id": "favorite-widget-pic",
      "type": "file",
      "question": "Please upload a picture of your most handsomely crafted widget."
    }, {
      "id": "page-1",
      "type": "pagebreak"
    }, {
      "id": "strange-widget-disclosure",
      "type": "information",
      "text": "The widgets we produce are sometimes flavored strange. By applying to this job you agree that you are comfortable crafting strange flavored widgets."
    }]
  },
  "demographicQuestions": {
    "questions": [{
      "id": "disabilities",
      "type": "select",
      "question": "Do you have a disability?",
      "options": [{
        "label": "false",
        "value": "0"
      }, {
        "label": "true",
        "value": "1"
      }],
      "required": false
    }]
  }
}

質問スキーマの例（OpenAPI YAML）

openapi: "3.0.3"
info:
  title: "Indeed Questions Schema"
  description: "This defines Indeed's Application Questions schema. As a client of\
    \ Indeed who wishes to utilize Indeed Apply to administer job application questions\
    \ to job seekers, you must host these this API on a server of your choice.  The\
    \ schema defines job application questions you or your customer would like to\
    \ pose to job seekers through the Indeed Apply product."
  version: "1.0"
servers:
- url: "https://YourQuestionsEndpoint.com"
tags:
- name: "Job Application Question Fetching"
  description: "Question lists that Indeed will fetch from your configured **indeed-apply-questions**\
    \ URL when rendering your job application for a job seeker\n\nCHANGE LOG for this\
    \ version:\n* ***BREAKING!*** Root changed to object instead of array\n* Added\
    \ root fields ```schmeaVersion```, ```screenerQuestions```, ```demographicQuestions```\n\
    * Added ```qualification``` field/concept to numeric\
    \ literal, date, select and multiselect question types\n*"
paths:
  /questions:
    get:
      tags:
      - "job application question fetching"
      summary: "Fetch job application questions"
      description: "Returns all the questions Indeed needs to faithfully render your\
        \ job application for a job seeker"
      responses:
        "200":
          description: "successful operation"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/QuestionsBody"
              example:
                schemaVersion: "1.0"
                screenerQuestions:
                  questions:
                  - id: "favorite-widget-color"
                    type: "text"
                    question: "What is your favorite widget color?"
                  - id: "org-annual-widget-volume"
                    type: "text"
                    question: "What are the last four digits of your social security\
                      \ number??"
                    format: "numeric_text"
                  - id: "last-four-social-security"
                    type: "text"
                    question: "How many widgets can you craft in an hour?"
                    required: true
                    format: "integer"
                    min: 0
                    max: 100
                  - id: "widget-passion"
                    type: "textarea"
                    question: "What makes you passionate about widget crafting?"
                  - id: "widget-crafting-license"
                    type: "select"
                    question: "Do you have a widget crafting license issued by the\
                      \ Widget Organization for Widgets?"
                    required: true
                    options:
                    - label: "false"
                      value: "0"
                    - label: "true"
                      value: "1"
                  - id: "widget-crafting-license-certifications"
                    type: "multiselect"
                    question: "Please select all certifications on your widget crafting\
                      \ license."
                    required: true
                    options:
                    - label: "Wooden Widget Certification"
                      value: "0"
                    - label: "Plastic Widget Certification"
                      value: "1"
                    - label: "Quantum Foam Widget Certification"
                      value: "3"
                    condition:
                      id: "widget-crafting-license"
                      value: "1"
                    qualification:
                      type: "non-blocking"
                      match:
                        type: "any"
                        values:
                        - "1"
                        - "2"
                  - id: "widget-crafting-state"
                    type: "hierarchical"
                    question: "What is the most recent US state, city, and zip code\
                      \ in which you've crafted widgets?"
                    options:
                    - label: "California"
                      value: "0"
                    - label: "Texas"
                      value: "1"
                    hierarchicalOptions:
                    - id: "cali-cities"
                      options:
                      - label: "SanFrancisco"
                        value: "0"
                      condition:
                        id: "widget-crafting-state"
                        value: "0"
                    - id: "texas-cities"
                      options:
                      - label: "San Antonio"
                        value: "0"
                      - label: "Austin"
                        value: "1"
                      condition:
                        id: "widget-crafting-state"
                        value: "1"
                    - id: "san-antonio-zips"
                      options:
                      - label: "78212"
                        value: "0"
                      - label: "78209"
                        value: "1"
                      condition:
                        id: "texas-cities"
                        value: "0"
                  - id: "widget-crafting-license-expiration"
                    type: "date"
                    question: "When does your widget crafting license expire?"
                    required: true
                    format: "dd/MM/yyyy"
                    condition:
                      id: "widget-crafting-license"
                      value: "1"
                  - id: "favorite-widget-pic"
                    type: "file"
                    question: "Please upload a picture of your most handsomely crafted\
                      \ widget."
                  - id: "page-1"
                    type: "pagebreak"
                  - id: "strange-widget-disclosure"
                    type: "information"
                    text: "The widgets we produce are sometimes flavored strange.\
                      \ By applying to this job you agree that you are comfortable\
                      \ crafting strange flavored widgets."
                demographicQuestions:
                  questions:
                  - id: "disabilities"
                    type: "select"
                    question: "Do you have a disability?"
                    options:
                    - label: "false"
                      value: "0"
                    - label: "true"
                      value: "1"
                    required: false
        "404":
          description: "Questions not found"
components:
  schemas:
    QuestionsBody:
      title: "Questions Body"
      type: "object"
      required:
      - "schemaVersion"
      properties:
        schemaVersion:
          type: "string"
          description: "This is the [semantic version](https://semver.org) of the\
            \ schema. (Or rather, the semantic-version-light. We do not use the 3rd\
            \ (PATCH) element.)"
        screenerQuestions:
          type: "object"
          properties:
            questions:
              allOf:
              - $ref: "#/components/schemas/QuestionsList"
              - description: "The screener questions should be a list of general,\
                  \ well formatted questions pertaining to the underlying job such\
                  \ as work experience, skills, certifications, and so on  It should ***NOT***\
                  \ contain demographic questions such as question about ethnicity,\
                  \ gender, or disability.  Questions related to \"protected classes\"\
                  \ of people are regulated in certain jurisdictions meaning they\
                  \ must be handled in special ways inside Indeed systems (and potentially\
                  \ yours). This schema provides a separate list for demographic questions\
                  \ called \"demographicQuestions\" below."
        demographicQuestions:
          type: "object"
          properties:
            questions:
              allOf:
              - $ref: "#/components/schemas/QuestionsList"
              - description: "The demographics questions should be a list of specific,\
                  \ well formatted questions pertaining to the job applicant's \"\
                  protected class\" (such as ethnicity, gender, disability, and so on).  These\
                  \ sorts of questions are regulated in certain jurisdictions meaning\
                  \ they must be handled in special ways in Indeed systems (and potentially\
                  \ yours).  Please do not mix general screener questions such as\
                  \ those pertaining to work experience, skills, or certifications\
                  \ into this list. Instead place them in the \"screenerQuestions\"\
                  \ list above."
    QuestionsList:
      title: "Questions List"
      type: "array"
      items:
        $ref: "#/components/schemas/Question"
      example:
        questionPlatform:
          questionSetId: "abc123"
    Question:
      type: "object"
      anyOf:
      - $ref: "#/components/schemas/TextQuestion"
      - $ref: "#/components/schemas/TextAreaQuestion"
      - $ref: "#/components/schemas/SelectQuestion"
      - $ref: "#/components/schemas/HierarchicalQuestion"
      - $ref: "#/components/schemas/DateQuestion"
      - $ref: "#/components/schemas/FileQuestion"
      - $ref: "#/components/schemas/InformationText"
      - $ref: "#/components/schemas/PagebreakFormating"
      discriminator:
        propertyName: "type"
        mapping:
          text: "#/components/schemas/TextQuestion"
          textarea: "#/components/schemas/TextAreaQuestion"
          select: "#/components/schemas/SelectQuestion"
          multiselect: "#/components/schemas/SelectQuestion"
          hierarchical: "#/components/schemas/HierarchicalQuestion"
          date: "#/components/schemas/DateQuestion"
          file: "#/components/schemas/FileQuestion"
          information: "#/components/schemas/InformationText"
          pagebreak: "#/components/schemas/PagebreakFormating"
    TextQuestion:
      title: "Text Question"
      type: "object"
      description: "Displays a single-line text entry field and is used for questions\
        \ with shorter answers."
      anyOf:
      - $ref: "#/components/schemas/PureTextQuestionAddIn"
      - $ref: "#/components/schemas/NumericTextQuestionAddIn"
      - $ref: "#/components/schemas/NumericLiteralTextQuestionAddIn"
      example:
        id: "text-question-id"
        type: "text"
        question: "What short piece of info are you willing to provide?"
        required: true
    PureTextQuestionAddIn:
      title: "Pure Text Question Add-In"
      type: "object"
      example:
        id: "text-format-default-id"
        type: "text"
        question: "Can you provide some normal text?"
        required: true
    NumericTextQuestionAddIn:
      title: "Numeric Text Question Add-In"
      type: "object"
      description: "Allows for numbers with leading zeroes; does not allow for decimals."
      required:
      - "format"
      properties:
        format:
          type: "string"
          enum:
          - "numeric_text"
      example:
        id: "text-format-numeric-id"
        type: "text"
        question: "Can you provide some numeric text with leading zeros such as 01234?"
        required: false
        format: "numeric_text"
    NumericLiteralTextQuestionAddIn:
      title: "Numeric Literal Text Question Add In"
      anyOf:
      - $ref: "#/components/schemas/DecimalTextQuestionAddIn"
      - $ref: "#/components/schemas/IntegerTextQuestionAddIn"
    DecimalTextQuestionAddIn:
      title: "Decimal Text Question Add-In"
      type: "object"
      description: "Numbers with decimals; allows for leading zeroes."
      required:
      - "format"
      properties:
        format:
          type: "string"
          enum:
          - "decimal"
        min:
          type: "number"
          description: "The minimum value for the answer"
        max:
          type: "number"
          description: "The maximum value for the answer"
        qualification:
          $ref: "#/components/schemas/QualificationDecimal"
      example:
        id: "text-format-integer"
        type: "text"
        question: "Can you provide a decimal between 0.665 and 100.1 inclusive?"
        required: true
        format: "decimal"
        min: 0.665
        max: 100.1
    QualificationDecimal:
      title: "Qualification Decimal"
      allOf:
      - $ref: "#/components/schemas/QualificationBase"
      - type: "object"
        properties:
          range:
            type: "object"
            description: "Indicates the evaluation method for this question is range,\
              \ meaning that the user’s answers must fall within the range defined\
              \ by the provided ```min``` and/or ```max``` values"
            anyOf:
            - required:
              - "min"
              properties:
                min:
                  type: "number"
                max:
                  type: "number"
              example:
                min: 4.5
            - required:
              - "max"
              properties:
                min:
                  type: "number"
                max:
                  type: "number"
              example:
                min: 4.5
                max: 60.33
    QualificationBase:
      title: "Qualification Base"
      type: "object"
      description: "Indicates this question contains the need to\
        \ assess if the given answer is correct.\n\nSupported for conditional schema.\
        \ Not supported for hierarchical. \n\nQualification questions are marked as\
        \ required for applicants to answer\n"
      required:
      - "type"
      properties:
        type:
          type: "string"
          enum:
          - "non-blocking"
          description: "Indicates the type of qualification in regards to the effect\
            \ on the user’s application in the indeed apply flow.\n  * ```non-blocking```\
            \ will allow the user to move to the next section\
            \ in the apply flow even if the answer does not meet the specification\
            \ defined in the qualification.\n"
    IntegerTextQuestionAddIn:
      title: "Integer Text Question Add-In"
      type: "object"
      description: "Whole numbers; does not allow for decimals or leading zeroes."
      properties:
        format:
          type: "string"
          enum:
          - "integer"
        min:
          type: "integer"
          description: "The minimum value for the answer"
        max:
          type: "integer"
          description: "The maximum value for the answer"
        qualification:
          $ref: "#/components/schemas/QualificationInteger"
      example:
        id: "text-format-integer"
        type: "text"
        question: "Can you provide an integer between 0 and 100 inclusive?"
        required: true
        format: "integer"
        min: 0
        max: 100
    QualificationInteger:
      title: "Qualification Integer"
      type: "object"
      description: "Indicates the evaluation method for this question is range, meaning\
        \ that the user’s answers must fall within the range defined by the provided\
        \ ```min``` and/or ```max``` values"
      allOf:
      - $ref: "#/components/schemas/QualificationBase"
      - type: "object"
        properties:
          range:
            type: "object"
            anyOf:
            - required:
              - "min"
              properties:
                min:
                  type: "integer"
                max:
                  type: "integer"
              example:
                min: 4
                max: 60
            - required:
              - "max"
              properties:
                min:
                  type: "integer"
                max:
                  type: "integer"
              example:
                max: 60
    TextAreaQuestion:
      title: "Text Area Question"
      type: "object"
      description: "Displays a multi-line text entry field and is used for questions\
        \ with long-form answers."
      allOf:
      - $ref: "#/components/schemas/TextualQuestionBase"
      - type: "object"
        required:
        - "type"
        properties:
          type:
            type: "string"
            enum:
            - "textarea"
      example:
        id: "textarea-question-id"
        type: "text"
        question: "What deep concepts are you thinking about?"
        required: true
    TextualQuestionBase:
      title: "Textual Question Base"
      type: "object"
      allOf:
      - $ref: "#/components/schemas/QuestionBase"
      - type: "object"
        properties:
          limit:
            type: "integer"
            description: "The character limit for the answer"
    QuestionBase:
      title: "Question Base"
      type: "object"
      allOf:
      - $ref: "#/components/schemas/QuestionItemBase"
      - type: "object"
        required:
        - "question"
        properties:
          question:
            type: "string"
            description: "The question text that the applicants see."
          required:
            type: "boolean"
            description: "If set to true, the question is required, which produces\
              \ a non-empty text field or selection. Omit this parameter to define\
              \ questions as optional. If a question is optional and the candidate\
              \ chooses not to answer, Indeed sends an answer value of \"\"."
          condition:
            type: "object"
            description: "Marks a question as conditional, depending on the answer\
              \ to a previous select question. Specify the id of the previous question\
              \ as well as the option value that activates this question. For example,\
              \ you might ask the applicant if the have a pertinent license. If they\
              \ answer yes, you display a conditional question that asks when it expires."
            properties:
              id:
                type: "string"
                description: "The unique question id on which the display of this\
                  \ question depends."
              value:
                type: "string"
                description: "The value that the dependent questions answer must match\
                  \ before this condition question is displayed."
    QuestionItemBase:
      title: "Question Item Base"
      type: "object"
      required:
      - "id"
      properties:
        id:
          type: "string"
          description: "Unique ID for this question."
    SelectQuestion:
      title: "Select Question"
      type: "object"
      description: "Types:\n- ***select*** - A question that displays a dropdown menu\
        \ that allows the applicant to select a single answer. Used for questions\
        \ with multiple choice answers.\n  - Note: If you include from 1 to 5 answer\
        \ options, they appear with radio buttons. If you include from 6 or more answer\
        \ options, they appear in a dropdown menu.\n- ***multiselect*** - A question\
        \ that displays a list of checkboxes that enables the applicant to select\
        \ multiple answers. Used for questions with multiple answers.\n"
      allOf:
      - $ref: "#/components/schemas/QuestionBase"
      - type: "object"
        required:
        - "type"
        - "options"
        properties:
          type:
            type: "string"
            enum:
            - "select"
            - "multiselect"
          options:
            $ref: "#/components/schemas/SelectOptions"
          qualification:
            anyOf:
            - $ref: "#/components/schemas/QualificationSelect"
            - $ref: "#/components/schemas/QualificationMultiselect"
            discriminator:
              propertyName: "type"
              mapping:
                select: "#/components/schemas/QualificationSelect"
                multiselect: "#/components/schemas/QualificationMultiselect"
      example:
        id: "select-question-id"
        type: "select"
        question: "Please select an option below."
        required: true
        options:
        - label: "no"
          value: "0"
        - label: "yes"
          value: "1"
    SelectOptions:
      title: "Select Options"
      type: "array"
      items:
        type: "object"
        required:
        - "label"
        - "value"
        properties:
          label:
            type: "string"
          value:
            type: "string"
    QualificationSelect:
      title: "Qualification Select"
      allOf:
      - $ref: "#/components/schemas/QualificationBase"
      - type: "object"
        properties:
          match:
            type: "object"
            description: "Indicates the evaluation method for this question is match,\
              \ meaning that the user’s answers must match ```any``` of the provided\
              \ values"
            required:
            - "values"
            properties:
              values:
                type: "array"
                items:
                  type: "string"
              type:
                type: "string"
                enum:
                - "any"
                default: "any"
    QualificationMultiselect:
      title: "Qualification Multiselect"
      allOf:
      - $ref: "#/components/schemas/QualificationBase"
      - type: "object"
        properties:
          match:
            type: "object"
            description: "Indicates the evaluation method for this question is match,\
              \ meaning that the user’s answers must match ```any``` or ```all```\
              \ of the provided values"
            required:
            - "values"
            properties:
              values:
                type: "array"
                items:
                  type: "string"
              type:
                type: "string"
                enum:
                - "all"
                - "any"
                default: "any"
    HierarchicalQuestion:
      title: "Hierarchical Question"
      type: "object"
      description: "A question that displays additional questions and responses based\
        \ on previously selected answers. For example, you might ask an applicant\
        \ to choose a state. Then, depending on what they select, you could offer\
        \ them a dropdown list of cities within that state.  Additionally could ask\
        \ for a zip code within the city they select. Each hierarchical question is\
        \ limited to three levels. For example state -> city -> zip.\nNote: Hierarchical\
        \ questions are similar to conditional questions. However, hierarchical questions\
        \ may be better suited to certain question types where an initial selection\
        \ defines potential answers for subsequent questions. Using the hierarchical\
        \ functionality reduces the total number of questions needed to obtain related\
        \ information.\n"
      allOf:
      - $ref: "#/components/schemas/QuestionBase"
      - type: "object"
        required:
        - "type"
        - "options"
        properties:
          type:
            type: "string"
            enum:
            - "hierarchical"
          options:
            $ref: "#/components/schemas/SelectOptions"
          hierarchicalOptions:
            type: "array"
            items:
              required:
              - "id"
              properties:
                id:
                  type: "string"
                  description: "The identifier of the hierarchical option"
                options:
                  $ref: "#/components/schemas/SelectOptions"
                condition:
                  type: "object"
                  required:
                  - "id"
                  - "value"
                  properties:
                    id:
                      type: "string"
                    value:
                      type: "string"
      example:
        id: "hierarchical-question-top-id"
        type: "hierarchical"
        question: "Can you navigate this nested hierarchy?"
        options:
        - label: "Top-level A"
          value: "0"
        - label: "Top-level B"
          value: "1"
        - label: "Top-level C"
          value: "2"
        hierarchicalOptions:
        - id: "top-level-a-mids-id"
          options:
          - label: "Top-level A -> Mid-level 1"
            value: "0"
          - label: "Top-level A -> Mid-level 2"
            value: "1"
          condition:
            id: "hierarchical-question-top-id"
            value: "0"
        - id: "top-level-b-mids-id"
          options:
          - label: "Top-level B -> Mid-level 1"
            value: "0"
          - label: "Top-level B -> Mid-level 2"
            value: "1"
          condition:
            id: "hierarchical-question-top-id"
            value: "1"
        - id: "top-level-b-mid-1-lows-id"
          options:
          - label: "78212"
            value: "0"
          - label: "78209"
            value: "1"
          condition:
            id: "top-level-b-mids-id"
            value: "0"
    DateQuestion:
      title: "Date Question"
      type: "object"
      description: "A question that displays a text field that only accepts date entry.\
        \ Used for questions that must be answered with a date.\nNote: Format is required\
        \ when using this screener question type. The format must be dd/MM/yyyy or\
        \ another locale specific format that meets Unicode CLDR formatting.\n  Indeed\
        \ uses the SimpleDateFormat, so month must be formatted as MM. Using mm results\
        \ in misconfiguration.\n  The format of type=date impacts how the application\
        \ is passed to the ATS and the parsing of minimum and maximum values. The\
        \ job seeker still enters the date based on their locale, not the specified\
        \ format, and validation error messages are in their locale’s format. Use\
        \ yyyy instead of yy in the format to prevent confusion.\n"
      allOf:
      - $ref: "#/components/schemas/QuestionBase"
      - type: "object"
        required:
        - "type"
        - "format"
        properties:
          type:
            type: "string"
            enum:
            - "date"
          format:
            type: "string"
            enum:
            - "dd/MM/yyyy"
            - "integer"
          min:
            type: "string"
          max:
            type: "string"
          qualification:
            $ref: "#/components/schemas/QualificationDate"
      example:
        id: "date-question-id"
        type: "date"
        question: "Do you have a favorite date?"
        required: true
        format: "dd/MM/yyyy"
        condition:
          id: "select-question-id"
          value: "1"
    QualificationDate:
      title: "Qualification Date"
      type: "object"
      description: "Indicates the evaluation method for this question is range, meaning\
        \ that the user’s answers must fall within the range defined by the provided\
        \ ```min``` and/or ```max``` values"
      allOf:
      - $ref: "#/components/schemas/QualificationBase"
      - type: "object"
        properties:
          range:
            type: "object"
            anyOf:
            - required:
              - "min"
              properties:
                min:
                  anyOf:
                  - type: "string"
                  - type: "integer"
                max:
                  anyOf:
                  - type: "string"
                  - type: "integer"
              example:
                min: 1693586842725
            - required:
              - "max"
              properties:
                min:
                  anyOf:
                  - type: "string"
                  - type: "integer"
                max:
                  anyOf:
                  - type: "string"
                  - type: "integer"
              example:
                min: "01/01/2020"
                max: "12/31/2020"
    FileQuestion:
      title: "File Question"
      type: "object"
      description: "A question that displays a file upload interface. Used for questions\
        \ that require a file upload as an answer, such as certifications, portfolios,\
        \ or example work. As detailed in Application data reference, the answer data\
        \ returned in the JSON POST request contains three fields: contentType, data,\
        \ and fileName.\n\nValid file types are:\n  * doc\n  * docx\n  * gif\n  *\
        \ jfif\n  * jif\n  * jpe\n  * jpeg\n  * jpg\n  * pdf\n  * png\n  * rtf\n \
        \ * tif\n  * tiff\n  * txt\n\n  File size limit is 5 MB. The maximum combined\
        \ limit per application is 15MB, including resume file.\n"
      allOf:
      - $ref: "#/components/schemas/QuestionBase"
      - type: "object"
        required:
        - "type"
        properties:
          type:
            type: "string"
            enum:
            - "file"
          min:
            type: "string"
          max:
            type: "string"
      example:
        id: "file-question-id"
        type: "file"
        question: "Please upload a file."
        required: false
    InformationText:
      title: "Information Text"
      type: "object"
      description: "A text display that does not require a response. Creates explanatory\
        \ text or provide section headings.\n\nYou can include the following HTML\
        \ elements in the text:\n\n* <b>\n* <p>\n* <br>\n* <li>\n\
        * <ul>\n* <ol>\n* <a href=" ">\n\nOnly HTTP and\
        \ HTTPS protocols are allowed in URLs. Links open in a new tab.\n\nNote: Do\
        \ not use <br> to force line breaks after paragraphs. Indeed automatically\
        \ inserts line breaks between paragraphs.\n"
      allOf:
      - $ref: "#/components/schemas/QuestionItemBase"
      - type: "object"
        required:
        - "type"
        - "text"
        properties:
          type:
            type: "string"
            enum:
            - "information"
          text:
            type: "string"
      example:
        id: "information-text-id"
        type: "information"
        text: "Here is some information for you to consume: Roses are red"
    PagebreakFormating:
      title: "Pagebreak Formating"
      description: "Groups questions on a page. All questions included between two\
        \ pagebreak types appear on the same page. You can group up to 20 questions\
        \ on the same page. Indeed defaults to 3 questions per page on desktop and\
        \ groups all questions onto a single page for mobile."
      allOf:
      - $ref: "#/components/schemas/QuestionItemBase"
      - type: "object"
        required:
        - "type"
        properties:
          type:
            type: "string"
            enum:
            - "pagebrake"
      example:
        id: "page-1"
        type: "pagebrake"

ベストプラクティス

応募を論理的なセクションに分割するには、pagebreak 質問タイプを使用してください。JSON にページ区切りが含まれていない場合、Indeed は自動的に挿入するため、意図しない形で応募が分割される場合があります。Indeed は、モバイルとデスクトップの両方で 1 ページあたり最大 10 件の質問を表示します。

回答に特定の形式が必要な場合は、求職者向けのガイダンスを提供してください。Indeed は SimpleDateFormat を使用するため、月は MM 形式にしてください。mm を使用すると設定不備の原因になります。

 

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