メディア配信API

公開リンク

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

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

Sitecore Content Hubのアセット詳細ページで、レンディションを公開できます。つまり、他のファイルとは異なり、ファイルは事前に署名されていないURLを使用してアクセスできます。静的URLを知っている人なら誰でも、ファイルをキャッシュしてフェッチできます。

リクエストURL

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

https://{HOST}/api/public/{RESOURCE_TYPE}/{RELATIVE_URL}?{V}

大事な

メディア配信サービス (MDS) にリクエストを直接送信する必要はありません。リクエストURLは、Content Hubを使用する際に透過的に構築されます。

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

パラメーター	形容
RESOURCE_TYPE	URLでアクセスされているリソースのタイプまたはカテゴリ (画像、ドキュメント、ビデオなど) を識別します。自動的に生成されます。
RELATIVE_URL	システム内のリソースの相対パスまたは場所を指定します。デフォルトでは、システムによって値が割り当てられますが、読みやすさや整理性を向上させたり、特定の要件を満たすためにURLパスをカスタマイズするために、値を変更できます。
V	コンテンツアイテムのバージョン番号。ブラウザのキャッシュの有効期限が切れるのを待たずに常に最新バージョンを取得できるように、自動的に生成されます。
t	変換パラメータ。ユーザー生成。随意。
b	イメージのマージパラメーター。ユーザー生成。随意。

有効期限の日時

公開リンクは、一定の時間が経過すると期限切れになるように構成できます。有効期限の日時を設定しない場合、ファイルの有効期限は切れません。リンクコンテンツはキャッシュできるため、このコンテンツは有効期限が切れた後も最大10分間アクセスできます。同様に、リンクを削除しても、そのリンクがキャッシュされている場合、そのリンクは最大10分間使用可能なままになります。

リソースの種類

すべての公開リンクは、リソースタイプに関連付けられています。この関連付けにより、パブリックエンドポイントは、次の2種類のリソースのみを提供するように構成できます。

Content - ユーザーが作成したリンクの場合。
Portal - システムによって生成されたリンクの場合。

強制ダウンロード

デフォルトでは、可能であれば、公開リンクファイルがブラウザに表示されます。ただし、ZIPファイルなど、一部のファイルタイプは表示できません。これらのファイルタイプは自動的にダウンロードされます。

公開リンクを自動的にダウンロードする場合は、次の例に示すように、downloadクエリパラメーターをtrueに設定する必要があります。

https://{MY_SITE}/api/public/content/b2f7bfc7756b4e8891dd9ec54453024a?v=7dbfe11b&download=true

変換

変換を使用して、公開リンク画像に変換を動的に適用できます。 Transformations 、パブリック・リンクの変換設定を表すエンティティがあります。つまり、変換エンティティが作成されると、再生成せずにすべてのパブリック・リンクに直接適用できます。

変換は名前で識別されます。公開リンクURLの名前を使用して、この公開リンクに変換が必要であることをAPIに伝えることができます。

たとえば、次のリンクhttps://{:placeholder-token:}<MY_MEDIA_DELIVERY>{/:placeholder-token:}/api/public/content/{:placeholder-token:}<MY_PUBLIC_LINK>{/:placeholder-token:}?t={:placeholder-token:}myTransformation{/:placeholder-token:}では、t=myTransformationパラメータは、ファイルの提供時にmyTransformationという変換を適用することを公開リンクAPIに通知します。

変換は、ManageページからアクセスするTransformationsページで設定します。変換ごとに、名前、幅、高さ、および品質を設定します。

メモ

変換されたファイルは常にJPEG形式です。

画像のマージ

画像の結合を使用して、複数の公開リンク画像を1つの画像に結合できます。これを行うには、公開リンクURLにbパラメーターを追加します。例えば、次のリンクhttp://{:placeholder-token:}<MY_MEDIA_DELIVERY>{/:placeholder-token:}/api/public/content/{:placeholder-token:}<MY_PUBLIC_LINK>{/:placeholder-token:}?b={:placeholder-token:}<MY_SECOND_PUBLIC_LINK>{/:placeholder-token:},{:placeholder-token:}<MY_THIRD_PUBLIC_LINK>{/:placeholder-token:}では、b={:placeholder-token:}<MY_SECOND_PUBLIC_LINK>{/:placeholder-token:},{:placeholder-token:}<MY_THIRD_PUBLIC_LINK>{/:placeholder-token:} パラメーターは、元の公開リンク(背景画像)と2つの追加の公開リンクとのマージのイニシャルを示しています。

MY_SECOND_PUBLIC_LINK
MY_THIRD_PUBLIC_LINK

MY_SECOND_PUBICLINKMY_THIRD_PUBLIC_LINKは公開リンクの相対URLです。bパラメータは、相対公開リンクURLのカンマ区切りリストです。

大事な

公開リンクで変換を設定すると、公開リンクはJPEGファイルに変換されるため、透過性が失われます。マージに使用する公開リンクが透明であることを確認する必要があります。

手記

最大5つの公開リンクを元のリンクにマージできます。

変換キャッシュ

公開リンクAPIは、コンバージョンリクエストが多すぎる場合にサーバーが過負荷になるのを防ぐために、コンバージョンをキャッシュします。キャッシュとは、変換されたファイルを一時ファイルプロバイダーに格納することを意味します。

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