[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の主な利点は次のとおりです。

Dynamic Media OpenAPI機能で何ができますか？ what-can-i-do

Adobe Experience Managerなら、標準化されたAPIを介して、オンデマンドでメディアアセットをリクエストし、トリミング、リサイズ、フォーマット変換などのリアルタイム変換を適用して、webやモバイル、連続性のあるエクスペリエンスに最適化されたコンテンツを提供できます。

OpenAPI機能と従来のDynamic Media配信との違いは何ですか？ openapi-vs-traditional

従来の配信は、プリセットされたURL パターンとテンプレートを利用していました。 OpenAPI機能により、標準化されたプログラマティックなインターフェイスが追加され、自動化、カスタム統合、ヘッドレス（フロントエンドを分離）アーキテクチャの導入が容易になります。

これらの機能は、ヘッドレスおよびコンポーザブルアーキテクチャに適していますか？ headless-composable

はい。 メディアは、固定されたページテンプレートではなくAPIを通じて取得および変換されるため、Dynamic Media OpenAPI機能は、コンテンツやサービスから分離されたヘッドレスコンテンツ管理およびコンポーザブルコマースの設定に自然に適合します。

これらの機能を使用するために開発者のリソースが必要ですか？ developer-resources

API ベースの統合では、通常、開発者がエンドポイントをアプリケーションに接続します。 しかし、OpenAPI仕様では、自動化されたクライアント生成とテストをサポートする、一貫した機械読み取り可能な定義を提供することで、この労力を軽減します。

Experience Manager Assets as a Cloud Service リポジトリ内のすべてのアセットは、OpenAPI 機能を備えた Dynamic Media を使用した検索および配信で使用できますか？ assets-available-for-search

いいえ。 承認済みの最新バージョンのアセット​のみが、OpenAPI機能を備えた​Dynamic Mediaを使用して検索および配信できます。 承認されていないAssets、または以前のリビジョンとしてのみ存在するAdobe Targetは、この検索と配信の範囲から除外されます。

Experience Manager Assets as a Cloud Service リポジトリ内のアセットが表示されるかどうかを指定する2つの条件があります。

この範囲は意図的です。 承認済みの現在のアセットのみが対象となるため、配信はガバナンスレビューに合格したコンテンツに限定され、すべてのチャネルとアプリケーションでブランドの一貫性が確保されます。 その結果、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 サービス）ユーザー ID またはグループ ID を取得するにはどうすればよいですか？ set-roles-secure-delivery-search

Adobe IMS（Adobe Identity Management サービス）のユーザーIDとグループ 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をアセットの役割にマッピングする方法：

配信と検索のエクスペリエンスはアセットに設定された役割によって管理されるため、Admin Consoleから正確なAdobe IMSユーザーまたはグループ IDを取得することが不可欠です。 このアプローチにより、ID管理を一元化し、アセットへの不正アクセスのリスクを低減し、Adobe環境全体でIDが既に管理されている方法に合わせて権限を自動調整できます。

フォルダー内で複数のアセットを同時に承認できますか？ approve-multiple-assets-in-folder

はい。 Adobe Experience Manager（AEM）Assetsを使用すると、1つのフォルダー内の複数のアセットを同時に承認できるため、各ファイルを個別に承認する必要はありません。 一括承認は、レビューワークフローを合理化し、大規模なアセットライブラリを管理する際に大幅な時間を節約します。これは、Approved​のレビューステータスが、1回のアクションで選択したすべてのアセットに適用されるためです。

使用するインターフェイスに応じて、Assets管理者ビュー​または​ Assets ビュー ​の2つの方法がサポートされています。

Assetsの管理者ビューで複数のアセットを承認する

Experience Manager Assets Admin view で複数のアセットを同時に承認するには、次の手順を実行します。

これにより、Approved​のレビューステータスが、選択したすべてのアセットに一度に適用され、変更を1回の手順で確認して閉じます。

Assets ビューでの複数のアセットの承認

同様に、アセットビューのフォルダー内で複数のアセットを同時に承認するには、次の手順を実行します。

保存​をクリックすると、選択したすべてのアセットに​ 承認済み ​のステータスが同時に確定され、フォルダー全体でレビューの状態が一貫します。

OpenAPI を使用してアセット配信と Dynamic Media の検索を安全に行うにはどうすればよいですか？ secure-asset-delivery

Adobe Experience Managerの​ 中央アセット管理 ​では、デジタルアセット管理（DAM）管理者​および​ ブランドマネージャー ​が、OpenAPI （Open Application Programming Interfaces）​を通じて配信されたアセットにアクセスできるユーザーを直接制御できます。 このガバナンスモデルは、ソースにアクセスルールを適用することで、アセット検索とアセット配信の両方を保護するため、承認済みのユーザーのみが保護されたコンテンツを取得できます。

これらの管理者は、次の2つのプライマリコントロールを使用して、オーサリング側（特に​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時間 ​のロングフォームビデオをサポートします。 この制限により、ビデオのアップロードを1回に制限することができ、録画されたウェビナー、トレーニングセッション、製品デモ、拡張プレゼンテーションなどの長編コンテンツを、フッテージを短いセグメントに分割することなく配信することができます。

Dynamic Mediaは​ 50 GB ​という大きさのファイルに対応するため、高品質なフッテージや高ビットレートのフッテージをアップロードしてストリーミングできます。品質は保たれます。 2時間​の期間の上限により、長文アセットが1つの連続ファイル内に収まることが保証され、視聴者のコンテンツ管理と再生が簡素化されます。

OpenAPI 機能を備えた Dynamic Media と Dynamic Media ソリューションの違い dynamic-media-and-dynamic-media-with-openapi-differences

OpenAPI機能を備えたDynamic MediaとDynamic Mediaは個別のソリューションであり、それぞれ独自の特殊な配信機能を提供します。 それぞれの要件を詳細に確認し、自社のニーズに最も適したソリューションを決定します。

Adobeの一般的なガイダンスでは、1st パーティまたは3rd パーティのアプリケーションを含む統合ユースケースに対して、Dynamic Media with OpenAPI （Open Application Programming Interface）スタックを活用します。 2つのスタックで異なるURL構造を使用するため、次の決定ルールを使用して適切なアプローチを選択します。

最後に、Dynamic MediaとOpenAPI スタックを持つDynamic Mediaは、ユースケースの性質に応じて共存できます。

OpenAPI 機能を備えた Dynamic Media と Dynamic Media の主な違いは次のとおりです。

OpenAPI 機能を備えた Dynamic Media は、接続されたアセット機能の制限にどのように対処しますか？ dynamic-media-openapi-addresses-connected-assets-limitations

Dynamic Media with OpenAPI機能は、バイナリコピーを排除し、すべてのAssets形式（ビデオを含む）をサポートし、4つのインスタンス接続の制限を取り除き、拡張可能なカスタム統合を実現し、ほぼリアルタイムのアセット更新を提供することで、コネクテッドAEM Assets機能の主な制限を克服します。 次の表に、2 つのソリューションの主な違いの概要を示します。

一部の修飾子は、限定提供としてマークされています。 使用を開始するにはどうすればよいですか？ use-limited-availability-modifiers

制限付き可用性の修飾子は、実稼動環境で使用する前に、アカウントに対して明示的な有効化が必要です。 Adobeでは、これらの修飾子はデフォルトでアクティブ化されないため、Adobe サポートを通じてアクセスをリクエストする必要があります。 このプロセスは、サポートケースを開き、Adobeが要求された機能をプロビジョニングするために必要な識別情報を提供するという2つのステップで構成されます。

アカウントで限定提供の修飾子の実稼動環境での使用を有効にするには：

実験修飾子のテスト方法 modifiers-not-generally-available

実験的なAPIを使用すると、まだ一般に利用できない修飾子をテストできます。 実験的（またはベータ版） APIを使用すると、開発者は評価中の機能に早期にアクセスできるので、新しい修飾子が安定した一般利用可能なセットに昇格する前に検証できます。 これにより、今後の機能を試し、ワークフローで期待どおりに動作することを確認し、一般的なリリースに先立ってフィードバックを提供することができます。

一般的には使用できない修飾子をテストするには、実験的なAPI パスを通じて呼び出します。 次に例を示します。

</adobe/experimental/advancemodifiers-expires-YYYYMMDD/assets>

expires-YYYYMMDD セグメントは、実験的な修飾子が期限付きであることを示します。実験的なバージョンが変更または期限切れになると予想される日付を示します。リリース後、一般的に利用可能な同等のバージョンに移行するように促します。

これらのエンドポイントの呼び出しについて詳しくは、実験的APIの使用方法に関するガイダンスを参照してください。 使用可能な修飾子を特定するには、修飾子の完全リスト ​を参照してください。

関連情報