求人説明の書式
求人説明をHTMLで記述します。
このAPIとそのドキュメントを使用して連携を構築すると、APIに関する追加の利用規約およびガイドラインに同意したことになります。
概要
デフォルトでは、Indeed は求人内容をプレーンテキストとして扱います。より豊富な書式を使用するには、求人内容を HTML で指定します。
Indeed はサポートされている HTML を正規化し、求職者向けに標準化された形式で表示します。次のガイドラインに従わない HTML は、拒否されたり正しく表示されなかったりする場合があります。
-
サポートされている HTML タグ と computed style nodes のみを使用します。
-
HTML 内の引用符はエスケープします。
<font style=\"font-weight:bold\">Some bold text</font> -
<ではなく<などのリテラル文字を使用します。HTML entities を使用すると、拒否されたり正しく表示されなかったりする場合があります。
HTML 形式の求人内容を使用するには、SourcedJobPostingBodyInput で次のフィールドを設定します。
| フィールド | 型 | 説明 |
|---|---|---|
description | String! | 必須。求職者に表示される求人内容です。最大 65,000 バイトです（ASCII は 1 バイト、その他の文字は 2〜3 バイト）。 |
descriptionFormatting | SourcedJobPostingFormattingType! | 求人内容の形式です。 クライアントが求人一覧ページまたは求人詳細ページで HTML 形式を使用している場合、XML と API の求人でも、含められない合理的な理由がない限り、Indeed のポリシーでは通常 HTML が必要です。 HTML を使用すると、求人がクライアント側の表示にできるだけ近い形式で表示されます。書式が適切でない場合、クライアントや求職者から苦情が寄せられることがあります。 求人内容を HTML で指定するには、このフィールドを デフォルト: |
HTML タグ
| タグ | 説明 |
|---|---|
<b> | 太字テキスト。 |
| ヘッダー。 ヘッダータグ内のテキストは、Indeed上で一定のサイズで表示されます。 |
<br> | 単一改行。 |
<p> | 段落。Indeedは段落タグ間に自動的に空白行を挿入します。 |
<ul> | 順序なしリスト（箇条書き）。 |
<li> | リストアイテム。 |
<strong> | 強調（太字）テキスト。 |
<em> | 強調（斜体）テキスト。 |
| シンプルなテーブル。 |
Computed style nodes
| ノード | 説明 |
|---|---|
| 太字テキスト。 |
| インラインテキスト。 デフォルトでは、 |
<p>タグの上下のマージンとパディングはデフォルトで正の値に設定されています。これを上書きしないでください。
例
この例では、HTML の求人内容を含む求人情報を作成します。
mutation{ jobsIngest { createSourcedJobPostings(input: { jobPostings: [ { body: { title: "Accounting work for paper processing company" subtitle: "Full-time from 10am to 3pm." description: "<h2>Job description</h2>【POINT】<div><br/>You can use your office experience from any industry. <br/><br/>[Job details]<br/>・Organizing documents<br/>・Answering telephones<br/>・Responding to visitors<br/><br/>[Working environment]<br/>Our company was established in 1955.<br/>We deliver high-quality paper products.<br/><br/>As our business expands, we seek part-time workers to handle accounting work. <br/>We are creating an environment where we can grow together. <br/></div>" descriptionFormatting: "RICH_FORMATTING" } metadata: {} }] }) { results { jobPosting { sourcedPostingId } } } }}日本のパートナー向け
日本の求人説明には、次の追加要件があります。
descriptionFormattingをRICH_FORMATTINGに設定します。- 求人説明の各項目に対応する セグメント を定義します。
セグメント
セグメントは、勤務時間、休日、勤務地など、求人の 1 つの項目を表します。各セグメントでは、HTML 階層の同じレベルで header タグと content タグを使用します。すべての header タグと content タグに内部テキストを追加してください。たとえば、次のようにします。
<h2 data-segment-type=\"header\" data-segment-label=\"JobDescription\">Job Description</h2><div data-segment-type=\"content\" data-segment-label=\"JobDescription\">Hiring crane operators!</div>セグメントタグでは、次の属性を使用します。
| 属性 | 説明 | 例 |
|---|---|---|
data-segment-type | タグが header か content かを表します。すべてのセグメントタグで必須です。 |
|
data-segment-label | セグメントの内容タイプです。すべてのセグメントタグで必須です。header タグと content タグの両方で同じ値を使用してください。Indeed は、サポートされていない値を セグメントラベル をご覧ください。 |
|
セグメントラベル
Indeed は次の data-segment-label 値をサポートしています。
| 値 | 説明 |
|---|---|
JobDescription | 職務内容です。福利厚生と勤務時間は含めません。 |
Qualification | 法令に準拠した候補者の要件と歓迎条件です。必要な資格も含めます。 法令で認められている場合を除き、年齢や性別を制限しないでください。制限する場合は、その理由を記載してください。 |
WorkHours | 勤務時間とシフトです。所要時間、休憩時間、シフトスケジュールを含めます。
|
Holidays | 休日、有給休暇、祝日、休暇制度です。週末の詳細を含めます。 |
WorkLocation | 勤務地です。該当する場合は、リモートワークや転勤の選択肢を含めます。通勤の詳細は |
CommuteInfo | 通勤情報です。公共交通機関の選択肢、最寄駅、距離を含めます 。 |
Pay | 給与の詳細です。基本給、賞与、昇給、退職金、通勤手当、残業代、歩合給を含めます。
給与の例は |
SalaryExample | 給与の例です。 |
Benefits | 社員寮、各種サービス、報奨制度、社会保険などの福利厚生です。 |
WorkEnvironment | 従業員数、性別比、年齢構成などの職場環境です。 |
ApplyMethod | 応募方法です。電話応募などを含みます。 Indeed PLUS では Indeed Apply が標準の応募方法です。 電話応募は標準的でなくなる可能性があります。 |
ApplyInfo | 採用プロセスの詳細です。面接回数、面接場所などを含みます。 |
EmployerMessage | 企業文化やビジョンなど、候補者に訴求するための追加情報です。 |
Other | その他の詳細です。サポートされていない |
セグメントの例
この例では、description にセグメント化された HTML の求人内容を設定して createSourcedJobPostings を呼び出します。
mutation{ jobsIngest { createSourcedJobPostings(input: { jobPostings: [ { body: { title: "Accounting work for paper processing company" subtitle: "Full-time from 10am to 3pm." description: "<h2 data-segment-type=\"header\" data-segment-label=\"JobDescription\">Job description</h2><div data-segment-type=\"content\" data-segment-label=\"JobDescription\">【POINT】<br/>You can use your office experience from any industry.<br/><br/>[Job details]<br/>・Organizing documents<br/>・Answering telephones<br/>・Responding to visitors<br/><br/>[Working environment]<br/>Our company was established in 1955.<br/>We deliver high-quality paper products.<br/><br/>As our business expands, we seek part-time workers to handle accounting work.<br/>We are creating an environment where we can grow together.<br/></div>" descriptionFormatting: "RICH_FORMATTING" } metadata: {} }] }) { results { jobPosting { sourcedPostingId } } } }}次の例は、正しいセグメント書式と誤ったセグメント書式を示しています。読みやすくするため、これらの例では引用符をエスケープしていません。description に HTML を入力する際は、引用符をエスケープしてください。
<h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description</h2><div data-segment-type="content" data-segment-label="JobDescription"> Hiring crane operators!</div><h2 data-segment-type="header" data-segment-label="Qualification"> Requirements</h2><div data-segment-type="content" data-segment-label="Qualification"> The class B crane operator's certificate is required for this job.</div><h2 data-segment-type="header" data-segment-label="WorkLocation"> Work Location</h2><div data-segment-type="content" data-segment-label="WorkLocation"> Ichikawa (as a dispatch employee) and other locations</div><h2 data-segment-type="header" data-segment-label="WorkHours"> Length of Service</h2><div data-segment-type="content" data-segment-label="WorkHours"> <ul> <li>At least 3 months</li> <li>5 days per week</li> <li>8 hours per day</li> </ul> <p> We want to be as flexible for employees as possible, so please make a request such as "Would love to take a day off on Monday" or "Would love to work hard and earn more money." </p></div><h2 data-segment-type="header" data-segment-label="Benefits"> Benefits</h2><div data-segment-type="content" data-segment-label="Benefits"> <ul> <li>Social insurance</li> <li>Commute fee</li> <li>Uniform provided</li> <li>Chance of pay increase</li> <li>Daily wage</li> </ul></div><h2 data-segment-type="header" data-segment-label="ApplyMethod"> How to Apply</h2><div data-segment-type="content" data-segment-label="ApplyMethod"> Apply for this job through a phone call or the application form on the website. Bring your resume to the interview.</div>結果：
誤り：セグメントタグに必須の属性がありません。
<h2> Job Description</h2><div> Hiring crane operators!</div>修正方法: 内部テキストは、data-segment-type 属性と data-segment-label 属性を持つ HTML タグであるセグメントタグの中に配置します。
セグメント内にネストされていれば、テキストを非セグメントタグに配置することもできます。
この例では、"Hiring crane operators!" は、正しいセグメント属性を持つ <div> の中にネストされた非セグメントタグに含まれています。
<h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description</h2><div data-segment-type="content" data-segment-label="JobDescription"> <ul> <li>Hiring crane operators!</li> </ul></div>誤り: 内側の <h2> と <div> には必須属性がありますが、外側の <div> にはそれらの属性がないテキストが含まれています。
<div> This fails. <h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description </h2> <div data-segment-type="content" data-segment-label="JobDescription"> Hiring crane operators! </div></div>修正方法: 外側の <div> に必須属性を追加します。
正しい例: 外側の <div> にテキストが含まれていません。
<div> <h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description </h2> <div data-segment-type="content" data-segment-label="JobDescription"> Hiring crane operators! </div></div>誤り: この例では、サポートされていない data-segment-type を使用しています。
<h2 data-segment-type="unsupportedType" data-segment-label="JobDescription"> Job Description</h2><div data-segment-type="unsupportedType" data-segment-label="JobDescription"> Hiring crane operators!</div>修正方法: data-segment-type を header または content に設定します。
誤り: セグメントに data-segment-label 属性がありません。
<h2 data-segment-type="header"> Job Description</h2><div data-segment-type="content"> Hiring crane operators!</div>修正方法: data-segment-label 属性を追加します。
誤り: この例では、サポートされていないラベルを使用しています。
<h2 data-segment-type="header" data-segment-label="LabelThatDoesNotExist"> Job Description</h2><div data-segment-type="content" data-segment-label="LabelThatDoesNotExist"> Hiring crane operators!</div>修正方法: data-segment-label を セグメントラベル に設定します。Indeed は、サポートされていない値を Other として扱います。
誤り: これらのセグメントには内部テキストがありません。
<h2 data-segment-type="header" data-segment-label="JobDescription"></h2><div data-segment-type="content" data-segment-label="JobDescription"></div><h2 data-segment-type="header" data-segment-label="JobDescription"/><div data-segment-type="content" data-segment-label="JobDescription"/>修正方法: セグメントに内部テキストを追加します。
誤り: JobDescription ラベルの header セグメントの後に、Benefits ラベルの header セグメントが続いています。
<h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description</h2><h2 data-segment-type="header" data-segment-label="Benefits"> Benefits</h2>修正方法: header セグメントの後に、同じ data-segment-label 値を持つ content セグメントを追加します。
誤り: header セグメントがありません。
<div data-segment-type="content" data-segment-label="JobDescription"> Hiring crane operators!</div>修正方法: header セグメントを追加します。
誤り: content セグメントが、header セグメントとは異なる階層レベルの <div> の中にネストされています。
<h2 data-segment-type="header" data-segment-label="JobDescription"> Job Description</h2><div> <div data-segment-type="content" data-segment-label="JobDescription"> Hiring crane operators! </div></div>修正方法: header セグメントと content セグメントを同じ HTML 階層レベルに配置します。