Policy Service API入门

Policy Service API允许您创建和管理与Adobe Experience Platform Data Governance相关的各种资源。 本文档介绍了在尝试调用Policy Service API之前需要了解的核心概念。

先决条件

使用开发人员指南需要了解使用数据管理功能时涉及的各种Experience Platform服务。 在开始使用Policy Service API之前,请查看以下服务的文档:

  • Data Governance:强制执行数据使 Experience Platform 用合规性的框架。
  • Experience Data Model (XDM) System:组织客户体验数 Experience Platform 据的标准化框架。
  • Real-time Customer Profile:根据来自多个来源的汇总数据提供统一、实时的消费者用户档案。
  • 沙箱: Experience Platform 提供将单个实例分区为单 Platform 独虚拟环境的虚拟沙箱,以帮助开发和发展数字体验应用程序。

读取示例API调用

Policy Service API文档提供示例API调用,以演示如何设置请求的格式。 这包括路径、必需的标头和格式正确的请求负载。 还提供API响应中返回的示例JSON。 有关示例API调用文档中使用的约定的信息,请参阅Experience Platform疑难解答指南中关于如何读取示例API调用🔗的部分。

所需的标题

API文档还要求您已完成身份验证教程,以便成功调用Platform端点。 完成身份验证教程后,将为Experience Platform API调用中每个所需标头提供值,如下所示:

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

Experience Platform中的所有资源(包括属于Data Governance的资源)都隔离到特定虚拟沙箱。 对Platform API的所有请求都需要一个头,该头指定操作将在中执行的沙箱的名称:

  • x-sandbox-name: {SANDBOX_NAME}
注意

有关Platform中沙箱的详细信息,请参阅沙箱概述文档

所有包含有效负荷(POST、PUT、PATCH)的请求都需要额外的标头:

  • Content-Type: application/json

核心与自定义资源

在Policy Service API中,所有策略和营销操作称为corecustom资源。

core 资源是由Adobe定义和维护的资 custom 源,而资源是由您的组织创建和维护的资源,因此仅对您的IMS组织是独特和可见的。因此,列表和查找操作(GET)是允许对core资源执行的唯一操作,而列表、查找和更新操作(POSTPUTPATCHDELETE)可用于custom资源。

后续步骤

要开始使用策略服务API进行调用,请选择可用的终结点指南之一。

在此页面上