此 Schema Registry 可用來存取Adobe Experience Platform中的結構資料庫,提供使用者介面和RESTful API,供您存取所有可用的程式庫資源。
Schema Registry API提供數個端點,可讓您以程式設計方式管理Platform中可用的所有結構和相關Experience Data Model(XDM)資源。 這包括由Adobe定義, Experience Platform 您使用應用程式的合作夥伴和供應商。
這些端點概述如下。 如需詳細資訊,請參閱個別端點指南,並參閱 快速入門手冊 如需必要標題、讀取範例API呼叫等的重要資訊。
XDM使用JSON結構描述格式來說明和驗證擷取的客戶體驗資料結構。 使用結構註冊表API前,強烈建議您檢閱 官方JSON結構檔案 來更好地理解這個基礎技術。
若要檢視所有可用端點和CRUD作業,請造訪 結構註冊表API參考.
XDM結構表示並驗證匯入Platform的資料結構和格式。 架構由類和零個或多個架構欄位組組成。 您可以使用 /schemas
端點。 若要了解如何使用此端點,請參閱 schemas endpoint指南.
如需在Schema Registry API中手動建立完整架構(包括建立和新增欄位群組和資料類型)的逐步指南,請參閱 API結構建立教學課程.
如果您要擷取CSV資料,請參閱 從CSV轉換為結構.
行為定義架構描述的資料性質。 每個XDM類別都必須參考特定行為,採用該類別的所有結構都將繼承該行為。 請參閱 行為端點指南 了解如何在API中檢視可用行為。
類定義了基於該類的所有架構必須包含的公共屬性的基本結構,並確定了哪些欄位組有資格在這些架構中使用。 每個類都必須與現有行為相關聯。 請參閱 classes endpoint guide 以取得在API中使用類別的詳細資訊。
欄位群組是可重複使用的元件,可定義代表特定概念的一或多個欄位,例如個人、郵寄地址或網頁瀏覽器環境。 欄位組將作為實現相容類的架構的一部分,具體取決於它們所代表的資料(記錄或時間序列)的行為。 請參閱 欄位群組端點指南 了解如何使用API中的欄位群組。
在類或欄位組中,資料類型與基本常值欄位的使用方式相同,其主要區別在於資料類型可以定義多個子欄位。 雖然與中的欄位組類似,它們允許一致地使用多欄位結構,但資料類型更靈活,因為它們可以包含在架構結構中的任何位置,而欄位組只能在根級別添加。 請參閱 data types端點指南 以取得在API中使用資料類型的詳細資訊。
描述符是指派給架構內特定欄位的一組中繼資料,提供各種內容詳細資訊,包括這些欄位(和架構本身)如何與其他架構相關聯。 每個架構可以應用一個或多個描述符實體,並且有多種不同的描述符類型用於不同的用途。 請參閱 descriptors endpoint worke 有關在API中使用描述符的詳細資訊,以及不同描述符類型及其使用案例的概述。
雖然Platform可讓您針對特定使用案例撰寫結構,但也可讓您撰寫屬於特定類別之結構的「聯合」。 聯合架構會將共用相同類別之所有架構的欄位匯總為單一表示。 啟用結構以用於 即時客戶個人檔案,該架構會包含在其特定類別的聯合中。 因此,聯合結構無法直接編輯,而且只能受包含或排除結構以用於設定檔的影響。
若要了解如何在Schema Registry API中檢視聯合,請參閱 union endpoint指南.
您可以使用CSV檔案作為範本,自動產生XDM結構,以建立範本來大量匯入結構欄位,並減少手動API或UI的工作。
請參閱 CSV結構轉換端點指南 以取得更多資訊。
您也可以將UI用於 使用AI產生的建議將CSV對應至結構 (目前為測試版)。
「結構註冊表API」可讓您在沙箱與IMS組織之間傳輸和共用XDM資源。 對於任何架構、欄位組或資料類型,您可以生成包含資源結構和任何相依資源的導出裝載。 然後,此裝載可用來將資源匯入目的地沙箱和IMS組織。
請參閱 匯出端點指南 以取得如何為現有XDM資源建立匯出裝載的詳細資訊。
如果您使用 匯出 或 從CSV轉換為結構 端點來建立匯出裝載,您可以將該裝載傳送至目標組織和沙箱,以匯入指定的資源。
請參閱 匯入端點指南 以取得如何從匯出裝載產生XDM資源的詳細資訊。
您可以為架構庫內的任何指定架構產生範例資料。 然後,傳回的回應物件可作為資料擷取的來源。
請參閱 範例data端點指南 以獲取有關使用此終結點的詳細資訊。
Schema Registry會維護在不同更新之間對資源(類、欄位組、資料類型或架構)發生的所有更改的日誌。 您可以提供特定資源,以擷取其記錄檔 $id
或 meta:altId
在指向此端點的GET請求的路徑中。
請參閱 稽核記錄端點指南 以獲取有關使用此終結點的詳細資訊。
若要開始使用Schema Registry API進行呼叫,請閱讀 快速入門手冊 然後,選取其中一個端點指南,以了解如何使用特定端點。