根據篩選器擷取所有工作

若要根據任何指定的篩選器擷取您的所有隱私權工作資料,請對/jobs端點 ​執行GET要求。 此API呼叫有助於提供大型工作ID集之目前工作狀態的高層級檢視,且只有單一請求。 它確實沒有詳細的產品回應,但可以使用/jobs/{jobID}端點找到它們。

/jobs端點的GET要求最適合用來收集或比較大量工作ID的狀態資料,但​ 不是 ​用於一般輪詢型別活動。

Recommendations:

  • 查詢引數: ​使用特定篩選器來縮小結果的範圍,例如:資料範圍、規則型別和狀態(處理、完成等)。

您可以透過Privacy ServiceUI檢視貴組織中所有目前隱私權工作的清單。 有關如何篩選工作請求清單的資訊,請參閱UI檔案🔗中的管理隱私權工作。 或者,請參閱有關Privacy ServiceAPI中使用/job端點的檔案。

Privacy ServiceAPI檔案包含有關可用的查詢引數篩選器的詳細資料。

擷取單一作業的詳細回應

若要擷取單一作業的詳細回應,請對/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中常見錯誤的資訊。