SFTP サーバーガイドライン
Indeed の SFTP サーバーに XML 求人ファイルをアップロードするためのガイドラインです。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
概要
#クライアントは、XML 求人ファイルを Indeed の SFTP サーバーにアップロードします。Indeed はそのファイルを処理し、求人を Indeed に表示します。
サーバーはすべてのクライアントで共有されているため、期限どおりに処理されるよう、全員がこれらのガイドラインに従う必要があります。ガイドラインに従わないクライアントは、サーバーへのアクセスを取り消されることがあります。
ガイドライン
#1. 接続数をできるだけ少なくする
#Indeed は、DDoS 攻撃のリスクを減らすために接続数を制限しています。すべてのクライアントがファイルをアップロードできるよう、必要な接続だけを開いてください。
接続は 1 つだけ使用するのが理想です。複数のファイルを同時にアップロードする場合も、ファイルごとに接続を開く必要はありません。SFTP では、1 つの接続で複数の操作を実行できます。
2. 最終的なファイル名でアップロードする
#Indeed は、アップロードが完了するとすぐにファ イルの処理を開始します。アップロード後にファイル名を変更すると、処理が最大 10 分遅れることがあります。
ファイルをアップロードした後は、次のことを行わないでください。
- ファイル名を変更する。
- ファイルを削除する。
- 更新時刻や権限など、ファイルのメタデータを変更する。
- ファイルの状態を繰り返しポーリングする。
アップロードを確認するには、貴社のディレクトリにある processed サブディレクトリを確認してください。Indeed はファイルを受け取るたびに、このサブディレクトリに空のファイルを追加し、2 日間保持します。
例: 2022 年 7 月 19 日の中部夏時間 10:31:00 に ftp/ftpexample123/file.xml をアップロードしたとします。Indeed は空のファイル ftp/ftpexample123/processed/file.xml/20220719_103100_CDT.xml を追加します。このファイルにより、ファイルがアップロードされ、処理中であることを確認できます。
3. アップロード頻度を決める
#スケジュールに沿ってアップロードするか、求人が大きく変更されたときにアップロードしてください。
- スケジュールに沿ってアップロードする場合:
- 6 時間ごとにアップロードします。
- アップロードの間隔は 2 時間以上空けてください。
- 求人が変更されたときにアップロードする場合:
- 求人の 1% 以上が変更されたときにアップロードします。
- 多数の求人の URL を変更しても、大きな変更とは見なされません。
アップロードの頻度を上げても、求人が早く表示されるわけではありません。アップロードのたびに Indeed は XML ファイル全体を再処理し、その後も各求人は Indeed のパイプラインの残りの処理を通過する必要があります。現在、Indeed は 3 時間ごとに更新を取り込み、アップロード頻度が高すぎるアカウントを制限しています。このタイミングは変更される可能性があります。
4. 必要なファイルだけ をアップロードする
#Indeed は、アップロードのたびにファイル名を確認し、そのファイルを処理できるかどうかを判断します。ファイル名を認識できない場合、Indeed はそのファイルを貴社がアクセスできないディレクトリに移動します。
不要なファイルはサーバーの負荷を増やし、重要なファイルの処理能力を下げます。
ご依頼があれば、Indeed がアップロード済みのファイルを確認し、処理されていないファイルをお知らせします。
5. 命名規則に従う
#ファイルを追跡しやすくするため、my_jobs.xml のように、毎回同じファイル名でアップロードしてください。
日時だけが異なるファイル名も使用できます。
たとえば、my_jobs_20220816_064321.xml をアップロードし、その 6 時間後に my_jobs_20220816_124321.xml をアップロードすると、サーバーには次のように保存されます。
my_jobs_20220816_064321.xml/20220816_064353.xmlmy_jobs_20220816_124321.xml/20220816_124403.xml
ファイル拡張子を含めてください。現在、Indeed が処理するのは XML ファイルのみであるため、すべてのファイルを XML として扱いますが、将来は他のファイル形式に対応する可能性があります。
- 正しいファイル名:
my_jobs.XMLINDEED_jobs.xml
- 誤ったファイル名:
MY_JOBSINDEED_JOBS_XML