[AEM Assets]{class="badge positive" title="適用於AEM Assets)。"}
具有 OpenAPI 功能的 Dynamic Media 常見問題 new-dynaminc-media-apis-frequently-asked-questions
Dynamic Media具有 OpenAPI (開放式應用程式設計介面) 功能,可透過標準化的開發人員友善API端點,傳送、轉換及管理豐富媒體資產(影像、視訊及其他視覺內容)。 此常見問題指南會回答關於這些功能如何運作、其啟用什麼以及如何採用這些功能的最常見問題。
什麼是Dynamic Media具有OpenAPI功能? what-are-dynamic-media-openapi-capabilities
Dynamic Media是一組媒體交付和轉換服務,可自動最佳化、調整任何裝置、頻道或畫面的資產大小及轉譯資產。 OpenAPI功能透過開放、完整記錄的API規格來公開這些服務,讓開發人員可以將媒體傳遞直接整合到他們自己的應用程式、店面和內容體驗中。
因為介面遵循OpenAPI標準,所以是自我說明且可預測的。 因此,整合團隊可以發現可用的端點、瞭解請求和回應格式,並比使用專有的、未記載的介面更快地產生使用者端代碼。
主要優點 key-benefits
Dynamic Media與OpenAPI功能的主要優點包括:
- 標準化整合:符合OpenAPI規範的端點可讓媒體服務直接連線到現有的應用程式和工具鏈。
- 隨選媒體轉換: Assets在要求時最佳化、調整大小及重新格式化,不需要儲存多個手動變體。
- 多管道傳送:單一資產可以透過網路、行動裝置和連線的體驗來傳送和調整。
- Headless就緒架構: API優先傳送與Headless及可撰寫的技術棧疊一致。
- 更快開發:自我說明規格可加速整合團隊的上線、使用者端程式碼產生和測試。
Dynamic Media OpenAPI功能可以做什麼? what-can-i-do
您可以要求媒體資產、套用即時轉換(例如裁切、調整大小和格式轉換),以及將最佳化內容傳送至網路、行動裝置和連線的體驗 — 所有這些都透過標準化的API呼叫完成。
OpenAPI功能與傳統Dynamic Media傳送有何不同? openapi-vs-traditional
傳統傳遞方式需仰賴預設的URL模式和範本。 OpenAPI功能新增了標準化的程式化介面,使自動化、自訂整合和Headless (分離式前端)架構更容易實施。
這些功能是否適用於Headless與可撰寫的架構? headless-composable
可以。 因為媒體是透過API (而非固定頁面範本)擷取和轉換,Dynamic Media OpenAPI功能自然適合於Headless內容管理和可撰寫的商務設定,在這裡,展示層與內容和服務分開。
我需要開發人員資源才能使用這些功能嗎? developer-resources
API型整合通常涉及開發人員將端點連線至應用程式。 不過,OpenAPI規格透過提供一致、機器可讀的定義(支援自動化使用者端產生和測試)來減少這項工作量。
Experience Manager Assets as a Cloud Service 存放庫中的所有資產是否都能使用具有 OpenAPI 功能的 Dynamic Media 進行搜尋和傳遞? assets-available-for-search
否。 使用 具有OpenAPI功能的Dynamic Media 時,只有 已核准和最新版本的資產 可供搜尋和傳遞。 尚未核准或僅存在於舊版修訂的Assets會從此搜尋與傳送範圍中排除。
兩個條件控管Experience Manager Assets as a Cloud Service存放庫中的資產是否出現:
- 核准狀態 — 資產必須標籤為已核准。 仍在草稿中或等待稽核的Assets不會公開以供搜尋和傳遞。
- 版本貨幣 — 只有核准資產的 最新版本 才適用。 系統不會傳回取代或歷史版本。
此範圍設定是有意為之。 因為只有已核准、目前資產符合資格,所以傳遞僅限於通過治理檢閱的內容,這可確保所有管道和應用程式的品牌一致性。 因此,透過Dynamic Media使用OpenAPI功能使用資產的下游體驗會可靠地參考經過審查的最新內容,而不是未經核准或過時的修訂版本。
管理員如何將新增至資料夾的新資產和現有資產標記為已核准? add-assets-to-folder-as-approved
管理員會設定資料夾進行大量核准,然後重新處理任何預先存在的資產,以將資料夾中的新資產和現有資產標籤為已核准。 在Adobe Experience Manager (AEM) Assets中,資產的狀態是由 jcr:content/metadata/dam:status 屬性所控管。 此屬性可控制是否將資產視為整個資產庫中的可用、已封鎖或待修訂專案。
此屬性的值為:
-
已核准 — 資產已驗證且可供使用,並在資產卡上以已核准圖示標幟。
-
已拒絕 — 資產已封鎖,且已以已拒絕的指標標幟。
-
要求的變更 — 資產需要修訂,而且處理方式與拒絕的資產相同。
AEM Assets會使用資產卡上可用的已核准圖示來區分 已核准 狀態,如下圖管理員和資產檢視所示:
管理員視圖
資產視圖
若要核准資料夾中的所有資產,請參閱如何大量核准資料夾中的資產相關指示。 還有一段影片說明整個過程。
設定用於大量核准的資料夾後,所有新增至該資料夾的新資產都會自動獲得核准。 這可確保資料夾的核准狀態一致,無需手動稽核每次新上傳。 所有現有資產只有在重新處理後才核准,因為重新處理會針對資料夾的大量核准設定重新評估dam:status屬性。 請參閱重新處理數位資產以了解有關如何重新處理資產的指示。 如果管理員從任何其他資料夾複製或移動未核准的資產,他們必須重新處理資產,以便移動的資產繼承核准狀態。
每當管理員指定 Rejected 或 Changes requested 值時,AEM Assets就會將資產標示為Rejected,因為這兩個值都代表未核准的狀態。 AEM Assets會使用「管理員」檢視中資產卡上可用的
同樣地,AEM Assets會使用資產卡上的下列已拒絕狀態,在Assets檢視中區分「已拒絕」狀態:
如何取得 Adobe IMS (Adobe Identity Management Services) 使用者或群組 ID,以便在 Experience Manager 管理員視圖中設定資產角色,以確保傳遞和搜尋體驗? set-roles-secure-delivery-search
Adobe IMS (Adobe Identity Management Services)使用者和群組ID是從Adobe的 Admin Console 擷取,並套用至Experience Manager Assets Admin view,以設定可保護傳遞和搜尋體驗的角色。 根據這些IMS使用者或群組ID指派角色,可確保只有授權的身分才能存取、傳遞或搜尋特定資產。 由於資產層級的存取是由這些身分所控管,因此使用正確的IMS ID是Experience Manager中角色型安全性的基礎步驟。
需要存取 Experience Manager Author 環境的使用者在Adobe的 Admin Console 中被管理為Adobe IMS使用者。 如需有關何謂 Adobe IMS 使用者,以及如何在 Admin Console 中加以存取和管理的資訊,請參閱 Adobe IMS 使用者。
IMS身分如何對應到資產角色:
- Adobe IMS使用者代表在Adobe的 Admin Console 中集中布建和管理的人員,可為Adobe Experience Cloud應用程式中的身分提供單一信任來源。
- Adobe IMS群組允許將多個使用者一起管理,因此角色和許可權可以一致地套用至一個群組,而不是分別套用至每個使用者。
- 從Admin Console取得的 使用者ID 或 群組ID 是在設定資產上的角色、將傳遞和搜尋許可權直接繫結至已知的受管理身分時參考的值。
由於傳送和搜尋體驗是由資產上設定的角色所控管,因此從Admin Console擷取正確的Adobe IMS使用者或群組ID至關重要。 此方法可集中管理身分、降低未經授權存取資產的風險,並維持許可權與整個Adobe環境中已管理身分的方式一致。
可以同時核准一個資料夾內的多項資產嗎? approve-multiple-assets-in-folder
可以。 Adobe Experience Manager (AEM) Assets可讓使用者同時核准資料夾中的多個資產,而不需個別核准每個檔案。 大量核准可簡化檢閱工作流程,並可在管理大型資產庫時節省相當長的時間,因為 已核准 檢閱狀態會套用至單一動作中選取的每個資產。
根據您使用的介面,支援的方法有兩種: Assets管理檢視或Assets檢視。
在Assets管理檢視中核准多個資產
執行以下步驟即可在 Experience Manager Assets Admin view 中同時核准多項資產:
- 選取資產,然後按一下「屬性」。
- 在「基本」索引標籤中,向下捲動至「審查狀態」。
- 將審查狀態變更為「已核准」。
- 按一下「儲存並關閉」。
如此會一次將 已核准 稽核狀態套用至每個選取的資產,並在單一步驟中確認及關閉變更。
在Assets檢視中核准多個資產
同樣地,若要在 Assets 視圖中的資料夾內同時核准多項資產:
-
選取資產,然後按一下「大量中繼資料編輯」。
-
在右側面板「屬性」區段內提供的「狀態」欄位中,選取「已核准」。
-
按一下「儲存」。
按一下「儲存」會同時將 已核准 狀態認可到所有選取的資產,確保資料夾中的檢閱狀態一致。
如何確保資產傳遞和支援 OpenAPI 之 Dynamic Media 的搜尋? secure-asset-delivery
Adobe Experience Manager中的 中央資產控管 可讓 數位資產管理(DAM)管理員 和 品牌管理員 直接控制誰可以存取透過 OpenAPI (開放式應用程式設計介面) 傳遞的資產。 此治理模型透過在來源強制存取規則,因此僅授權使用者可擷取受保護的內容,從而確保資產搜尋和資產傳送的安全。
這些管理員會使用兩個主要控制項,限制編寫端的存取權,尤其是對 AEM as a Cloud Service編寫執行個體 的存取權:
- 角色組態:根據指派的角色授與或拒絕存取權,確保每個使用者或群組只能看到其許可權允許的資產。
- 啟用和停用排程:管理員為已核准的資產設定精確的啟用和停用時間,因此內容會根據定義的發佈期間自動變成可用或撤銷。
由於這些控制項會套用至編寫層級,因此會控管每個下游請求。 搜尋資產或使用傳遞URL的一般使用者,只有在成功通過授權程式後,才會收到受限制的資產。 系統會封鎖授權失敗的請求,避免在知道傳遞URL時進行未授權的擷取。 這可確保DAM管理員和品牌管理員所做的治理決策在搜尋結果和直接傳送連結中一致執行。
如需更多資訊,請參閱限制存取 Experience Manager 中的資產。
如何取得編輯資產核准狀態的權限? permissions-edit-approval-status
若要取得編輯資產核准狀態的許可權,管理員必須授與對套用至資產資料夾的中繼資料結構描述中 檢閱狀態 欄位的編輯存取權。 身為數位資產管理(DAM)使用者,依預設,您可能沒有核准資產的許可權,因為核准和稽核狀態編輯是在中繼資料結構描述層級控制,而非透過一般資料夾存取控制。
管理員可依照下列步驟啟用此存取權:
- 開啟 預設中繼資料結構 或套用至相關資產資料夾的任何其他中繼資料結構。
- 在該結構描述中找到 檢閱狀態 欄位。
- 提供 檢閱狀態 欄位的編輯許可權。
授與編輯許可權給 檢閱狀態 欄位可確保指定的DAM使用者可以直接變更資產的核准狀態,精簡檢閱工作流程。 如需更多資訊,請參閱如何停用「核准狀態」欄位的編輯。
支援的影片檔案大小為何? supported-file-formats-videos
具有OpenAPI功能的Dynamic Media支援長格式視訊,檔案大小上限為50 GB,每個視訊的最長持續時間為2小時。 這些限制定義了單一視訊上傳的上限,允許提供完整長度的內容,例如錄製的網路研討會、訓練課程、產品示範和延伸簡報,而不將視訊分割成較短的區段。
由於Dynamic Media可容納大小達 50 GB 的檔案,因此可以上傳及串流高解析度及高位元速率影片,同時保留品質。 2小時的持續時間上限可確保長格式資產能容納在單一連續檔案中,進而簡化檢視者的內容管理及播放。
具有 OpenAPI 功能的 Dynamic Media 與 Dynamic Media 解決方案有何不同? dynamic-media-and-dynamic-media-with-openapi-differences
具備OpenAPI功能的Dynamic Media與Dynamic Media是截然不同的解決方案,各自提供專屬的傳送功能。 徹底檢閱您的特定需求,以決定最符合您需求的解決方案。
Adobe的一般指導方針是將Dynamic Media與OpenAPI (開放式應用程式設計介面)棧疊用於任何整合使用案例,無論它們涉及第一方或第三方應用程式。 由於這兩個棧疊使用不同的URL結構,請使用以下決定規則來選擇正確的方法:
- 現有的整合:如果與Dynamic Media棧疊的整合已經存在,請勿變更,因為OpenAPI棧疊URL的結構不同。
- 全新整合:對於任何全新整合的使用案例,請利用OpenAPI棧疊。
- 進階修飾元:如果您的使用案例需要進階修飾元,而OpenAPI棧疊尚未提供進階修飾元,請避免OpenAPI棧疊,直到Adobe彌合差距為止。
- 基本原生傳遞:即使是來自Adobe Experience Manager (AEM) Assets Cloud Services的基本原生傳遞,只要您的使用案例包含在OpenAPI棧疊提供的修飾詞中,就可以評估OpenAPI棧疊。
總而言之,視使用案例的性質而定,Dynamic Media和具有OpenAPI棧疊的Dynamic Media可以共存。
以下是具有 OpenAPI 功能的 Dynamic Media 與 Dynamic Media 之間的一些主要差異:
具有 OpenAPI 功能的 Dynamic Media 如何解決已連線資產功能的限制? dynamic-media-openapi-addresses-connected-assets-limitations
具備OpenAPI功能的Dynamic Media克服連線Assets功能的核心限制,消除二進位複製、支援所有AEM Assets格式型別(包括視訊)、移除四執行個體連線限制、啟用可擴充的自訂整合,並提供近乎即時的資產更新。 下列表格概述了兩種解決方案之間的主要區別:
一些修飾元被標記為「可用性受限」。 我要如何開始使用? use-limited-availability-modifiers
有限可用性修飾元需要明確啟用您的帳戶,才能用於生產環境。 Adobe預設不會啟用這些修飾元,因此您必須透過Adobe支援請求存取權。 此程式包含兩個步驟:開啟支援案例並提供身分識別詳細資訊,Adobe需要這些詳細資訊來布建要求的功能。
為了使生產時能在您的帳戶使用可用性受限的修飾元:
-
在Adobe支援案例中提及下列詳細資料,讓Adobe可以識別您的組織並布建要求的功能:
-
IMS組織 (Identity Management系統組織識別碼)
-
要啟用的修飾元清單
-
-
提交案例,並等待Adobe支援確認已為您的IMS組織啟用請求的有限可用性修飾元。Adobe確認啟用後,指定的修飾元即可在您的帳戶上用於生產。
如何測試實驗性修飾元? modifiers-not-generally-available
實驗API可讓您測試任何尚未普遍可用的修飾元。 實驗(或測試版) API可讓開發人員提早存取仍在評估中的功能,以便您可以在新修飾元升級至穩定(一般可用)集之前先驗證這些修飾元。 這可讓您試用即將推出的功能、確認其在工作流程中的行為如預期,並在一般版本之前提供意見回饋。
若要測試一般不提供的修飾元,請透過實驗API路徑叫用它。 例如:
</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>
expires-YYYYMMDD區段表示實驗修飾元是時間限制的,表示實驗版本預計變更或到期的日期,提醒您一旦發行後要移轉至一般可用的對等專案。
如需叫用這些端點的詳細資訊,請參閱如何使用實驗API的指南。 若要識別哪些修飾元可供使用,請參閱修飾元完整清單。
另請參閱