よくある質問
Job Sync API に関するよくある質問です。
Job Sync API 連携
Job Sync APIはIndeed Apply XMLフィードと同じ機能をサポートします。XML連携の代わりにJob Sync APIを使用してください。
Job Sync APIとの連携後、審査用に連携を提出してください。
オンボーディング時に、Indeedは2-legged OAuth認証情報（クライアントIDとシークレット）を持つアプリを作成します。Partner Consoleで認証情報を取得し、アクセストークンに交換して、API呼び出しにそのトークンを含めてください。トークンの有効期限は1時間です。
OAuth認証情報はクライアントIDとシークレットです。Partner Consoleでこれらの認証情報にアクセスし、アクセストークンに交換して、すべてのAPI呼び出しにそのトークンを含めてアプリを認証します。アクセストークンの有効期限は1時間です。
求人を最新に保つため、APIはリアルタイムで呼び出してください。
Indeedはクライアントのニーズに応じてティアとレート制限を割り当てます。レート制限をご覧ください。
いいえ。合計のみ取得できます。
Indeed UIは頻繁に変更されるため、ありません。
求人掲載の送信と更新
最大100件です。HTTPリクエストサイズに制限があるため、APIリクエスト1回につき1件の求人投稿のみ作成してください。
求人は投稿直後に公開されます。
createSourcedJobPostingsを呼び出して、Indeed に求人を作成します。employerIdsを設定して、求人情報を雇用主に関連付けます。例: ATS で
typeがFOOATS_EMPLOYER_ID、雇用主 ID がabc123の場合。次の値でcreateSourcedJobPostingsを呼び出します。{"employerIds": [{"type": "FOOATS_EMPLOYER_ID","id": "abc123"}]}この ID を作成するには、Employer Data API（雇用主データAPI）をプロビジョニングします。ID は Partner Console で確認できます。
次の値で
patchEmployerを呼び出します。{"id":{"type": "FOOATS_EMPLOYER_ID","id": "abc123"}}idはemployerIdsと一致する必要があります。詳細については、Employer Data をご覧ください。
雇用主ごとに、一意の sourceName 値を選択します。sourceName は、まとめて管理され、その役割を採用している一連の求人（親組織など）に対する、人間が読める会社名または組織名です。
この値は数値や ID ではありません。ただし、一意にするために名前に数値や ID を付加できます。例:
| 推奨 | 非推奨 |
|---|---|
| |
| |
1 つの雇用主の下にある複数の求人グループ: 求人グループごとに一意の値を使用します。多数のブランド展開する拠点を持つ子会社やフランチャイズの場合は、同じ sourceName を使用します。値は求人グループ間で一意であり、単一の sourceType（組織タイプ）を持つ必要があります。
会社名の変更: 元の sourceName を維持します。companyName を新しい名前に更新します。
個別に管理されるフランチャイズ: 店舗番号や店舗 ID などの値を使用します。
sourceName: "ConvenienceMart store ID 345"重複するソース名: ユーザーがソースを区別できるように、名前を一意にします（例: 所在地を追加する）。
求人を個別に管理する支店: 一意の値を使用します。例: ConvenienceMart には 2 つの支店と 3 つの店舗があります。各支店と店舗が求人を個別に管理するには、次の companyName と sourceName の組み合わせを使用します。
| 支店 | 店舗 |
|
|---|---|---|
| 東京 | 渋谷駅 | |
| 新宿駅 | | |
| 大阪 | 大阪駅 | |
この雇用主をIndeedの全言語・全国で使用するには、isGlobalDefaultをtrueに設定してください。
Indeedは投稿事業体の確認のためクライアントの連絡先メールを使用します。contactEmailはどこにも表示されません。
リモート求人では、特定の勤務地への出社が不要です。
次の求人があります。
- 全国リモート求人は、国内のどこからでも勤務できます。
- 地域リモート求人は、都道府県などの地域内のどこからでも勤務できます。
全国リモート求人または地域リモート求人を定義するには、次のフィールドを設定します。
| リモート求人の種類 | remoteType | cityRegionPostal | streetAddress |
|---|---|---|---|
| 全国 | Fully Remote | 空欄のままにします。 | 空欄のままにします。 |
| 地域 | Fully Remote | 日本国内の求人の場合は空欄のままにします。それ以外の場合は、地域を設定します。 市区町村を設定すると、その求人はリモートになりません。 | 空欄のままにします。 |
createSourcedJobPostingsにはXMLの<keywords>タグに相当するフィールドはありません。
ポジションと勤務地の組み合わせごとに1件の求人投稿を投稿してください。
jobPostingId、sourceName、またはクライアントIDを変更すると、APIは新しいsourcedPostingIdを返します。
これらのフィールドを変更する前に、expireSourcedJobsBySourcedPostingIdを現在のsourcedPostingIdで呼び出して求人を失効させてください。
sourcedPostingIdは必ず保存してください。求人の失効や再有効化に必要です。求人投稿の失効をご覧ください。
説明に、業務完了までの想定期間を記載してください。
例：
3か月プロジェクトで120万円の場合は、月40万円と記載
給与範囲または固定給を定義するには、次のフィールドを設定します。
| 定義する内容 | minimumMinor | maximumMinor |
|---|---|---|
| 給与範囲 | 最低給与を設定します。 | 最高給与を設定します。 |
| 最低給与のみの給与範囲 | 最低給与を設定します。 | |
| 固定給 | 固定給を設定します。 | 固定給を設定します。 |
このデータを次のフィールドに含めます。
| フィールド | 値 |
|---|---|
jobPostingId | ATS 全体で一意の ID（UUID も使用できます）。この ID で再掲載すると、以前に掲載期間が終了した求人を再開できます。 |
jobRequisitionId | 人間が読める ID。ATS 全体での一意性は必須ではありません。 |
- Indeed に求人情報を送信した場合は、求人情報をアップサートします。
- 別のパートナーが Indeed に求人情報を送信した場合は、求人情報を更新します。更新操作は主に広告代理店向けです。
日本のみ。 広告代理店と Indeed PLUS Publisher Network パートナーを除くすべてのパートナーは、求人情報を更新できます。
求人の更新内容を指定して createSourcedJobPostings を呼び出します。作成時と同じ jobPostingId、sourceName、および OAuth クライアント ID を使用します。Indeed はこれらに基づいて重複を排除します。変更がない場合でも、必須の求人詳細をすべて含めます。
Indeedでは以前、日本でcityRegionPostalが必要でしたが、現在は使用していません。
findEmployerJobsPartnerを呼び出して求人投稿一覧を取得します。レスポンスには求人ごとにsourcedPostingIdが含まれます。そのIDをcreateSourcedJobPostingsまたはupdateSourcedJobPostingsで更新に、expireSourcedJobsBySourcedPostingIdで失効に使用します。
求人の表示
Indeedの基準を満たさない求人は審査の対象となり、採用企業から追加情報が必要な場合があります。求人が求職者に表示され続けるよう、求人投稿基準 - 英語または求人投稿基準 - 日本語に従ってください。
求人投稿を作成した後、Indeedに表示され求職者が検索できるようになるまで1〜2時間かかります。
Indeed PLUSは複数の求人 掲示板と連携しています。どのフィールドが表示されるかは各求人掲示板が決定します。
日本の求人の場合：求人投稿については日本固有の求人フィールド表示を、雇用主については日本の雇用主フィールド表示をご覧ください。
いいえ。
クライアント向けに求人表示を有効にするには、Job Sync APIガイドをご覧ください。
ATS では、クライアントは各求人について、その求人が次のいずれかの状態であることを示す画像を確認できます。
- Indeed で検索可能である。
- 検索可能にするにはスポンサー設定が必要である。
次のいずれかの理由で見つからない。
- 求人が存在しない。
- ユーザーがその求人にアクセスできない。
クライアントが画像をクリックすると、Indeed 上の求人に関する追加情報にアクセスできます。
クライアントが画像をクリックすると、複数のステータスが表示される場合があります。求人ステータスをご覧ください。
ユーザーがパートナーUIで求人を表示したとき、1時間に1回までステータスを更新できます。Indeedはこれを制御しません。
はい。
いいえ。Searchableと表示されます。
求職者はIndeedの検索結果でこれらの求人を表示できません。
いいえ。公開中の求人の表示のみ確認できます。
失効求人の表示ブール値は不正確な場合があります。ユーザーには表示しないでください。
IndeedはATSフィードの求人数と雇用主の採用サイトで表示されている求人数を比較します。差異がある場合、Indeedは調査を行い、契約上の義務の遵守を確認します。
各ATSパートナーがアクセス可能なすべての求人を送信していれば、ATSは準拠しています。フィードと採用サイトの求人数が異なる場合、パートナーマネージャーが不足している可能性のある求人とクライアントの特定を支援します。
Indeedに求人を送信しない場合（例：将来の求人、プライバシーまたは機密性のため）、雇用主は会社のレターヘッドで停止要請を提出する必要があります。手紙をパートナーマネージャーに共有するか、非管理の場合はmarketplacesupport@indeed.comに送信してください。
雇用主は機密または将来の求人リストをオプトアウトできます。Indeedは求人の記録を保持しますが、検索や雇用主アカウントには表示されません。
求人掲載の掲載終了
expireSourcedJobsBySourcedPostingIdを呼び出して求人投稿を失効させます。求人はIndeedに表示されなくなります。
再有効化は有効期限切れの求人を再有効化をご覧ください。
sourcedPostingIdは通常保持されます。求人が30日以上失効したままの場合は変更されることがあります。
createSourcedJobPostingsを呼び出してsourcedPostingIdを取得します。
求人投稿を失効させるには、expireSourcedJobsBySourcedPostingIdをその求人のsourcedPostingIdで呼び出してください。
有効期限切れの求人を再有効化するには、createSourcedJobPostingsを、失効した求人と同じjobPostingIdおよびsourceNameで呼び出してください。これはアクティブな求人を更新するときと同じです。
ATSで再有効化日を設定するにはdatePublishedを更新してください。
失効から30日以内であれば求人 を再有効化できます。
30日を超えると、Indeedは求人統計と設定をアーカイブする場合があります。30日を超えて再有効化すると、新しいsourcedPostingIdが返されることがあるため、同じIDと新しいsourcedPostingIdの両方にコードで対応してください。
sourcedPostingIdを保存してください。求人の失効や再有効化に必要です。
求人は自動では失効しません。求人を失効させるにはAPIを呼び出してください。
トラブルシューティング
GRAPHQL_PARSE_FAILEDエラーは、GraphQL操作文字列の構文エラー（多くの場合descriptionフィールドのエスケープされていないHTML）を意味します。求人説明のフォーマットとGRAPHQL_PARSE_FAILEDエラーをご覧ください。
求人を掲載する際に問題が発生する場合があります。連携を成功させるために、データを確認して修正します。
| 問題 | 説明 |
|---|---|
hasProbationaryPeriod がデフォルトで UNKNOWN になっている | 日本では、この値はスクリーニングで不合格になることがよくあります。このフィールドは他のロケールには適用されません。 |
| データが正しくフォーマットされていない | 正しくフォーマットされていないデータは、無効な API 呼び出しの原因となり、連携データの信頼性が低いことを示します。求人情報の作成をご覧ください。 |
| 求人リンクが求人につながらない | 自社サイトの求人詳細ページへのリンクを提供します。Indeed はこれらを使用して、求人コンテンツの一貫性と有効性を確認します。 リンクが応募フォームやその他のページではなく、求人詳細ページにつながるようにします。有効なリンクにより、Indeed はデータの整合性を保ち、求職者が自社の企業ウェブサイトで求人を確認できるようになります。 |
| 求人内容が不完全である | 求人内容に必須情報をすべて含めます。特定のフィールドのデータは、必ずしも求職者に表示されるとは限りません。 求人内容が最終的な信頼できる情報源となります。求人内容のフォーマットをご覧ください。 |
| パートナーサイトと Indeed の求人内容のレイアウトが異なる | Indeed は、コンテンツが一致していることを確認するために自社のウェブサイトをチェックします。求人内容のレイアウトが大きく異なる場合、Indeed はコンテンツの不一致を理由に求人を非アクティブとしてマークし、掲載を終了することがあります。 求人内容の順序を、自社サイトと Indeed のデータ間で一貫させます。 |
| データが Indeed のシステムと互換性がない | データの相当な部分が誤った表示の原因となっていると Indeed が判断した場合は、修正する必要があります。 相当な部分は、問題の蔓延度と求職者への影響によって判断されます。 例: |
| 求人内容が API フィールドを誤用している | タイトルにクリックベイト、所在地に所在地以外のデータ、その他の無関係な情報を提供すると、Indeed が連携をブロックすることがあります。 相当な部分は、問題の蔓延度と求職者への影響によって判断されます。 |
| 求人が最新でない | Indeed 上の求人は、自社サイトに合わせて掲載を終了するか更新する必要があります。古い求人は求職者に問題を引き起こします。 求人を最新の状態に保ってください。そうしないと、Indeed が連携をブロックしたり、同期されていないコンテンツの掲載を終了したりすることがあります。求人情報のアップサートをご覧ください。 |
多くの場合、クライアントがその求人にアクセスできません。
Indeedが雇用主アカウントと求人を紐付けられるよう、クライアントにIndeedサポートへの連絡を依頼してください。
サポートを受ける
Job Sync APIのエラーの多くは、切り分けに役立つ情報を含みます。
GraphQLエラーのトラブルシューティングをご覧ください。
エラーを解決できない場合は、次の内容でサポートリクエストを送信してください。
- リクエストとレスポンスのペイロード全体。
- 再現手順。
- エラー内容。