- 質問セクション
schemaVersionscreenerQuestionsdemographicQuestions- JSON 質問パラメータ
idtypequestiontextoptionsvaluelabelrequiredformatlimitminCharCountminmaxminSelectionCountmaxSelectionCountconditionhierarchicalOptionsqualificationvalidationRuleKey- Qualification パラメータ
typematchrange- Match パラメータ
typevalues- Range パラメータ
minmax- 検証ルール
nameaddressphoneemailcompensationalphanumeric_period_dashalphanumeric_bracket_underscore_slashalphanumeric_slashurlanti_xsstax_exemption- 質問タイプ
- textarea
- text
- select
- multiselect
- condition
- hierarchical
- date
- file
- information
- pagebreak
- multifield
- 審査用の質問の回答の自動入力
- 質問スキーマ
- 質問の例（JSON）
- 質問スキーマの例（OpenAPI YAML）
- ベストプラクティス
審査用の質問のJSONリファレンス
JSON 形式の審査用の質問のパラメータ。
法的注意
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
審査用の質問をサポートするシステムでは、連携の承認を受けるために、Indeed エントリーで JSON の審査用の質問のパラメータを実装する必要があります。
Indeed エントリーの応募フローに審査用の質問を表示するには、次のいずれかの方法を使 用します。
-
JSON 形式で作成し、HTTPS URL にホストして、その URL を各
<job>の<indeed-apply-data>要素配下にある<indeed-apply-questions>パラメータに含めます。Indeed エントリーの審査用の質問を追加するをご覧ください。 -
求人情報連携APIを呼び出して、審査用の質問付きで求人を作成します。
審査用の質問の JSON ファイルの構文を検証するには、Indeed Apply Questions tool を使用してください。
審査用の質問に電話番号やメールアドレスを含めないでください。デフォルトでは、応募データ にメールアドレスが含まれます。電話番号を取得するには、Indeed エントリーのパラメータ を使用してください。
質問セクション
schemaVersion
必須
| 説明 | Indeed エントリーの審査用の質問スキーマのバージョンです。
現在のバージョンは 1.3 です。Indeed は機能を追加すると、マイナーバージョンの更新をリリースします。配信 postbody には、1.1 や 1.2 などの 1.X 形式でスキーマバージョンが含まれます。 マイナーバージョンの更新で統合に支障が出ないように、この値は柔軟に扱ってください。 |
|---|---|
| 値 | バージョン番号 |
| 例 | |
screenerQuestions
必須
| 説明 | このフィールドは、職歴、スキル、資格など、求人に関する一般的で適切に構成された質問に使用します。民族、性別、障害に関する人口統計の質問は含めないでください。保護対象クラス に関連する質問は、一部の法域で規制されており、Indeed のシステムとお客様のシステムの両方で特別に処理する必要があります。人口統計の質問は、代わりに |
|---|---|
| 値 | オブジェクトです。 JSON questions parameters をご覧ください。 |
| 例 | |
demographicQuestions
| 説明 | このフィールドは、民族、性別、障害など、応募者の 保護対象クラス に関する特定の、適切に構成された質問に使用します。これらの質問は一部の法域で規制されており、Indeed のシステムとお客様のシステムの両方で特別に処理する必要があります。 Indeed は EEO コンプライアンスのため、人口統計の質問を米国の求人に限定します。 職歴、スキル、資格に関する一般的な審査用の質問は含めないでください。これらの質問は、代わりに
|
|---|---|
| 値 | オブジェクトです。 JSON questions parameters をご覧ください。 |
| 例 | |
JSON 質問パラメータ
id
必須
| 説明 | この質問の一意の ID です。 |
|---|---|
| 値 | 任意の文字列です。 |
| 例 | |
type
必須
| 説明 | 質問のタイプです。 詳細については、各値の説明をご覧ください。 |
|---|---|
| 値 | |
| 例 | |
question
"type": "information" と
"type": "pagebreak" を除き必須
| 説明 | 応募者に表示される質問テキストです。 |
|---|---|
| 値 | 任意の文字列です。 |
| 例 | |
text
の場合は必須
| 説明 | 応募者に表示されるテキストです。他の質問タイプではこのフィールドはサポートされません。 |
|---|---|
| 値 | 任意の文字列です。 |
| 例 | |
options
| 説明 | 使用可能な選択肢です。 |
|---|---|
| 値 | JSON です。 |
| 例 | |
value
| 説明 | 各オプションの値です。 |
|---|---|
| 値 | 任意の文字列です。 |
| 例 | |
label
| 説明 | メニューオプションのテキストです。select または multiselect の質問では、各 label はその質問内で一意である必要があります。 |
|---|---|
| 値 | 任意の文字列です。 |
| 例 | |
required
| 説明 | true に設定すると質問が必須になり、空でないテキストフィールドまたは選択が必要になります。質問を任意にするには、このパラメータを省略します。質問が任意で応募者が回答しない場合、Indeed は回答値として "" を送信します。 |
|---|---|
| 値 | true |
| 例 | |
format
| 説明 | 入力が受け付ける形式です。
|
|---|---|
| 値 | テキスト形式:
|
| 例 | integer, dd/MM/yyyy |
limit
| 説明 | "type": "text" および "type": "textarea" での回答の文字数制限です。 |
|---|---|
| 値 | 任意の整数です。 |
| 例 | |
minCharCount
| 説明 | "type": "text" および "type": "textarea" での回答の最小文字数です。minCharCount は非数値形式にのみ適用されます。 |
|---|---|
| 値 | 任意の整数です。 |
| 例 | |
min
| 説明 | 受け付ける最小値です。
|
|---|---|
| 値 |
|
| 例 | |
max
| 説明 | 受け付ける最大値です。
|
|---|---|
| 値 |
|
| 例 | |
minSelectionCount
| 説明 | "multi-select" の場合に、応募者が選択する必要があるオプションの最小数です。 |
|---|---|
| 値 | 任意の整数です。 |
| 例 | |
maxSelectionCount
| 説明 | "multi-select" の場合に、応募者が選択できるオプションの最大数です。 |
|---|---|
| 値 | 任意の整数です。 |
| 例 | |
condition
| 説明 | 前の select 質問への回答に応じて、質問を条件付きで表示します。前の質問の id と、この質問を有効にするオプションの value を指定します。たとえば、応募者に兵役経験があるかどうかを尋ねます。回答が「はい」の場合は、どの軍種に所属していたかを尋ねる条件付き質問を表示します。 |
|---|---|
| 値 | JSON です。 |
| 例 | |
hierarchicalOptions
| 説明 | 前の選択に基づいて後続の質問と回答を表示します。たとえば、応募者に州を選択させ、その後に選択した州の都市のドロップダウンを表示できます。各 hierarchical 質問は最大 3 レベルをサポ ートします。 |
|---|---|
| 値 | JSON です。 |
| 例 | |
qualification
| 説明 | 求人で必要になる可能性がある資格について応募者に尋ねる質問 です。応募者の回答は、採用企業が指定する条件を満たす必要があります。Indeed は、応募者が適格条件を満たしているかどうかにかかわらず、すべての応募を採用企業に配信します。 応募者の 保護対象クラス に関する質問など、 サポートされる質問タイプは |
|---|---|
| 値 | オブジェクトです。 qualification パラメータ をご覧ください。 |
| 例 | |
validationRuleKey
| 詳細 | 質問に設定すると、ルールに違反する求職者の回答を拒否する入力規則の識別子です。
|
|---|---|
| 値 |
検証ルールをご覧 ください。 今後、さらに多くの検証ルールが利用可能になる場合があります。 |
| 例 | |
Qualification パラメータ
type
必須
| 説明 |
|
|---|---|
| 値 | enum: "non-blocking" "knockout" |
| 例 | |
match
| 説明 | この質問の評価方法が match であることを示します。質問タイプは select と multiselect です。 |
|---|---|
| 値 | オブジェクトです。 match パラメータ をご覧ください。 |
| 例 | |
range
| 説明 | この質問の評価方法が range であることを示します。ユーザーの回答は、
この評価方法は、 |
|---|---|
| 値 | JSON です。 |
| 例 | |
Match パラメータ
type
| 説明 | 応募者の回答が、指定した値の "any" または "all" の条件に一致する必要があるかどうかを示します。 |
|---|---|
| 値 | enum: "any" "all"
デフォルトは "any" です。 |
| 例 | |
values
必須
| 説明 | 応募者の回答が一致する必要がある値です。 |
|---|---|
| 値 | 配列です。 |
| 例 | |
Range パラメータ
min
| 説明 | 受け付ける範囲の最小値です。 |
|---|---|
| 値 |
|
| 例 | |
max
| 説明 | 受け付ける範囲の最大値です。 |
|---|---|
| 値 |
|
| 例 | |
検証ルール
以下の検証ルールを質問に設定すると、禁止文字を含む求職者の回答は無効となります。
name
| 説明：使用できる文字 | 名前フィールド：英数字、スペース、& . ' - " ( ) / º |の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
address
| 説明：使用できる文字 | 住所フィールド：英数字、スペース、, . ' - " ( ) / \ | : # + ! & ; ½ ºの記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
phone
| 説明：使用できる文字 | 電話番号フィールド：英数字、スペース、 , . - ( ) : # + / * \の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
email
| 説明：使用できる文字 | メールフィールド：英数字、スペース、 . @ " ( ) , : ; < > [ \ ] ! # $ % & ' * + - / = ? ^ _ ` { | } ~の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
compensation
| 説明：使用できる文字 | 給与フィールド：英数字、スペース、 , . ( ) + % $の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
alphanumeric_period_dash
| 説明：使用できる文字 | 英数字（ピリオド・ダッシュを含む）：英数字、スペース、. + -の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
alphanumeric_bracket_underscore_slash
| 説明：使用できる文字 | 英数字（括弧、アンダースコア、スラッシュを含む）：英数字、スペース、{ } [ ] ( ) _ / + -の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
alphanumeric_slash
| 説明：使用できる文字 | 英数字（スラッシュを含む）：英数字、スペース、/ + -の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
url
| 説明：使用できる文字 | URLフィールド： 英数字、スペース、 - _ . ~ ! * ' ( ) ; : @ & = + $ , / ? % # [ ]の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
anti_xss
| 説明：使用できる文字 | 潜在的なインジェクション文字である ' " \ / ` と山括弧をブロックします。 < > |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
tax_exemption
| 説明：使用できる文字 | 免税フィールド：英数字、スペース、 , . ( ) + % $ _の記号 |
|---|---|
| validationRuleKey |
|
| Regex | |
| 例 | |
質問タイプ
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 を返します。
有効なファイルタイプは次のとおりです。
docdocxgifjfifjifjpejpegjpgpdfpngrtftiftifftxt
各ファイルの上限は 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件含まれます。
texttextareaselectmultiselectdatefilehierarchicalcondition
注意：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の質問に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 |
質問スキーマ
このスキーマは、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 を使用すると設定不備の原因になります。