1. Cloud development

公開リンク

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

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

Sitecore Content Hubのアセット詳細ページで、公開を公開 できます。これは他のファイルとは異なり、事前署名されていないURLでアクセスできることを意味します。静的URLを知っている人は誰でもキャッシュしてファイルを取得することができます。

リクエストURL

リクエストURLの形式は以下の通りです:

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

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

以下の表は、要求されたURLのパラメータを示しています。

パラメータ

概要

RESOURCE_TYPE

URLでアクセス対象のリソースの種類やカテゴリ(画像、ドキュメント、動画など)を特定します。自動生成されます。

RELATIVE_URL

システム内でリソースの相対的な経路や位置を指定します。デフォルトではシステムが値を割り当てますが、URLパスを可読性や整理、特定の要件に合わせてカスタマイズすることも可能です。

V

コンテンツアイテムのバージョン番号。ブラウザキャッシュの期限切れを待たずに最新バージョンを常に取得できるように自動生成されます。バージョンパラメータが公開リンクURLに含まれる かどうか設定 できます。

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://<MY_MEDIA_DELIVERY>/api/public/content/<MY_PUBLIC_LINK>?t=myTransformationでは、t=myTransformationパラメータが公開リンクAPIに、ファイルを提供する際にmyTransformationという変換を適用したいことを知らせます。メディア変換パラメータの例については「 メディア変換 」を参照してください。

必要な権限があれば、Manage > Transformations ページで変換を設定することもできます。各変換ごとに、名前、幅、高さ、品質を設定します。

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

画像統合

画像 マージングを用いて複数のパブリックリンク画像を1つの画像にマージできます。そのためには、パブリックリンクURLにbパラメータを追加してください。例えば、以下のリンクhttp://<MY_MEDIA_DELIVERY>/api/public/content/<MY_PUBLIC_LINK>?b=<MY_SECOND_PUBLIC_LINK>,<MY_THIRD_PUBLIC_LINK>では、b=<MY_SECOND_PUBLIC_LINK>,<MY_THIRD_PUBLIC_LINK> パラメータが元のパブリックリンク(背景画像)とのマージを初期化し、さらに2つのパブリックリンクを追加します。

  • MY_SECOND_PUBLIC_LINK
  • MY_THIRD_PUBLIC_LINK

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

!重要パブリックリンクで変換を設定すると、パブリックリンクはJPEGファイルに変換されるため透明性が失われます。マージに使うパブリックリンクは透明であることを必ず確認してください。

!注元のリンクには最大5つの公開リンクを統合できます。

コンバージョンキャッシュ

パブリックリンクAPIは変換を キャッシュし 、変換リクエストが多すぎたときにサーバーの負荷を抑えます。キャッシュとは、変換済みファイルを一時的なファイル提供者に保存することを意味します。

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