ドキュメントAEM as a Cloud Serviceユーザーガイド

[AEM Assets]{class="badge positive" title="AEM Assetsに適用）。"}

OpenAPI 機能を備えた Dynamic Media の統合 integrate-dynamic-media-openapis

Last update: Fri May 08 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用対象：
  • Experience Manager as a Cloud Service

作成対象：

  • 管理者
  • ユーザー

Content Advisorを利用すれば、さまざまなAdobeアプリケーションを統合し、シームレスに連携させることができます。

前提条件 prereqs-polaris

OpenAPI機能を使用してContent AdvisorとDynamic Mediaを統合する場合は、次の前提条件を使用します。

  • 通信方法

  • OpenAPI 機能を備えた Dynamic Media にアクセスするには、次のライセンスが必要です。

    • アセットリポジトリ（例：Experience Manager Assets as a Cloud Service）。
    • AEM Dynamic Media。

  • ブランドの一貫性を確保するために、承認済みアセットのみを使用できます。

OpenAPI 機能を備えた Dynamic Media の統合 adobe-app-integration-polaris

Content AdvisorとDynamic Media OpenAPI プロセスの統合には、カスタマイズされたDynamic Media URLの作成やDynamic Media URLの選択など、様々な手順が必要です。

OpenAPI機能を使用したDynamic Media用Content Advisorの統合 integrate-dynamic-media

OpenAPI 機能を備えた Dynamic Media では、rootPath プロパティと path プロパティを使用しないでください。 代わりに、aemTierType プロパティを設定できます。 設定の構文を以下に示します。

aemTierType:[1: "delivery"]

この設定により、すべての承認済みアセットをフォルダーなしで表示したり、フラットな構造として表示したりできます。 詳しくは、​ コンテンツアドバイザープロパティ ​の下のaemTierType プロパティに移動します。

承認済みアセットからの動的配信 URL の作成 create-dynamic-media-url

コンテンツアドバイザーを設定すると、オブジェクトのスキーマを使用して、選択したアセットから動的配信URLを作成します。
例えば、アセットの選択時に受信されるオブジェクトの配列からの 1 つのオブジェクトのスキーマは次のようになります。

{
"dc:format": "image/jpeg",
"repo:assetId": "urn:aaid:aem:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"repo:name": "image-7.jpg",
"repo:repositoryId": "delivery-pxxxx-exxxxxx.adobe.com",
...
}

すべての選択済みアセットは、JSON オブジェクトとして機能する handleSelection 関数によって実行されます。 例えば、JsonObj のようになります。 動的配信 URL は、以下のキャリアを組み合わせて作成されます。

オブジェクト
JSON
ホスト
assetJsonObj["repo:repositoryId"]
API ルート
/adobe/assets
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"].split(".").slice(0,-1).join(".")
format
.jpg

承認済みアセット配信 API 仕様 approved-assets-delivery-api-specification

URL形式：
https://<delivery-api-host>/adobe/assets/<asset-id>/as/<seo-name>.<format>?<image-modification-query-parameters>

ここで、

  • ホストは https://delivery-pxxxxx-exxxxxx.adobe.com です
  • API ルートは "/adobe/assets" です
  • <asset-id> はアセット識別子です
  • as は、オープン API 仕様の定数部分で、アセットが何と呼ばれるかを示します
  • <seo-name> はアセットの名前です
  • <format> は出力形式です
  • <image modification query parameters> は、承認済みアセットの配信 API 仕様でサポートされています

承認されたアセットの元のレンディション配信 API approved-assets-delivery-api

動的配信URLには、次の構文があります。
https://<delivery-api-host>/adobe/assets/<asset-id>/original/as/<seo-name>、ここで，

  • ホストは https://delivery-pxxxxx-exxxxxx.adobe.com です
  • 元のレンディション配信の API ルートは "/adobe/assets" です。
  • <asset-id> はアセット識別子です
  • /original/as は、オープン API 仕様の定数部分で、元のレンディションが何と呼ばれるかを示します
  • <seo-name> はアセットの名前で、拡張子はある場合もない場合もあります

動的配信 URL を選択する準備の完了 ready-to-pick-dynamic-delivery-url

すべての選択済みアセットは、JSON オブジェクトとして機能する handleSelection 関数によって実行されます。 例えば、JsonObj のようになります。 動的配信 URL は、以下のキャリアを組み合わせて作成されます。

オブジェクト
JSON
ホスト
assetJsonObj["repo:repositoryId"]
API ルート
/adobe/assets
asset-id
assetJsonObj["repo:assetId"]
seo-name
assetJsonObj["repo:name"]

JSON オブジェクトをトラバースする 2 つの方法を以下に示します。

動的配信 URL

  • サムネール：​サムネールは画像にすることができ、アセットは PDF、ビデオ、画像などです。 ただし、アセットのサムネールの高さと幅の属性を動的配信レンディションとして使用できます。
    PDF type アセットには、次のレンディションのセットを使用できます。
    SidekickでPDFを選択すると、選択コンテキストに次の情報が表示されます。 JSON オブジェクトをトラバースする方法を以下に示します。

    上記のスクリーンショットから、レンディションリンクの配列については selection[0].....selection[4] を参照できます。 例えば、サムネールレンディションの 1 つに含まれる主要なプロパティは次のとおりです。

    code language-none 
    {
    "height": 319,
    "width": 319,
    "href": "https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/as/algorithm design.jpg?width=319&height=319",
    "type": "image/webp"
}

上記のスクリーンショットでは、PDF が必要でサムネールは不要な場合は、PDF の元のレンディションの配信 URL をターゲットエクスペリエンスに組み込む必要があります。 例えば、https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:8560f3a1-d9cf-429d-a8b8-d81084a42d41/original/as/algorithm design.pdf のように指定します。

  • ビデオ：​埋め込み iFrame を使用するビデオタイプのアセットには、ビデオプレーヤーの URL を使用できます。 ターゲットエクスペリエンスでは、次の配列レンディションを使用できます。

    code language-none 
    {
    "height": 319,
    "width": 319,
    "href": "https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/as/DragDrop.2.jpg?width=319&height=319",
    "type": "image/webp"
}

    上記のスクリーンショットから、レンディションリンクの配列については selection[0].....selection[4] を参照できます。 例えば、サムネールレンディションの 1 つに含まれる主要なプロパティは次のとおりです。

    上記のスクリーンショットのコードスニペットは、ビデオアセットの例です。 これには、レンディションリンク配列が含まれます。 抜粋の selection[5] は、ターゲットエクスペリエンス内のビデオサムネールのプレースホルダーとして使用できる画像サムネールの例です。 レンディション配列の selection[5] は、ビデオプレーヤー用です。 これは、HTML を提供し、iframe の src として設定できます。 ビデオの web に最適化された配信であるアダプティブビットレートストリーミングをサポートします。

    上記の例では、ビデオ プレーヤーの URL は、https://delivery-pxxxxx-exxxxx.adobeaemcloud.com/adobe/assets/urn:aaid:aem:2fdef732-a452-45a8-b58b-09df1a5173cd/play です。

カスタムフィルターの設定 configure-custom-filters-dynamic-media-open-api

OpenAPI機能を備えたDynamic Media用Content Advisorを使用すると、カスタムプロパティとそれに基づくフィルターを設定できます。 このようなプロパティを設定するには、filterSchema プロパティを使用します。 カスタマイズは、metadata.<metadata bucket>.<property name>. として公開され、それに対してフィルターを設定できます。ここで、

  • metadata はアセットの情報です
  • embedded は、設定に使用される静的パラメーターです
  • <propertyname> は、設定しているフィルター名です

設定では、jcr:content/metadata/ レベルで定義されているプロパティが、設定するフィルターの metadata.<metadata bucket>.<property name>. として公開されます。

例えば、OpenAPI機能を備えたDynamic MediaのContent Advisorでは、asset jcr:content/metadata/client_name:marketのプロパティがフィルター設定用にmetadata.embedded.client_name:marketに変換されます。

名前を取得するには、1 回限りのアクティビティを実行する必要があります。 アセットの検索 API 呼び出しを行って、プロパティ名（基本的にはバケット）を取得します。

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab