Schema Registry API指南

Schema Registry用于访问Adobe Experience Platform中的架构库,提供一个用户界面和RESTful API,所有可用库资源都可通过该API访问。

架构注册表API提供了多个端点,允许您以编程方式管理Platform中可供您使用的所有架构和相关体验数据模型(XDM)资源。 这包括Adobe、Experience Platform合作伙伴以及您使用其应用程序的供应商所定义的那些合作伙伴。

这些端点概述如下。 有关详细信息,请访问各个端点指南,请参阅快速入门指南,了解有关所需标头、读取示例API调用等的重要信息。

IMPORTANT
XDM使用JSON架构格式来描述和验证所摄取的客户体验数据的结构。 在使用架构注册表API之前,强烈建议您查看官方JSON架构文档,以更好地了解此基础技术。

要查看所有可用的端点和CRUD操作,请访问架构注册表API引用

架构

XDM架构表示并验证引入到Platform中的数据结构和格式。 架构由一个类以及零个或多个架构字段组组成。 您可以使用/schemas端点创建、查看、编辑和删除架构。 要了解如何使用此端点,请参阅架构端点指南

有关如何在架构注册表API中手动创建完整架构(包括创建和添加字段组和数据类型)的分步指南,请参阅API架构创建教程

如果您正在摄取CSV数据,请参阅CSV到架构的转换部分。

行为

行为定义架构描述的数据的性质。 每个XDM类都必须引用一个特定行为,使用该类的所有架构都将继承该行为。 请参阅行为端点指南,了解如何查看API中的可用行为。

分类

类定义了基于该类的所有架构都必须包含的公共属性的基本结构,并确定哪些字段组适合在这些架构中使用。 每个类都必须与现有行为关联。 有关在API中使用类的详细信息,请参阅类终结点指南

字段组

字段组是可重复使用的组件,它们定义表示特定概念的一个或多个字段,例如个人、邮寄地址或Web浏览器环境。 字段组旨在作为实现兼容类的架构的一部分包含,具体取决于它们表示的数据的行为(记录或时间序列)。 请参阅字段组端点指南,了解如何在API中使用字段组。

数据类型

数据类型在类或字段组中用作引用类型字段的方式与基本文本字段相同,主要区别在于数据类型可以定义多个子字段。 虽然与字段组类似,它们允许一致地使用多字段结构,但数据类型更加灵活,因为它们可以包含在架构结构中的任意位置,而字段组只能在根级别添加。 有关在API中使用数据类型的详细信息,请参阅数据类型端点指南

NOTE
如果字段被定义为特定数据类型,则无法在另一个架构中创建具有不同数据类型的相同字段。 此限制适用于您组织的租户。

描述符

描述符是分配给架构中特定字段的元数据集,提供各种上下文详细信息,包括这些字段(以及架构本身)如何与其他架构相关联。 每个架构可以应用一个或多个描述符实体,并且有多种不同的描述符类型用于不同的目的。 有关在API中使用描述符的更多信息,以及不同描述符类型及其用例的概述,请参阅描述符端点指南

联合

虽然Platform允许您针对特定用例编写架构,但它还允许您编写属于特定类的架构的“联合”。 合并架构将共享相同类的所有架构的字段聚合到单个表示中。 通过启用用于实时客户个人资料的架构,该架构将包含在其特定类的联合中。 因此,不能直接编辑合并架构,并且只能受包含或排除用于配置文件中的架构的影响。

要了解如何在架构注册表API中查看联合,请参阅联合端点指南

CSV到架构的转换 csv-to-schema

您可以使用CSV文件作为模板自动生成XDM架构,从而创建模板以批量导入架构字段并减少手动API或用户界面工作。

有关详细信息,请参阅CSV到架构转换终结点指南

NOTE
您还可以使用UI以使用AI生成的推荐🔗(当前为测试版)将CSV映射到架构。

导出 export

架构注册API允许您在沙盒和组织之间传输和共享XDM资源。 对于任何架构、字段组或数据类型,可生成包含资源结构和任何依赖资源的导出有效负载。 然后,此有效负载可用于将资源导入目标沙盒和组织。

有关如何为现有XDM资源创建导出有效负载的更多信息,请参阅导出端点指南

导入

如果您使用exportCSV到架构的转换端点创建导出有效负载,您可以将该有效负载发送到目标组织和沙盒以导入指定的资源。

有关如何从导出负载生成XDM资源的详细信息,请参阅导入终结点指南

样本数据

您可以为架构库中的任何指定架构生成示例数据。 然后,返回的响应对象可用作数据摄取的源。

有关使用此端点的详细信息,请参阅示例数据端点指南

审核日志

架构注册表维护在不同更新之间对资源(类、字段组、数据类型或架构)发生的所有更改的日志。 您可以通过在指向此终结点的GET请求路径中提供特定资源的$idmeta:altId来检索该日志。

有关使用此端点的详细信息,请参阅审核日志端点指南

后续步骤

若要开始使用架构注册表API进行调用,请阅读快速入门指南,然后选择其中一个端点指南,以了解如何使用特定端点。

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07