SFTP サーバーガイドライン
Aggregation SFTP Server を使用するためのガイドライン。
- このAPIおよびそのドキュメントを使用し、統合を構築することで、追加のAPI利用規約およびガイドラインに同意したものとみなされます。
はじめに
Indeed の SFTP サーバーは、クライアントが XML ファイルを Indeed にアップロードできる共有リソースです。クライアントが XML ファイルをアップロードすると、Indeed はファイルを処理し、求人を Indeed のウェブサイトに表示します。
SFTP サーバーは共有リソースであるため、すべてのクライアントが次のガイドラインに従うことが重要です。これらのガイドラインに従うことで、Indeed はすべての XML ファイルをタイムリーに処理でき、すべての求人を Indeed に投稿できます。クライアントがこれらのガイドラインに違反した場合、サーバーへのアクセス権が取り消される可能性があります。
ステップ 1. 必要最小限の接続数を使用する
Indeed では、DDoS 攻撃を緩和するために接続数を制限しています。すべてのクライアントがファイルを正常にアップロードできるよう、接続数は必要最小限にしてください。
理想的には、各クライアントは 1 つの接続のみを使用してください。一部のクライアントが複数のファイルを同時にアップロードする際 に複数の接続を使用する可能性があることを、Indeed は把握しています。SFTP プロトコルを使用すると、1 つの接続で複数の操作を多重化できます。これにより、クライアントは 1 つの接続で複数の異なる操作を完了できます。
ステップ 2. 元のファイル名のままファイルをアップロードする
Indeed は、アップロードされた元のファイル名のままファイルの処理を開始します。ファイル名を変更すると、処理時間が最大 10 分遅れることがあります。
次のことは行わないでください。
- ファイルのアップロード後にファイル名を変更する。
- ファイルのアップロード後に削除する。
- 更新時刻や権限など、ファイルのメタデータを操作する。
- ファイルの状態を継続的にクエリ／ポーリングする。
Indeed では、ご使用のディレクトリ内の processed サブディレクトリに 2 日間のルックバックを提供しています。このルックバックにより、ファイルが正常にアップロードされたかどうかを確認できます。
例：2022 年 7 月 19 日 10:31:00（中部夏時間）にファイルが ftp/ftpexample123/file.xml にアップロードされた場合、Indeed は ftp/ftpexample123/processed/file.xml/20220719_103100_CDT.xml に空のファイルを アップロードします。このファイルを、アップロードと処理中であることの確認として使用してください。このファイルは 2 日間保持された後、削除されます。
ステップ 3. アップロード頻度を決定する
アップロード頻度の決定には、時間ベースと XML 内の重要な変更ベースの 2 つのカテゴリを使用できます。
時間ベース：
- ガイドライン：6 時間ごと
- アップロード間隔の最小値：2 時間
重要な変更ベース：
- ガイドライン：求人の 1% 以上が変更されたときに更新する。
多数の求人の URL を変更しても、重要な変更とは見なされません。
Indeed の目標は、求職者に対してできるだけ正確かつタイムリーな求人更新を提供することです。ただし、求人が Indeed.com に表示されるまでには、いくつかのステップがあります。15 分ごとに小さな変更でアップロードしても、求人が早く表示されるわけではありません。求人が表示される前に、Indeed は XML ファイル全体を再処理する必要があり、その求人は Indeed のジョブパイプラインの残りのステップを通過する必要があります。Indeed のシステムは、頻繁にアップロードを行うアカウントを制限し、3 時間ごとにのみ更新を取り込むよう構成されています（この値は変更される可能性があります）。
ステップ 4. 必要なファイルのみアップロードする
各ファイルのアップロード後、Indeed はファイル名を確認して、そのファイル名を処理できるかどうかを判定します。Indeed が処理方法を認識していないファイル名の場合は、不要なファイル名と見なして、アクセスできないディレクトリに移動します。
不要なファイルをアップロードすると、システムに余分な負荷がかかり、重要なファイルの処理に支障が出ます。
必要に応じて、Indeed はアップロードされたファイルをクエリし、処理されていないファイルを確認できます。
ステップ 5. 命名規則に従う
ステップ 5.1. アップロードごとに同じファイル名を維持する
ファイルの管理を容易にするため、アップロード間で一貫したファイル名を使用してください（例：my_jobs.xml）。
SFTP サーバーは、変更点が日時のみである限り、アップロード間でファイル名が変わっても処理できます。
たとえば、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
ステップ 5.2. ファイル拡張子を含める
現在、Indeed では XML ファイルのみを処理するため、すべてのファイルは XML ファイルと見なされます。将来的に Indeed が他のファイル形式を処理する可能性があります。今後の問題を減らすため、ファイル拡張子を含めてください。
誤ったファイル名の例：
MY_JOBS
INDEED_JOBS_XML
正しいファイル名の例：
my_jobs.XML
INDEED_jobs.xml