Union端點

聯合（或聯合視圖）是系統生成的只讀架構，用於聚合共用相同類（XDM ExperienceEvent或XDM Individual Profile）且為Real-time Customer Profile啟用的所有架構的欄位。

本檔案涵蓋在結構註冊表API中與工會合作的基本概念，包括各種作業的範例呼叫。有關XDM中聯合的更一般資訊，請參閱架構組成基礎中有關聯合的一節。

聯合架構欄位

Schema Registry會自動在聯合架構中包含三個鍵欄位：identityMap、timeSeriesEvents和segmentMembership。

身分對應

聯合架構的identityMap表示聯合的相關記錄架構內的已知身份。身分對應會將身分分割為由命名空間輸入的不同陣列。所列的每個身分本身都是包含唯一id值的物件。如需詳細資訊，請參閱Identity Service檔案。

時間序列事件

timeSeriesEvents陣列是與與聯合關聯的記錄架構相關的時間序列事件清單。將設定檔資料匯出至資料集時，每筆記錄都會包含此陣列。這對各種使用案例非常有用，例如機器學習，其中模型除了其記錄屬性外，還需要設定檔的整個行為歷史記錄。

區段成員資格對應

segmentMembership地圖會儲存區段評估的結果。使用分段API成功執行區段作業時，會更新對映。 segmentMembership 也會儲存擷取至Platform的任何預先評估對象區段，以便與Adobe Audience Manager等其他解決方案整合。如需詳細資訊，請參閱使用API建立區段的教學課程。

檢索聯合清單

在架構上設定union標籤時， Schema Registry會自動將架構添加到架構所基於類的聯合中。如果相關類不存在聯合，則會自動建立新聯合。聯合的$id與其他Schema Registry資源的標準$id類似，唯一的差異是由兩個底線附加，並加上"union"(__union)。

您可以向/tenant/unions端點提出GET請求，以查看可用聯合的清單。

API格式

GET /tenant/unions

要求

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed-id+json'

回應格式取決於要求中傳送的Accept標題。下列Accept標題可用於清單聯合：

`Accept` 標題	說明
`application/vnd.adobe.xed-id+json`	傳回每個資源的簡短摘要。這是列出資源的建議標題。 (限制：300)
`application/vnd.adobe.xed+json`	傳回每個資源的完整JSON類別，並包含原始的`$ref`和`allOf`。 (限制：300)

回應

成功的回應會傳回HTTP狀態200(OK)，以及回應內文中的results陣列。如果已定義聯合，則每個聯合的詳細資訊將作為陣列內的對象提供。如果未定義聯合，則仍會返回HTTP狀態200(OK)，但results陣列將為空。

{
    "results": [
        {
            "title": "XDM Individual Profile",
            "$id": "https://ns.adobe.com/xdm/context/profile__union",
            "meta:altId": "_xdm.context.profile__union",
            "version": "1"
        },
        {
            "title": "Property",
            "$id": "https://ns.adobe.com/{TENANT_ID}/classes/19e1d8b5098a7a76e2c10a81cbc99590__union",
            "meta:altId": "_{TENANT_ID}.classes.19e1d8b5098a7a76e2c10a81cbc99590__union",
            "version": "1"
        }
    ]
}

查找工會

您可以執行包含$id的GET請求，並根據Accept標題查看聯合的部分或全部詳細資訊，以查看特定聯合。

注意

聯集查閱可使用/unions和/schemas端點，以便在Profile匯出至資料集時使用。

API格式

GET /tenant/unions/{UNION_ID}
GET /tenant/schemas/{UNION_ID}

參數	說明
`{UNION_ID}`	要查找的聯合的URL編碼的`$id` URI。聯合架構的URI會附加「__union」。

要求

curl -X GET \
  https://platform.adobe.io/data/foundation/schemaregistry/tenant/unions/https%3A%2F%2Fns.adobe.com%2Fxdm%2Fcontext%2Fprofile__union \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Accept: application/vnd.adobe.xed+json; version=1'

聯合查詢請求需要在Accept標題中包含version。

下列「接受」標題適用於聯合架構查閱：

Accept	說明
`application/vnd.adobe.xed+json; version=1`	具有`$ref`和`allOf`的原始。包含標題和說明。
`application/vnd.adobe.xed-full+json; version=1`	`$ref` 屬性和已 `allOf` 解析。包含標題和說明。

回應

成功的回應會傳回實作要求路徑中提供$id類別之所有結構的聯合檢視。

回應格式取決於要求中傳送的Accept標題。嘗試不同的「接受」標題來比較回應，並判斷哪個標題最適合您的使用案例。

{
    "type": "object",
    "description": "Union view of all schemas that extend https://ns.adobe.com/xdm/context/profile",
    "allOf": [
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile-person-details"
        },
        {
            "$ref": "https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599"
        },
        {
            "$ref": "https://ns.adobe.com/xdm/context/profile-personal-details"
        }
    ],
    "meta:extends": [
        "https://ns.adobe.com/xdm/context/profile",
        "https://ns.adobe.com/xdm/data/record",
        "https://ns.adobe.com/xdm/context/identitymap",
        "https://ns.adobe.com/xdm/common/extensible",
        "https://ns.adobe.com/xdm/common/auditable",
        "https://ns.adobe.com/xdm/context/profile-person-details",
        "https://ns.adobe.com/{TENANT_ID}/mixins/477bb01d7125b015b4feba7bccc2e599",
        "https://ns.adobe.com/xdm/context/profile-personal-details"
    ],
    "title": "Union object for https://ns.adobe.com/xdm/context/profile",
    "$id": "https://ns.adobe.com/xdm/context/profile__union",
    "meta:containerId": "tenant",
    "meta:class": "https://ns.adobe.com/xdm/context/profile",
    "meta:altId": "_xdm.context.profile__union",
    "version": "1.0",
    "meta:resourceType": "unions",
    "meta:registryMetadata": {}
}

啟用聯合成員資格的結構

若要將架構納入其類別的聯合中，必須將union標籤新增至架構的meta:immutableTags屬性。您可以發出PATCH要求，將單字串值union的meta:immutableTags陣列新增至相關架構，以達到此目的。如需詳細範例，請參閱綱要端點指南。

列出聯合的結構

若要查看哪些結構屬於特定聯合的一部分，您可以對/tenant/schemas端點執行GET請求。使用property查詢參數，可以將響應配置為僅返回包含meta:immutableTags欄位和meta:class等於您正在訪問其聯合的類的架構。

API格式

GET /tenant/schemas?property=meta:immutableTags==union&property=meta:class=={CLASS_ID}

參數	說明
`{CLASS_ID}`	要列出其聯合啟用架構的類的`$id`。

要求

下列請求會擷取屬於XDM Individual Profile類別聯合的所有結構清單。

curl -X GET \
  'https://platform.adobe.io/data/foundation/schemaregistry/tenant/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile' \
  -H 'Accept: application/vnd.adobe.xed-id+json' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

回應格式取決於要求中傳送的Accept標題。下列Accept標題可用於列出結構：

`Accept` 標題	說明
`application/vnd.adobe.xed-id+json`	傳回每個資源的簡短摘要。這是列出資源的建議標題。 (限制：300)
`application/vnd.adobe.xed+json`	傳回每個資源的完整JSON結構，並包含原始的`$ref`和`allOf`。 (限制：300)

回應

成功的響應返回一個已篩選的架構清單，該清單僅包含屬於已啟用聯合成員資格的指定類的架構。請記住，使用多個查詢參數時，會假設為AND關係。

{
    "results": [
        {
            "title": "Schema 1",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/142afb78d8b368a5ba97a6cc8fc7e033",
            "meta:altId": "_{TENANT_ID}.schemas.142afb78d8b368a5ba97a6cc8fc7e033",
            "version": "1.2"
        },
        {
            "title": "Schema 2",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/e7297a6ddfc7812ab3a7b504a1ab98da",
            "meta:altId": "_{TENANT_ID}.schemas.e7297a6ddfc7812ab3a7b504a1ab98da",
            "version": "1.5"
        },
        {
            "title": "Schema 3",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/50f960bb810e99a21737254866a477bf",
            "meta:altId": "_{TENANT_ID}.schemas.50f960bb810e99a21737254866a477bf",
            "version": "1.2"
        },
        {
            "title": "Schema 4",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/a39655ca8ea3d5c1f36a463b45fccca8",
            "meta:altId": "_{TENANT_ID}.schemas.a39655ca8ea3d5c1f36a463b45fccca8",
            "version": "1.1"
        },
        {
            "title": "Schema 5",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/c063fac45c6d6285ef33b0e2af09f633",
            "meta:altId": "_{TENANT_ID}.schemas.c063fac45c6d6285ef33b0e2af09f633",
            "version": "1.2"
        },
        {
            "title": "Schema 6",
            "$id": "https://ns.adobe.com/{TENANT_ID}/schemas/dfebb19b93827b70bbad006137812537",
            "meta:altId": "_{TENANT_ID}.schemas.dfebb19b93827b70bbad006137812537",
            "version": "1.7"
        }
    ],
    "_links": {
        "global_schemas": {
            "href": "https://platform.adobe.io/data/foundation/schemaregistry/global/schemas?property=meta:immutableTags==union&property=meta:class==https://ns.adobe.com/xdm/context/profile"
        }
    }
}

adobe.com 上的資源

Multichannel Communication Targeted Content Triggered Emails Tag Management Audience Targeting Mobile Marketing

Union端點

聯合架構欄位

身分對應

時間序列事件

區段成員資格對應

檢索聯合清單

查找工會

啟用聯合成員資格的結構

列出聯合的結構

adobe.com 上的資源

本頁內容

檢視下一個:

學習

說明文件

社群

技術支援

資源

Adobe 帳戶

Adobe