審査用の質問のJSONリファレンス

JSON 形式の審査用の質問のパラメータ。

 

法的注意

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

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

Indeed エントリーの応募フローに審査用の質問を表示するには、次のいずれかの方法を使用します。

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

• 求人情報連携APIを呼び出して、審査用の質問付きで求人を作成します。

審査用の質問の JSON ファイルは、最大 1 MB です。

審査用の質問の JSON ファイルの構文を検証するには、Indeed Apply Questions tool （新しいウィンドウで開きます） を使用してください。

審査用の質問に電話番号やメールアドレスを含めないでください。デフォルトでは、応募データ にメールアドレスが含まれます。電話番号を取得するには、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"] } }

validationRuleKey

詳細	質問に設定すると、ルールに違反する求職者の回答を拒否する入力規則の識別子です。 validationRuleKeyはすべてのtextareaの質問に対応しています。 validationRuleKeyは、“format:integer”および“format:decimal”を含まないtextの質問に対応しています。つまり、textの質問にformatやnumeric_textが含まれていなければ、validationRuleKeyが利用可能です。
値	name address phone email compensation alphanumeric_period_dash alphanumeric_bracket_underscore_slash alphanumeric_slash url anti_xss tax_exemption 検証ルールをご覧ください。 今後、さらに多くの検証ルールが利用可能になる場合があります。
例	{ "id": "address", "type": "text", "question": "What is your address?", "validationRuleKey": "address", "minCharCount": 3, "limit": 50 }

---

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'

検証ルール

以下の検証ルールを質問に設定すると、禁止文字を含む求職者の回答は無効となります。

name

説明：使用できる文字	名前フィールド：英数字、スペース、& . ' - " ( ) / º |の記号
validationRuleKey	name
Regex	^[a-zA-Z0-9\s&.'"()/º|-]+$
例	John Doe

address

説明：使用できる文字	住所フィールド：英数字、スペース、, . ' - " ( ) / \ | : # + ! & ; ½ ºの記号
validationRuleKey	address
Regex	^[a-zA-Z0-9\s,.'"()/\\|:#+!&;½º-]+$
例	10721 Domain Dr, Austin, TX 78758

phone

説明：使用できる文字	電話番号フィールド：英数字、スペース、 , . - ( ) : # + / * \の記号
validationRuleKey	phone
Regex	^[a-zA-Z0-9\s,.()/:#+*\\-]+$
例	555-555-4321

email

説明：使用できる文字	メールフィールド：英数字、スペース、 . @ " ( ) , : ; < > [ \ ] ! # $ % & ' * + - / = ? ^ _ ` { | } ~の記号
validationRuleKey	email
Regex	^[a-zA-Z0-9\s.@"(),:;<>\[\]!#$%&'*+/=?^_`{|}~\\-]+$
例	john.doe@indeed.com

compensation

説明：使用できる文字	給与フィールド：英数字、スペース、 , . ( ) + % $の記号
validationRuleKey	compensation
Regex	^[a-zA-Z0-9\s,.()+%$]+$
例	$10,000

alphanumeric_period_dash

説明：使用できる文字	英数字（ピリオド・ダッシュを含む）：英数字、スペース、. + -の記号
validationRuleKey	alphanumeric_period_dash
Regex	^[a-zA-Z0-9\s.+-]+$
例	111-1111

alphanumeric_bracket_underscore_slash

説明：使用できる文字	英数字（括弧、アンダースコア、スラッシュを含む）：英数字、スペース、{ } [ ] ( ) _ / + -の記号
validationRuleKey	alphanumeric_bracket_underscore_slash
Regex	^[a-zA-Z0-9\s{}\[\]()_/+-]+$
例	[111-1111]

alphanumeric_slash

説明：使用できる文字	英数字（スラッシュを含む）：英数字、スペース、/ + -の記号
validationRuleKey	alphanumeric_slash
Regex	^[a-zA-Z0-9\s/+-]+$
例	/111-1111

url

説明：使用できる文字	URLフィールド： 英数字、スペース、 - _ . ~ ! * ' ( ) ; : @ & = + $ , / ? % # [ ]の記号
validationRuleKey	url
Regex	^[a-zA-Z0-9\s_.~!*'();:@&=+$,/?%#\[\]-]+$
例	http://www.indeed.com

anti_xss

説明：使用できる文字	潜在的なインジェクション文字である ' " \ / ` と山括弧をブロックします。 < >
validationRuleKey	anti_xss
Regex	^[^<>'"\\/`]*$
例	http://www.example.com

tax_exemption

説明：使用できる文字	免税フィールド：英数字、スペース、 , . ( ) + % $ _の記号
validationRuleKey	tax_exemption
Regex	^[a-zA-Z0-9\s,.()+%$_]+$
例	$10,000

質問タイプ

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

日付のみを入力できるテキストフィールドを含む質問。応募者が日付を回答する必要がある場合に使用します。

この種類の質問では、dd/MM/yyyyまたはUnicode CLDRに準拠したロケール固有の形式を使用してください。

Indeed は大文字・小文字を区別するJavaのSimpleDateFormatエンジンで日付パターンを解析します。不正な形式のパターンは許容されますが、誤ったトークンはデータ破損や求職者・採用企業の意図の不一致を引き起こします。

type=dateの形式は、Indeed が応募情報をATSに送信する方法や、最小値・最大値の解析方法に影響します。求職者は指定した形式ではなく、自身のロケールで日付を入力します。入力に誤りがある場合、Indeed は求職者のロケールに合わせた検証エラーを表示します。

データ損失を防ぐため、type=dateの設定には以下の標準トークンのみを使用してください：yyyy（暦年）、MMまたはM（数字の月）、ddまたはd（月の日）。Indeed は非標準または不正なトークンのサポートを廃止する予定です。

以下のトークンは設定ミスの原因となりやすいため、type=date形式のフォーマット文字列では使用しないでください。

無効な日付トークンです

トークン：	詳細	設定ミス	代わりにこちらを使用してください
mm	その時間の何分か（0〜59）	月ではなく、0〜59の分の値を生成します。これで求人を設定すると、誤った月の値を通知なく出力します。例えば、このトークンは処理時のシステムの時間が3分の場合にのみ「03」と表示されます。	MM
YYYY / YY	ISO週基準年	12月と1月の境目付近で暦年とずれが生じます。例えば、2025年12月29日はISO週年に基づいて計算されるため、2026年と表示されることがあります。この問題は年末の境界を越えるまで、通常のテストでは検出が難しいです。	yyyy
yy	2桁の西暦年	世紀が曖昧になります。たとえば、2桁の年「24」はシステムの解析基準により、1924年または2024年と解釈されることがあります。	yyyy
DD / D	その年の何日目かを表す（1〜366日）	月の日付（1〜31）ではなく、年間通算した何日目か（1〜366）を返します。例えば、2025年3月15日は誤って74日目と評価されます。	dd

{
  "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"
}]

multifield

カスタマイズ可能な「さらに追加」ボタンを表示する質問です。求職者はこのボタンで、職歴や学歴など複数のエントリーを追加できます。各エントリーは、multifield質問のgroupedQuestionFields配列で定義されたフィールド群を収集します。この必須配列には、以下のタイプの関連質問が1〜20件含まれます。

• text
• textarea
• select
• multiselect
• date
• file
• hierarchical
• condition

注意：multifieldの入れ子は禁止されています。groupedQuestionFields内の質問はmultifieldにできません。

デフォルトでは、明示的に設定されていない場合、minEntryCountは1、maxEntryCountは15です。

設定は以下のルールに従う必要があります。

• 定義：1カウントは、groupedQuestionFields内の質問に対する回答1件を指します。
• 制限：minEntryCountは負の値にできません。maxEntryCountは1〜20の範囲で指定してください。
• 検証：maxEntryCountは常にminEntryCount以上の値でなければなりません。

たとえば、このmultifieldは求職者に学歴の情報を入力してもらいます。

{
  "id": "education",
  "type": "multifield",
  "question": "Please enter your education history (up to 10)",
  "minEntryCount": 1,
  "maxEntryCount": 10,
  "groupLabel": "Education",
  "addButtonLabel": "Add Another Education Entry",
  "groupedQuestionFields": [
    {
      "id": "school_name",
      "question": "School Name",
      "type": "text",
      "required": true,
      "limit": 100
    },
    {
      "id": "degree",
      "question": "Degree Title",
      "type": "text",
      "required": true,
      "limit": 100
    },
  ]
}

求職者の最初の回答には「Texas A&M」や「Bachelor’s Degree」が含まれ、2番目の回答には「The University of Texas at Austin」や「Master’s Degree」が含まれる場合があります。"minEntryCount": 1により、求職者は1つの回答を提供しなければなりません。"maxEntryCount": 10により、回答は10件を超えられません。

求職者にgroupedQuestionFields配列の少なくとも1つのエントリーで1つ以上の質問に回答させるには、multifieldの質問のminEntryCountを0より大きい値に設定します。groupedQuestionFields配列内の特定の質問への回答を必須にするには、その質問のrequiredをtrueに設定してください。

「さらに追加」ボタンのテキストをカスタマイズするには、addButtonLabelを設定してください。groupedQuestionFields配列内の質問グループを識別するテキストをカスタマイズするには、groupLabelを設定してください。

Multifieldの質問例

multifieldの質問にconditionを設定すると、multifieldの質問全体が別の最上位の兄弟質問に依存するようになります。multifieldの質問に対するconditionは、groupedQuestionFields配列の内側にある質問には依存できません。

groupedQuestionFields配列内の質問にconditionを設定すると、同じgroupedQuestionFields配列内の別の質問に依存させることができます。groupedQuestionFields配列内のconditionは、同じ配列外の質問に依存できません。詳細はconditionをご覧ください。

{
  "id": "work_experience",
  "type": "multifield",
  "question": "Please enter your past work experience (up to 10)",
  "minEntryCount": 1,
  "maxEntryCount": 10,
  "groupLabel": "Work Experience",
  "addButtonLabel": "Add Another Work Experience",
  "groupedQuestionFields": [
    {
      "id": "company_name",
      "question": "Company Name",
      "type": "text",
      "required": true,
      "limit": 100
    },
    {
      "id": "job_title",
      "question": "Job Title",
      "type": "text",
      "required": true,
      "limit": 100
    },
    {
      "id": "start_date",
      "question": "Start Date",
      "type": "date",
      "format": "MM/yyyy",
      "required": true
    },
    {
      "id": "end_date",
      "question": "End Date",
      "type": "date",
      "format": "MM/yyyy",
      "required": false
    },
    {
      "id": "responsibilities",
      "question": "Key Responsibilities",
      "type": "textarea",
      "required": false,
      "limit": 500,
      "minCharCount": 50
    }
  ]
}

審査用の質問の回答の自動入力

日本のみ。

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

質問スキーマ

廃止のお知らせ: 2025 年 12 月 8 日より、Indeed は審査用の質問スキーマのバージョン 0.0 をサポートしていません。審査用の質問の連携をスキーマバージョン 1.x にアップグレードしてください。バージョン 0.0 を使用し続けている連携は動作しなくなり、求職者は採用企業の自社サイトでの応募にリダイレクトされます。マイナーアップグレード（たとえば 1.0 から 1.1）は連携に影響せず、対応は不要です。メジャーアップグレードは頻繁ではありませんが対応が必要です。次回のメジャーアップグレードは 2026 年まで予定されていません。

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

質問の例（JSON）

{
  "schemaVersion": "1.0",
  "screenerQuestions": {
    "questions": [{
      "id": "favorite-widget-color",
      "type": "text",
      "question": "What is your favorite widget color?"
      "validationRuleKey": "anti_xss"  
    }, {
      "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": "prior-widget-roles",
      "type": "multifield",
      "question": "List your previous widget-crafting roles.",
      "groupLabel": "Widget role",
      "addButtonLabel": "Add another role",
      "minEntryCount": 1,
      "maxEntryCount": 5,
      "groupedQuestionFields": [{
        "id": "role-employer",
        "type": "text",
        "question": "Employer name"
      }, {
        "id": "role-title",
        "type": "text",
        "question": "Role title"
      }, {
        "id": "role-start-date",
        "type": "date",
        "question": "Start date",
        "format": "dd/MM/yyyy"
      }]
    }, {
      "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）

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* Added the ```multifield```\
    \ question type, a repeatable group of sub-questions (sub-fields)\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?"
                    validationRuleKey: "anti_xss"
                  - 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: "prior-widget-roles"
                    type: "multifield"
                    question: "List your previous widget-crafting roles."
                    groupLabel: "Widget role"
                    addButtonLabel: "Add another role"
                    minEntryCount: 1
                    maxEntryCount: 5
                    groupedQuestionFields:
                    - id: "role-employer"
                      type: "text"
                      question: "Employer name"
                    - id: "role-title"
                      type: "text"
                      question: "Role title"
                    - id: "role-start-date"
                      type: "date"
                      question: "Start date"
                      format: "dd/MM/yyyy"
                  - 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/MultifieldQuestion"
      - $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"
          multifield: "#/components/schemas/MultifieldQuestion"
          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"
      properties:                                                                                                                                                                                                                                                                                                         
          validationRuleKey:                                                                                                                                                                                                                                                                                                
            type: "string"                                                                                                                                                                                                                                                                                                  
            description: "Key for a validation rule that, when configured for a question, rejects                                                                                                                                                                                                                                   
              job seeker answers that fail the rule. Supported for pure text questions. For the list of available 
              validationRuleKey values, see [Validation rules](https://docs.indeed.com/indeed-apply/screener-questions#validation-rules)."
      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"
        validationRuleKey: 
          type: "string"
          description: "Key for a validation rule that, when configured for a question, rejects
            job seeker answers that fail the rule. Supported for text questions with format numeric_text. 
            For the list of available validationRuleKey values, see [Validation rules](https://docs.indeed.com/indeed-apply/screener-questions#validation-rules)."
      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"
          validationRuleKey:                                                                                                                                                                                                                                                                                      
            type: "string"                                                                                                                                                                                                                                                                                        
            description: "A validation rule that, when configured for a question, rejects                                                                                                                                                                                                                         
              job seeker answers that fail the rule. Supported for all text area questions.                                                                                                                                                                                                                        
              For the list of available validationRuleKey values, see [Validation rules](https://docs.indeed.com/indeed-apply/screener-questions#validation-rules).
    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
   MultifieldQuestion:
      title: "Multifield Question"
      type: "object"
      description: "A question that accepts multiple entries, for example multiple\
        \ work experiences or education-history answers. Each entry collects the group\
        \ of fields defined in groupedQuestionFields, and the question displays a\
        \ customizable \"add more\" button (see addButtonLabel) that lets the job\
        \ seeker provide multiple answers. A multifield question must include the\
        \ groupedQuestionFields array, which contains 1 to 20 related sub-questions;\
        \ see MultifieldSubField for the allowed sub-field types. If this multifield\
        \ question sets a condition, that condition may depend only on a different\
        \ top-level sibling question; it can not depend on a question inside the\
        \ groupedQuestionFields array. A multifield question has no question-level\
        \ required property; group-level required-ness is controlled solely by\
        \ minEntryCount (minEntryCount >= 1 makes the group required)."
      allOf:
      - $ref: "#/components/schemas/QuestionItemBase"
      - type: "object"
        required:
        - "type"
        - "question"
        - "groupLabel"
        - "addButtonLabel"
        - "groupedQuestionFields"
        not:
          required:
          - "required"
        properties:
          type:
            type: "string"
            enum:
            - "multifield"
          question:
            type: "string"
            description: "The question text that the applicants see."
          condition:
            type: "object"
            required:
            - "id"
            - "value"
            description: "Marks the multifield question as conditional, depending on\
              \ the answer to a previous top-level sibling question. Specify the id of\
              \ the previous question and the option value that activates this question."
            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 question's answer must match\
                  \ before this question is displayed."
          groupLabel:
            type: "string"
            minLength: 1
            description: "Label template shown for each entry (for example, \"Work experience\")."
          addButtonLabel:
            type: "string"
            minLength: 1
            description: "Label for the button that adds another entry."
          minEntryCount:
            type: "integer"
            minimum: 0
            maximum: 20
            default: 1
            description: "Minimum number of entries the applicant must provide. One\
              \ entry is one set of answers to the groupedQuestionFields. Must not be\
              \ negative, and can not exceed 20 (the maximum value maxEntryCount may\
              \ take). Defaults to 1 if not set."
          maxEntryCount:
            type: "integer"
            minimum: 1
            maximum: 20
            default: 15
            description: "Maximum number of entries the applicant may add. Must be\
              \ between 1 and 20, and must be greater than or equal to minEntryCount.\
              \ Defaults to 15 if not set."
          groupedQuestionFields:
            type: "array"
            minItems: 1
            maxItems: 20
            description: "The sub-questions that make up one entry."
            items:
              $ref: "#/components/schemas/MultifieldSubField"
      example:
        id: "prior-widget-roles"
        type: "multifield"
        question: "List your previous widget-crafting roles."
        groupLabel: "Widget role"
        addButtonLabel: "Add another role"
        minEntryCount: 1
        maxEntryCount: 5
        groupedQuestionFields:
        - id: "role-employer"
          type: "text"
          question: "Employer name"
        - id: "role-title"
          type: "text"
          question: "Role title"
        - id: "role-start-date"
          type: "date"
          question: "Start date"
          format: "dd/MM/yyyy"
    MultifieldSubField:
      title: "Multifield Sub-Field"
      type: "object"
      description: "A single sub-question within one multifield entry. Allowed types:\
        \ text, textarea, select, multiselect, date, file, hierarchical. A sub-field\
        \ may also use a condition for conditional display; note that condition is a\
        \ property, not a question type. A sub-field condition may depend only on\
        \ another question within the same groupedQuestionFields array; it can not\
        \ depend on a question outside that array. NOT allowed: nested multifield\
        \ questions (no\
        \ sub-field may itself be a multifield), information, or pagebreak. A sub-field\
        \ may NOT carry a qualification (qualification is only valid on top-level\
        \ questions)."
      not:
        required:
        - "qualification"
      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"
      discriminator:
        propertyName: "type"
        mapping:
          text: "#/components/schemas/TextQuestion"
          textarea: "#/components/schemas/TextAreaQuestion"
          select: "#/components/schemas/SelectQuestion"
          multiselect: "#/components/schemas/SelectQuestion"
          date: "#/components/schemas/DateQuestion"
          file: "#/components/schemas/FileQuestion"
          hierarchical: "#/components/schemas/HierarchicalQuestion"
    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:
            - "pagebreak"
      example:
        id: "page-1"
        type: "pagebrake"

ベストプラクティス

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

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

 

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