1. パブリック リンク

パブリック リンク

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

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

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

要求 URL

要求 URL の形式は次のとおりです。

https://{host}/api/public/{apiVersion}/{tenantId}/{resourceType}/{relativeurl}{?download,t,b}

重要

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

次の表は、要求された URL のパラメーターをまとめたものです。

注意

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

名前説明必須
tenantId要求を行ったテナントを識別します。はい
resourceTypeサテライトが使用するパラメーター。はい
relativeurlサテライトが使用するパラメーター。はい
t変形パラメーター。いいえ
b画像のマージ パラメーター。いいえ

有効期限

一定の時間が経過すると期限切れになるようにリンクを設定できます。有効期限を設定しない場合、ファイルは期限切れになりません。ただし、リンクのコンテンツはキャッシュできるため、有効期限が切れた後も、このコンテンツに最大 10 分間はアクセスできます。

リンクを削除しても同様です。キャッシュされている場合、リンクは最大 10 分間利用可能です。

リソース タイプ

すべてのパブリック リンクは、リソース タイプに自動的に関連付けられます。この関連付けにより、パブリック エンドポイントを設定し、次の 2 種類のリソースのみを提供するようにして、柔軟性を高めることができます。

  • コンテンツ - ユーザーによって生成されたリンクの場合。
  • ポータル - システムによって生成されたリンクの場合。

強制ダウンロード

既定では、可能な場合はパブリック リンク ファイルがブラウザに表示されます。ただし、ZIP ファイルなど一部のファイル タイプは、ブラウザに表示することができません。これらのファイル タイプは、自動的にダウンロードされます。

パブリック リンクを自動的にダウンロードする場合は、download クエリ パラメーターを true に設定する必要があります。

例:

https://mysite/api/public/content/b2f7bfc7756b4e8891dd9ec54453024a?v=7dbfe11b&download=true

変形

変形を使用して、パブリック リンク画像に動的に変換を適用できます。

変形は、パブリック リンクの変換設定を表すエンティティです。つまり、変形エンティティが一度作成されると、再生成せずにすべてのパブリック リンクに直接適用できます。

変形は名前で識別されます。パブリック リンクの URL にある名前を使用して、このパブリック リンクに変形が必要なことを API に通知できます。

たとえば、https://MyMediaDelivery/api/public/content/myPublicLink?t=myTransformation というリンクでは t=mytransformation という部分によって、ファイルを提供するときに「myTransformation」という名前の変形を適用したいことをパブリック リンク API に通知します。

変形は、[管理] ページから表示できる [変形] ページで設定できます。それぞれについて、次を設定できます。

  • Name
  • Width
  • Height
  • Quality
注意

変形されたファイルは、常に jpeg フォーマットになります。

画像のマージ

パブリック リンク画像のマージを使用して、複数のパブリック リンク画像を 1 つにマージできます。パブリック リンク画像のマージを使用するには、パブリック リンク URL に b パラメーターを追加します。

たとえば、この http://MyMediaDelivery/api/public/content/myPublicLink?b=mySecondPublicLink,myThirdPublicLink リンクでは、b=mySecondPublicLink,myThirdPublicLink パラメーターによって、元のパブリック リンク (背景画像) を 2 つの追加パブリック リンクとマージするようにリクエストしています。

  • mySecondPublicLink
  • myThirdPublicLink

mySecondPublicLink と myThirdPublicLink は、パブリック リンクの相対 URL です。

b パラメーターは、パブリック リンクの相対 URL のコンマ区切りのリストです。

重要

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

注意

最大 5 つのパブリック リンクを元のリンクにマージできます。

変換キャッシュ

パブリック リンク API は変換をキャッシュして、変換リクエストが多すぎる場合にサーバーが過負荷になるのを防ぎます。キャッシュとは、変換されたファイルを一時ファイル プロバイダーに保存することを意味します。

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