SFTP サーバーガイドライン
Aggregation SFTP Server を使用するためのガイドライン。
- この API とそのドキュメントを使用し、連携を構築することで、追加の API 利用規約およびガイドラインに同意したものとみなされます。
はじめに
Indeed の SFTP サーバーは、クライアントが XML ファイルを Indeed にアップロードできる共有リソースです。クライアントが XML ファイルをアップロードすると、Indeed はそのファイルを処理し、求人が当社のウェブサイトに表示されるようにします。
SFTP サーバーは共有リソースであるため、すべてのクライアントがこれらのガイドラインに従う必要があります。これらのガイドラインは、Indeed が XML ファイルを期限どおりに処理し、求人が Indeed に掲載されることに役立ちます。クライアントがこれらのガイドラインに従わない場合、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 日間残り、その後 Indeed が削除します。
ステップ 3. アップロード頻度を決定する
アップロード頻度を決めるには、時間ベースと XML 内の重要な変更ベースの 2 つのカテゴリのいずれかを使用してください。
時間ベース:
- ガイドライン: 6 時間ごと
- アップロード間の最小時間: 2 時間
重要な変更ベース:
- ガイドライン：求人の 1% 以上が変更されたときに更新する。
多数の求人の URL を変更しても、重要な変更とは見なされません。
Indeed の目標は、求職者に対して可能な限り正確でタイムリーな求人更新を提供することです。ただし、求人が Indeed.com に表示されるまでには複数のステップがあります。小さな変更を加えて 15 分ごとにアップロードしても、求人がより早く表示されるわけではありません。求人が表示される前に、Indeed は XML ファイル全体を再処理する必要があり、その後も求人は 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