1. パブリック リンク

パブリック リンク

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

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

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

レンディションを公開するには、次の情報を入力する必要があります。

  • レンディション名。
  • レンディションが一般に公開されるパス。たとえば、myasset/mypath (省略可)。
  • 有効期限 (省略可)。

この情報を保存するとリクエストが処理され、リンクが利用可能になります。

有効期限システム

一定の時間が経過すると期限切れになるようにリンクを設定できます。有効期限を設定しない場合、ファイルは期限切れになりません。

ただし、リンクのコンテンツはキャッシュできるため、有効期限が切れた後も最大 24 時間はアクセスできます。

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

リソース タイプ

すべてのパブリック リンクは、リソース タイプに自動的に関連付けられます。この関連付けにより、パブリック エンドポイントを設定し、次の 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 のコンマ区切りのリストです。

重要

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

注意

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

変換キャッシュ

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

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