[AEM Assets]{class="badge positive" title="适用于AEM Assets)。"}
具有 OpenAPI 功能的 Dynamic Media 常见问题解答 new-dynaminc-media-apis-frequently-asked-questions
具有 OpenAPI （开放应用程序编程接口） 功能的Dynamic Media通过易于开发人员使用的标准化API端点，交付、转换和管理富媒体资产（图像、视频和其他可视内容）。 本常见问题指南回答了有关这些功能如何工作、它们支持什么以及如何采用它们的最常见问题。
什么是Dynamic Media具有OpenAPI功能？ what-are-dynamic-media-openapi-capabilities
Dynamic Media是一组媒体交付和转换服务，可自动为任何设备、渠道或屏幕优化、调整大小和渲染资产。 OpenAPI功能通过公开的、有充分文档记录的API规范公开这些服务，允许开发人员将媒体交付直接集成到他们自己的应用程序、店面和内容体验中。
由于接口遵循OpenAPI标准，因此它们具有自描述性和可预测性。 因此，集成团队可以发现可用的端点，了解请求和响应格式，并比使用专有的、未记录的界面更快地生成客户端代码。
主要优点 key-benefits
具有OpenAPI功能的Dynamic Media的主要优势包括：
- 标准化集成：符合OpenAPI的端点使得将媒体服务连接到现有应用程序和工具链变得简单明了。
- 按需媒体转换： Assets在请求时进行了优化、大小调整和重新格式化，从而无需存储多个手动变体。
- 多渠道投放：单个资产可以跨Web、移动和连接的体验进行投放和调整。
- Headless就绪架构： API优先交付与Headless和可组合技术栈栈一致。
- 更快的开发：自我描述规范可加快集成团队的入门、客户端代码生成和测试。
我如何使用Dynamic Media OpenAPI功能？ what-can-i-do
您可以按需请求媒体资产，应用实时转换（如裁切、调整大小和格式转换），并将优化的内容交付给Web、移动和连接的体验 — 所有这些都通过标准化的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不会显示以供搜索和交付。
- 版本货币 — 只有已批准资产的 最新版本 才符合条件。 不会返回被取代的版本或历史版本。
此范围界定是有意为之。 由于只有经过批准的当前资产才符合条件，因此投放仅限于通过治理审查的内容，这可以确保所有渠道和应用程序之间的品牌一致性。 因此，通过具有OpenAPI功能的Dynamic Media使用资源的下游体验会可靠地引用经过审核的最新内容，而不是未批准或过时的修订。
管理员如何将添加到文件夹中的新资产和现有资产标记为已批准？ 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 身份管理服务）的用户或组 ID，以便在 Experience Manager 管理员视图中设置资产上的角色，从而确保传递和搜索体验？ set-roles-secure-delivery-search
Adobe IMS (Adobe Identity Management Services)用户和组ID是从Adobe的 Admin Console 中检索出来的，并在Experience Manager Assets Admin view中应用这些用户和组ID来设置可保护投放和搜索体验的角色。 根据这些IMS用户或组ID分配角色可确保只有经过授权的身份才能访问、交付或搜索特定资产。 由于资产级访问受这些身份控制，因此在Experience Manager中，使用正确的IMS ID是实现基于角色的安全的基本步骤。
需要访问 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视图中批准多个资源
同样，要在资产视图中同时批准文件夹内的多个资产：
-
选择资产并点击批量编辑元数据。
-
在右侧面板的属性部分，选择 状态 字段中的已批准。
-
单击保存。
单击“保存”可同时将 “已批准” 状态提交到所有选定的资产，确保文件夹中的审阅状态一致。
如何确保资产安全传递以及如何搜索具有 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 with 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通过消除二进制复制、支持所有AEM Assets格式类型（包括视频）、取消四实例连接限制、启用可扩展的自定义集成以及提供近乎实时的资源更新，从而克服了“连接的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的指南。 要确定哪些修饰符可用，请查阅修饰符的完整列表。
另请参阅