基于过滤器检索所有作业

要根据任何指定的筛选器检索您的所有隐私作业数据,/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组完成时自动更新记录并提供报告或警报。 如果作业仍未完成,系统会通过GET请求来检索这些作业状态,并向Privacy ServiceAPI /jobs端点发出请求,同时提供列表的高级别更新。

如果特定作业仍处于挂起状态或返回了错误,则可以使用GET请求检索对/job/{jobId}端点的详细响应。

访问请求数据

当请求数据主体信息时,每个服务都以与其存储和使用数据方式一致的格式返回数据。 所有服务都完成请求后,作业详细信息中会提供一个.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错误是“请求过多”的结果。 有关如何解决此问题的更多信息,请参阅疑难解答指南的常见错误消息部分。