文档 Experience Platform Privacy Service 指南

验证并访问 Privacy Service API

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

本指南介绍了在尝试调用Adobe Experience Platform Privacy Service API之前必须了解的核心概念。

先决条件 prerequisites

本指南需要您对Privacy Service以及它如何允许您跨Adobe Experience Cloud应用程序管理来自数据主体（客户）的访问和删除请求有一定的了解。

为了创建API的访问凭据，贵组织中的管理员以前必须设置产品配置文件以在Adobe Admin Console中Privacy Service。您分配给API集成的产品配置文件决定了集成在访问Privacy Service功能时具有的权限。有关详细信息，请参阅管理Privacy Service权限指南。

收集所需标头的值 gather-values-required-headers

要调用Privacy ServiceAPI，您必须首先收集要在所需标头中使用的访问凭据：

Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}

这些值是使用Adobe Developer Console生成的。您的{ORG_ID}和{API_KEY}只需生成一次，可在以后的API调用中重复使用。但是，您的{ACCESS_TOKEN}是临时的，必须每24小时重新生成一次。

下面详细介绍了生成这些值的步骤。

一次性设置 one-time-setup

转到Adobe Developer Console并使用您的Adobe ID登录。接下来，按照Developer Console文档中有关创建空项目的教程中概述的步骤进行操作。

创建新项目后，选择 添加到项目，然后从下拉菜单中选择 API。

从Developer Console中项目详细信息页面的添加到项目下拉列表中选择API选项

选择Privacy ServiceAPI select-privacy-service-api

出现 添加API 屏幕。选择 Experience Cloud 以缩小可用API的列表，然后选择 Privacy ServiceAPI 的卡片，然后再选择 下一步。

正在从可用API列表中选择的Privacy ServiceAPI卡

TIP

选择 查看文档 选项可在单独的浏览器窗口中导航到完整的Privacy ServiceAPI参考文档。

接下来，选择身份验证类型以生成访问令牌并访问Privacy ServiceAPI。

IMPORTANT

选择 OAuth服务器到服务器 方法，因为这将是今后唯一支持的方法。已弃用 服务帐户(JWT) 方法。虽然使用JWT身份验证方法的集成将继续工作到2025年1月1日，但Adobe强烈建议您在该日期之前将现有集成迁移到新的OAuth服务器到服务器方法。在[Deprecated]{class="badge informative"}部分获取更多信息{type=negative}生成JSON Web令牌(JWT)。

选择Oauth服务器到服务器身份验证方法。