Show Menu
主题×

Adobe Experience PlatformAPI基础知识

Adobe Experience PlatformAPI采用若干基础技术和语法,这些技术和语法对于有效管理基于JSON的资源非常重要。 Platform 本文档简要概述了这些技术,并提供了指向外部文档的链接以了解更多信息。

JSON指针

JSON指针是用于标识JSON文档中特 定值的标准字符串语法 (RFC 6901)。 JSON指针是由字符分隔的标记 / 字符串,它指定对象键或数组索引,标记可以是字符串或数字。 JSON指针字符串用于API的许多PATCH Platform 操作,如本文档后面所述。 有关JSON指针的详细信息,请参阅JSON 指针概述文档

JSON模式对象示例

{
    "type": "object",
    "title": "Loyalty Member Details",
    "meta:intendedToExtend": [
        "https://ns.adobe.com/xdm/context/profile"
    ],
    "description": "Loyalty Program Mixin.",
    "definitions": {
        "loyalty": {
            "properties": {
                "_{TENANT_ID}": {
                    "type": "object",
                    "properties": {
                        "loyaltyId": {
                            "title": "Loyalty Identifier",
                            "type": "string",
                            "description": "Loyalty Identifier.",
                            "meta:xdmType": "string"
                        },
                        "loyaltyLevel": {
                            "title": "Loyalty Level",
                            "description": "The current loyalty program level to which the individual member belongs.",
                            "type": "string",
                            "enum": [
                                "platinum",
                                "gold",
                                "silver",
                                "bronze"
                            ],
                            "meta:enum": {
                                "platinum": "Platinum",
                                "gold": "Gold",
                                "silver": "Silver",
                                "bronze": "Bronze"
                            },
                            "meta:xdmType": "string"
                        }
                    },
                    "meta:xdmType": "object"
                }
            },
            "type": "object",
            "meta:xdmType": "object"
        }
    }
}

基于模式对象的JSON指针示例

JSON指针
解析为
"/title"
“忠诚会员详细信息”
"/definitions/loyalty"
(返回对象的内 loyalty 容)
"/definitions/loyalty/properties/_{TENANT_ID}/properties/loyaltyLevel/enum"
["platinum", "gold", "silver", "bronze"]
"/definitions/loyalty/properties/_{TENANT_ID}/properties/loyaltyLevel/enum/0"
"platinum"
处理(XDM)描 xdm:sourceProperty 述符 xdm:destinationProperty 的和属 Experience Data Model 性时,必须从JSON指 properties 针字符串 中排除任 何键。 有关详 Schema Registry 细信息,请参阅描述符的API开 发人 员指南子指南。

JSON修补程序

API有许多PATCH操作, Platform 它们接受JSON修补程序对象的请求负载。 JSON修补程序是用于描述对JSON 文档所做更改的标准化格式 (RFC 6902)。 它允许您定义JSON的部分更新,无需在请求主体中发送整个文档。

JSON修补程序对象示例

{
  "op": "remove",
  "path": "/foo"
}

  • op :修补操作的类型。 虽然JSON修补程序支持多种不同的操作类型,但API中的所有PATCH操 Platform 作并非都与每种操作类型兼容。 可用的操作类型有:
    • add
    • remove
    • replace
    • copy
    • move
    • test
  • path :要更新的JSON结构部分,使用JSON指针 表示法标 识。
JSON Patch对象可能需 op 要其他属性,具体取决于中所示的操作类型。 有关不同JSON修补程序操作及其所需语法的详细信息,请参阅JSON 修补程序文档

JSON模式

JSON模式是一种用于描述和验证JSON数据结构的格式。 体验模式模型 (XDM)利用JSON功能对所摄取的客户体验数据的结构和格式实施限制。 有关JSON模式的更多信息,请参阅 官方文档

后续步骤

此文档引入了与为管理基于JSON的资源相关的一些技术和语法 Experience Platform。 有关使用API的更多信 Platform 息(包括最佳实践和常见问题解答),请参阅平台疑 难解答指南