1. メディア配信API

配信リンク

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

アセットを検索すると、実際の画像、ビデオ、またはその他のダウンロード可能なメディアは、ページで使用されているホストとは異なるホストによって配信されます。メディア配信サービス (MDS) は、配信リンク (レンディションとも呼ばれます) を通じて配信を提供します。

事前認証済みURL

別のドメインのコンテンツを保護するために、Cookieを使用することはできません。事前認証されたURLを使用することで、配信ホストは、Content Hubポータルに接続せずにクライアントがリソースを取得することを許可できます。

監査ログ

配信ホストは、Download eventメッセージをキューに投稿して、ポータルホストの外部にあるすべてのダウンロードイベントを集約し、分析または監査を実行できます。配信ホストは、リクエストごとにウォーターマークを追加できます。

メモ

ポータルは、専用のサテライト ノードに加えて、サテライト ノードとしても機能します。

リクエストURL

リクエストURLの形式は次のとおりです。

https://<HOST>/api/delivery/<API_VERSION>/<TENANT_ID>/<KEY>{?expires,entityid,userid,rendition,watermark,signature}
大事な

MDSに直接リクエストを送信する必要はありません。リクエストURLは、Content Hubの使用時に透過的に構築されます。

次の表に、要求URLのパラメーターを示します。

パラメーター

形容

必須

apiVersion

APIバージョン。これは、将来重大な変更が発生する可能性のある場合の互換性のために使用されます。

はい

tenantId

要求を行ったテナントを識別するID。

はい

key

ファイル プロバイダー内のバイナリ ラージ オブジェクト (BLOB) を識別するキー。

はい

signature

URLを検証する署名。

はい

entityid

ダウンロード イベントのログ記録に使用されます。

いいえ

userid

ダウンロード イベントのログ記録に使用されます。

いいえ

rendition

ダウンロード イベントのログ記録に使用されます。レンディションがない場合、リソースはinline返され、そうでない場合はattachmentとして返され、場合によってはバックエンドストアへのリダイレクトが使用されます。

いいえ

intent

リンクの目的 ( downloadまたはstreaming) は、リソースinlineを使用するか、attachmentとして使用するかを示すことです。

いいえ

watermark

画像に適用できる透かし。

いいえ

expires

リンクの有効期限が切れ、URLが無効になった日時 (ISO8601) です。存在しない場合、有効期限はありません。

いいえ

filename

ファイルの名前。

いいえ

手記

これらのパラメータは、AssetExtensionDataMessageHandler実装によって自動的に生成されます。

この記事を改善するための提案がある場合は、 お知らせください!