プライバシージョブステータスの監視
プライバシージョブを効果的に監視し、そのステータスを確認するために、Privacy Serviceでは 3 つの方法を提供しています。 利用可能な方法は、効率と生産性を監視する順序で以下に示します。 各方法には、エクスペリエンスを向上させるためのベストプラクティスガイドラインに続いて、すべてのアプローチを組み合わせた理想的なシナリオの例が含まれています。
リアルタイム通知を受信
I/O イベント は、ステータスイベントを通じて、ほぼリアルタイムのステータス監視を提供します。 これは、ポーリングメカニズムを実装する必要がなく、追加の API トラフィックが発生するので、最も効率的な方法です。
Recommendations:
- Webhook 設定： 送信されたジョブのステータスが変更されたときにプッシュ通知を受信する Webhook を設定します。 これにより、リアルタイムの監視が容易になります。
- 通知： ジョブと製品の両方のレベルで通知を使用して、リクエストの進行状況を監視するのに役立ちます。
Privacy Service通知のイベント登録のセットアップ手順と通知ペイロードの解釈方法については、Privacy Serviceイベントの登録に関するドキュメントを参照してください。
フィルターに基づくすべてのジョブの取得
指定したフィルターに基づいてすべてのプライバシージョブデータを取得するには、/jobs エンドポイントに対してGETリクエストを実行します。 この API 呼び出しは、1 回のリクエストで大量のジョブ ID の現在のジョブステータスの概要を表示する場合に役立ちます。 詳細な製品応答はありませんが、/jobs/{jobID} エンドポイントを使用して見つけることができます。
/jobs エンドポイントへのGETリクエストは、多数のジョブ ID のステータスデータを収集または比較するために最適ですが、通常のポーリングタイプのアクティビティ向けには ありません 使用できます。
Recommendations:
- クエリパラメーター： 特定のフィルターを使用して、結果を絞り込みます。例：データ範囲、規制タイプおよびステータス（処理中、完了など）。
組織内の現在のすべてのプライバシージョブのリストは、Privacy ServiceUI から表示できます。 ジョブリクエストリストをフィルタリングする方法については、UI ドキュメントのプライバシージョブの管理を参照してください。 または、Privacy ServiceAPI での/job エンドポイントの使用に関するドキュメントを参照してください。
使用可能なクエリパラメーターフィルターの詳細については、Privacy ServiceAPI ドキュメントを参照してください。
1 つのジョブに対する詳細な応答の取得
1 つのジョブに対する詳細な応答を取得するには、/jobs/{jobID} エンドポイントに対してGETリクエストを実行します。 この方法は、製品固有の応答や成功メッセージなど、より深い情報収集を目的としています。 このエンドポイントの呼び出しは、どの製品が応答し、どの製品がまだ保留中かを確認する最適な方法ですが、通常のポーリングアクティビティ向けでは ありません です。
特定のジョブのステータスを確認する方法について詳しくは、/jobs/{JOB_ID} エンドポイントのドキュメントを参照してください。
理想的なシナリオの例
Webhook を使用すると、システムはレコードを自動的に更新し、リクエストからの ID のグループが完了したときにレポートやアラートを提供できます。 ジョブがまだ未処理の場合、Privacy ServiceAPI /jobs エンドポイントへのGETリクエストを使用してこれらのジョブステータスが取得され、リストの大まかな更新が提供されます。
特定のジョブがまだ保留中であるか、エラーが返された場合は、/job/{jobId} エンドポイントへのGETリクエストを使用して詳細な応答を取得できます。
リクエストデータへのアクセス
データ主体の情報が要求されると、各サービスは、データの保存方法や使用方法に合った形式でデータを返します。 すべてのサービスがリクエストを完了すると、このデータをダウンロードできるように、ジョブの詳細に.ZIP アーカイブファイルの URL が指定されます。 プライバシージョブの結果をダウンロードする方法について詳しくは、トラブルシューティングガイドを参照してください。
データ・アーカイブの管理に関する重要事項を次に示します。
- すべてのアーカイブ・ファイルは、30 日後にExperience Platform・サーバから削除されます。 30 日を超える顧客データはクエリできません。
- アーカイブファイルの構造は、リクエストに含まれる製品毎のフォルダと、その中に含まれるデータファイルとを含む。 指定した ID のデータが見つからなかった場合、アーカイブファイルまたはフォルダーは空になることがあります。
- 以前作成したジョブのデータには、完了日から 30 日間のみアクセスできます。 その後、データがシステムから削除され、新しいリクエストを行う必要があります。
Recommendations:
- Protect データアーカイブ： URL ファイルと.ZIP ファイルには、データ主体の個人を特定できる情報（PII）が含まれている可能性があるので、どちらも保護する必要があります。
技術上の考慮事項
Privacy Serviceリクエストを行う際には、次の技術的な考慮事項に注意する必要があります。
- データ保持期間： ジョブのグループの最大ルックバック期間は 60 日で、クエリの最大期間は 30 日（開始日/終了日）です。
- ゲートウェイタイムアウト： 要求が 60 秒を超えると、ゲートウェイからドロップされる可能性があることに注意してください。
- エラー処理： エラーメッセージを十分に確認し、必要に応じてリクエストを再送信します。 Privacy Serviceは、エラーの後にジョブを自動的に再処理しません。
- HTTP 429 エラーについて： HTTP 429 エラーメッセージと、問題を軽減するために必要な手順について確認します。 HTTP 429 エラーは、「リクエストが多すぎます」が原因です。 問題の解決方法について詳しくは、トラブルシューティングガイドの 一般的なエラーメッセージの節を参照してください。
次の手順
このドキュメントを読むことで、Privacy Serviceを効率的かつ効果的に使用するために必要な知識とプラクティスを得ることができました。 次に、Privacy Serviceに関するよくある質問への回答と API でよく発生するエラーに関する情報については、 トラブルシューティングガイドを参照してください。