[AEM Assets]{class="badge positive" title="AEM Assets에 적용됩니다)."}
OpenAPI 기능이 포함된 Dynamic Media에 대해 자주 묻는 질문 new-dynaminc-media-apis-frequently-asked-questions
OpenAPI(Open Application Programming Interface) 기능이 있는 Dynamic Media는 표준화된 개발자 친화적인 API 끝점을 통해 이미지, 비디오 및 기타 시각적 콘텐츠와 같은 리치 미디어 자산을 제공, 변환 및 관리합니다. 이 FAQ 가이드는 이러한 기능의 작동 방식, 활성화 사항 및 채택 방법에 대한 가장 일반적인 질문에 대한 답변을 제공합니다.
OpenAPI 기능을 갖춘 Dynamic Media란 무엇입니까? what-are-dynamic-media-openapi-capabilities
Dynamic Media는 모든 장치, 채널 또는 화면에 대한 에셋을 자동으로 최적화, 크기 조정 및 렌더링하는 미디어 전달 및 변환 서비스 세트입니다. OpenAPI 기능은(는) 잘 문서화된 개방형 API 사양을 통해 이러한 서비스를 노출하므로 개발자가 직접 애플리케이션, 상점 및 콘텐츠 환경에 미디어 게재를 통합할 수 있습니다.
인터페이스는 OpenAPI 표준을 따르므로 자체 설명적이고 예측 가능합니다. 따라서 통합 팀은 전용 문서화되지 않은 인터페이스보다 사용 가능한 끝점을 찾고 요청 및 응답 형식을 이해하며 클라이언트 코드를 더 빨리 생성할 수 있습니다.
주요 이점 key-benefits
OpenAPI 기능을 갖춘 Dynamic Media의 주요 장점은 다음과 같습니다.
- 표준화된 통합: OpenAPI 호환 엔드포인트를 사용하면 미디어 서비스를 기존 응용 프로그램 및 툴체인에 쉽게 연결할 수 있습니다.
- 주문형 미디어 변환: Assets은 요청 시 최적화, 크기 조정 및 다시 포맷되므로 여러 개의 수동 변형을 저장할 필요가 없습니다.
- 다중 채널 게재: 웹, 모바일 및 연결된 환경에서 단일 자산을 게재하고 조정할 수 있습니다.
- Headless용 아키텍처: API 우선 제공은 Headless 및 구성 가능한 기술 스택에 맞게 조정됩니다.
- 개발 속도 향상: 자체 설명 사양은 온보딩, 클라이언트 코드 생성 및 통합 팀에 대한 테스트를 가속화합니다.
Dynamic Media OpenAPI 기능으로 무엇을 할 수 있습니까? what-can-i-do
표준화된 API 호출을 통해 온디맨드 미디어 에셋을 요청하고, 자르기, 크기 조정 및 형식 변환과 같은 실시간 변환을 적용하고, 웹, 모바일 및 연결된 환경에 최적화된 콘텐츠를 전달할 수 있습니다.
OpenAPI 기능은 기존의 Dynamic Media 제공과 어떻게 다릅니까? openapi-vs-traditional
기존 게재는 사전 설정된 URL 패턴 및 템플릿을 사용합니다. OpenAPI 기능에는 자동화, 사용자 정의 통합 및 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 속성을 다시 평가하므로 기존 에셋은 모두 재처리된 후에만 승인됩니다. 자산을 재처리하는 방법에 대한 지침은 디지털 자산 재처리를 참조하십시오. 관리자가 다른 폴더에서 승인되지 않은 자산을 복사하거나 이동하는 경우 이동한 자산이 승인된 상태를 상속하도록 자산을 재처리해야 합니다.
AEM Assets은 관리자가 Rejected 또는 Changes requested 값을 지정할 때마다 자산을 Rejected(으)로 표시합니다. 두 값 모두 승인되지 않은 상태를 나타내기 때문입니다. AEM Assets은 [관리] 보기의 자산 카드에서 사용할 수 있는
마찬가지로 AEM Assets은 에셋 카드에서 다음 거부됨 상태를 사용하여 Assets 보기에서 거부됨 상태를 구별합니다.
게재 및 검색 경험을 보호하기 위해 Experience Manager 관리 보기에서 에셋에 대한 역할을 설정하는 데 사용할 Adobe IMS(Adobe Identity Management Services) 사용자 또는 그룹 ID를 가져오려면 어떻게 해야 합니까? set-roles-secure-delivery-search
Adobe IMS(Adobe Identity Management Services) 사용자 및 그룹 ID가 Adobe의 Admin Console에서 검색되고 Experience Manager Assets Admin view에 적용되어 배달 및 검색 환경을 보호하는 역할을 설정합니다. 이러한 IMS 사용자 또는 그룹 ID를 기반으로 역할을 할당하면 승인된 ID만 특정 자산에 액세스, 전달 또는 검색할 수 있습니다. 에셋 수준 액세스는 이러한 ID에 의해 제어되므로, 올바른 IMS ID를 사용하는 것은 Experience Manager에서 역할 기반 보안을 위한 기본 단계입니다.
Experience Manager 작성자 환경에 액세스해야 하는 사용자는 Adobe의 Admin Console에서 Adobe IMS 사용자(으)로 관리됩니다. Adobe IMS 사용자에 대한 정보, Admin Console에서 액세스 및 관리되는 방식에 대한 자세한 내용은 Adobe IMS 사용자를 참조하십시오.
IMS ID가 자산 역할에 매핑되는 방법:
- Adobe IMS 사용자는 Adobe의 Admin Console에서 중앙 집중식으로 프로비저닝되고 관리되는 개별 사용자를 나타내며, Adobe Experience Cloud 애플리케이션 전반에서 ID에 대한 단일 소스로 제공됩니다.
- Adobe IMS 그룹에서는 여러 사용자를 함께 관리할 수 있으므로 역할과 권한을 각 사용자에게 개별적으로 적용하지 않고 그룹에 일관되게 적용할 수 있습니다.
- Admin Console에서 가져온 사용자 ID 또는 그룹 ID은(는) 에셋에 대한 역할을 구성하고, 배달 및 검색 권한을 알려진 관리 ID에 직접 연결할 때 참조되는 값입니다.
게재 및 검색 경험은 에셋에 설정된 역할에 따라 제어되므로 Admin Console에서 정확한 Adobe IMS 사용자 또는 그룹 ID를 검색해야 합니다. 이 접근 방식은 ID 관리를 중앙 집중화하고, 무단 자산 액세스의 위험을 줄이며, Adobe 환경 전반에 걸쳐 ID가 이미 관리되는 방식에 맞게 권한을 유지합니다.
폴더 내에서 여러 자산을 동시에 승인할 수 있습니까? 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(Open Application Programming Interfaces)를 통해 제공되는 자산에 액세스할 수 있는 사용자를 직접 제어합니다. 이 거버넌스 모델은 소스에서 액세스 규칙을 적용하여 에셋 검색과 에셋 전달을 모두 보호하므로 승인된 사용자만 보호된 콘텐츠를 검색할 수 있습니다.
이러한 관리자는 두 개의 기본 컨트롤을 사용하여 작성 측(특히 AEM as a Cloud Service 작성자 인스턴스)에 대한 액세스를 제한합니다.
- 역할 구성: 할당된 역할에 따라 액세스 권한이 부여되거나 거부되어 각 사용자 또는 그룹에 해당 권한이 허용하는 자산만 표시되도록 합니다.
- 활성화 및 비활성화 예약: 관리자는 승인된 자산에 대해 정확한 활성화 및 비활성화 시간을 설정하므로 정의된 게시 기간에 따라 콘텐츠를 사용할 수 있거나 자동으로 철회됩니다.
이러한 컨트롤은 작성 수준에서 적용되므로 모든 다운스트림 요청을 제어합니다. 에셋을 검색하거나 배달 URL을 사용하는 최종 사용자는 인증 프로세스를 통과한 후에만 제한된 에셋을 받습니다. 인증에 실패한 요청은 차단되므로 게재 URL이 알려지더라도 승인되지 않은 검색을 수행할 수 없습니다. 이렇게 하면 DAM 관리자와 브랜드 관리자가 결정한 거버넌스 결정이 검색 결과와 직접 게재 링크 모두에 걸쳐 일관되게 적용됩니다.
자세한 내용은 Experience Manager의 자산에 대한 액세스 제한을 참조하십시오.
에셋의 승인 상태를 편집할 수 있는 권한을 얻으려면 어떻게 해야 합니까? permissions-edit-approval-status
에셋의 승인 상태를 편집할 수 있는 권한을 얻으려면 관리자는 에셋 폴더에 적용된 메타데이터 스키마 내의 검토 상태 필드에 편집 액세스 권한을 부여해야 합니다. DAM(디지털 에셋 관리) 사용자는 승인 및 검토 상태 편집이 일반 폴더 액세스가 아닌 메타데이터 스키마 수준에서 제어되므로 기본적으로 에셋을 승인할 권한이 없을 수 있습니다.
관리자는 다음 단계에 따라 이 액세스 권한을 활성화할 수 있습니다.
- 기본 메타데이터 스키마 또는 관련 자산 폴더에 적용된 기타 메타데이터 스키마를 엽니다.
- 해당 스키마 내에서 검토 상태 필드를 찾습니다.
- 검토 상태 필드에 편집 권한을 제공하십시오.
검토 상태 필드에 편집 권한을 부여하면 지정된 DAM 사용자가 에셋의 승인 상태를 직접 변경할 수 있으므로 검토 워크플로가 간소화됩니다. 자세한 내용은 검토 상태 필드에 대한 편집을 비활성화하는 방법을 참조하십시오.
비디오에 지원되는 파일 크기는 얼마입니까? supported-file-formats-videos
OpenAPI 기능이 있는 Dynamic Media는 비디오당 최대 파일 크기가 50GB이고 최대 지속 시간이 2시간인 긴 형식의 비디오를 지원합니다. 이러한 제한은 단일 비디오 업로드의 상한을 정의하므로 푸티지를 더 짧은 세그먼트로 분할하지 않고 기록된 웨비나, 교육 세션, 제품 데모 및 확장된 프레젠테이션과 같은 전체 길이 콘텐츠를 제공할 수 있습니다.
Dynamic Media는 50GB의 파일을 수용하므로 고해상도와 고비트율 푸티지를 업로드하고 품질을 유지하면서 스트리밍할 수 있습니다. 2시간 기간 제한을 사용하면 긴 형식의 에셋이 단일 연속 파일에 맞게 조정되므로 뷰어의 콘텐츠 관리 및 재생이 간단해집니다.
OpenAPI 기능 포함 Dynamic Media와 Dynamic Media 솔루션의 차이점은 무엇입니까? dynamic-media-and-dynamic-media-with-openapi-differences
OpenAPI 기능이 포함된 Dynamic Media 및 Dynamic Media는 고유한 전문 제공 기능을 제공하는 고유한 솔루션입니다. 구체적인 요구 사항을 철저히 검토하여 요구 사항에 가장 적합한 솔루션을 결정하십시오.
Adobe의 일반적인 지침은 자사 애플리케이션과 타사 애플리케이션 간에 통합 사용 사례에 대해 OpenAPI(Open Application Programming Interface) 스택과 함께 Dynamic Media를 활용하는 것입니다. 두 스택은 서로 다른 URL 구조를 사용하므로 다음 의사 결정 규칙을 사용하여 올바른 접근 방식을 선택합니다.
- 기존 통합: OpenAPI 스택 URL의 구조가 다르므로 Dynamic Media 스택에 이미 통합이 있는 경우 변경하지 마십시오.
- 새로운 통합: 새로운 통합 사용 사례의 경우 OpenAPI 스택을 활용하십시오.
- 고급 수정자: 사용 사례에서 OpenAPI 스택에서 아직 사용할 수 없는 고급 수정자가 필요한 경우 Adobe에서 간격을 늘릴 때까지 OpenAPI 스택을 사용하지 마십시오.
- 기본 네이티브 게재: 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 형식 유형(비디오 포함) 지원, 4인스턴스 연결 제한 제거, 확장 가능한 사용자 정의 통합 활성화 및 거의 실시간으로 에셋 업데이트 제공을 통해 연결된 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를 사용하는 방법에 대한 지침을 참조하세요. 사용 가능한 수정자를 식별하려면 전체 수정자 목록을 참조하세요.
추가 참조