--- title: "公開リンク" slug: "public-links" abstract: "公開の方法、公開リンクの生成、リンクの有効期限の設定、画像の統合、変換の適用方法。" --- # 公開リンク Sitecore Content Hubのアセット詳細ページで、公開を公開 [できます](https://doc.sitecore.com/ch/en/users/content-hub/create-public-links.html)。これは他のファイルとは異なり、事前署名されていない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に含まれる [かどうか設定](https://doc.sitecore.com/ch/en/users/content-hub/settings.html) できます。 t [変換](https://doc.sitecore.com/ch/ja/developers/cloud-dev/public-links.html#UUID-a1bacda5-e48e-d86e-a14d-bda112c63112_N1731673293933)パラメータ。ユーザー生成。オプション。 b [画像マージ](https://doc.sitecore.com/ch/ja/developers/cloud-dev/public-links.html#UUID-a1bacda5-e48e-d86e-a14d-bda112c63112_N1731673306277)パラメータ。ユーザー生成。任意。 ## 有効期限と時刻 公開リンクは一定時間後に期限切れになるように設定できます。有効期限と時間を設定しなければ、そのファイルは期限切れになりません。リンク内容はキャッシュできるため、期限切れ後も最大10分間はアクセス可能です。同様に、リンクを削除してリンクがキャッシュされている場合、最大10分間は利用可能です。 ## 資源の種類 すべてのパブリックリンクはリソースタイプに関連付けられています。この関連付けにより、パブリックエンドポイントは2種類のリソースのみにサービスを提供するように設定できます。 - *Content* - ユーザーによって生成されたリンク用。 - *Portal* - システムによって生成されたリンクに対して。 ## フォースダウンロード デフォルトでは、可能であればブラウザ上で公開リンクファイルが表示されます。ただし、ZIPファイルのような一部のファイル形式は表示できません。これらのファイル形式は自動的にダウンロードされます。 公開リンクを自動ダウンロードしたい場合は、downloadクエリパラメータをtrueに設定する必要があります。以下の例に示されています。 https://{MY\_SITE}/api/public/content/b2f7bfc7756b4e8891dd9ec54453024a?v=7dbfe11b&download=true ## 変換 変換を用いて、公開リンク画像に対して動的に変換を適用できます。 *Transformations*は公開リンクの変換構成を表すエンティティです。つまり、変換エンティティが作成されたら、再生成せずにすべての公開リンクに直接適用できます。 変換は名前で識別されます。公開リンクURLでその名前を使って、APIにこの公開リンクに変換が必要であることを伝えることができます。例えば、次のリンクhttps:///api/public/content/?t=myTransformationでは、t=myTransformationパラメータが公開リンクAPIに、ファイルを提供する際に*myTransformation*という変換を適用したいことを知らせます。メディア変換パラメータの例については「 [メディア変換](https://doc.sitecore.com/ch/ja/developers/cloud-dev/media-transformations.html "Media transformations") 」を参照してください。 必要な権限があれば、**Manage** > **Transformations** [ページで変換を設定する](https://doc.sitecore.com/ch/en/users/content-hub/create-a-transformation.html)こともできます。各変換ごとに、名前、幅、高さ、品質を設定します。 > !注変換されたファイルは常にJPEG形式です。 ## 画像統合 画像 [マージング](https://doc.sitecore.com/ch/en/users/content-hub/create-layered-images.html)を用いて複数のパブリックリンク画像を1つの画像にマージできます。そのためには、パブリックリンクURLに**b**パラメータを追加してください。例えば、以下のリンクhttp:///api/public/content/?b=,では、b=, パラメータが元のパブリックリンク(背景画像)とのマージを初期化し、さらに2つのパブリックリンクを追加します。 - MY\_SECOND\_PUBLIC\_LINK - MY\_THIRD\_PUBLIC\_LINK MY\_SECOND\_PUBICLINKMY\_THIRD\_PUBLIC\_LINKは公開リンクの相対的なURLです。bパラメータはカンマ区切りの相対的な公開リンクURLのリストです。 > !重要パブリックリンクで変換を設定すると、パブリックリンクはJPEGファイルに変換されるため透明性が失われます。マージに使うパブリックリンクは透明であることを必ず確認してください。 > !注元のリンクには最大5つの公開リンクを統合できます。 ## コンバージョンキャッシュ パブリックリンクAPIは変換を [キャッシュし](https://doc.sitecore.com/ch/en/users/content-hub/set-up-a-custom-cdn.html) 、変換リクエストが多すぎたときにサーバーの負荷を抑えます。キャッシュとは、変換済みファイルを一時的なファイル提供者に保存することを意味します。