> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# リンクと共有

> Blob Storage の公開 URL、一時リンク、共有リンク: それぞれの使いどころ、有効期間、ファイルの公開範囲が変わったときの動作。

Blob Storage には、ファイルを誰かに渡す方法が 3 つあります。リンクの有効期間の長さと、後から取り消す必要があるかどうかで選んでください。

|             | 公開 URL                                                     | 一時リンク                                                 | 共有リンク                                              |
| ----------- | ---------------------------------------------------------- | ----------------------------------------------------- | -------------------------------------------------- |
| 作成元         | [オブジェクトのアップロード](/ja/blob-reference/endpoint/post) (公開ファイル) | [オブジェクトのダウンロード](/ja/blob-reference/endpoint/download) | [共有の作成](/ja/blob-reference/endpoint/shares-create) |
| アドレス        | `blob.squarecloud.dev/pub/...`                             | `files.squarecloud.dev/d/...`                         | `files.squarecloud.dev/s/...`                      |
| 対象          | 公開ファイル                                                     | 公開ファイルとプライベートファイル                                     | 公開ファイルとプライベートファイル                                  |
| 有効期間        | ファイルが公開されている間                                              | 60 秒〜24 時間                                            | 60 秒〜30 日                                          |
| 取り消し        | ファイルをプライベートにする                                             | 不可                                                    | 可能                                                 |
| ダウンロード回数の上限 | なし                                                         | なし                                                    | 任意、1〜10000                                         |
| パスワード       | なし                                                         | なし                                                    | 任意 (Pro と Enterprise)                              |
| 配信元         | グローバル CDN                                                  | Blob Storage                                          | Blob Storage                                       |

## 公開 URL

公開ファイルには CDN 上の恒久的な URL があります。

```
https://blob.squarecloud.dev/pub/<user_id>/<path>
```

埋め込むアセットに使用します: サイト上の画像、ボットの添付ファイル、他のサービスが取得するファイルなどです。2026年9月のアップデート以前に保存されたレガシーファイルは、`https://public-blob.squarecloud.dev/<user_id>/<path>` 上の URL を 30 日間（2026年10月25日まで）保持します。[Object Copy](/ja/blob-reference/endpoint/copy)（`move: true`）で移動すると、`blob.squarecloud.dev` 上の URL を取得できます。

<Tip>`security_hash=true` (プライベートファイルと、名前を指定しないアップロードトークンのデフォルト) の場合、パスにランダムな接尾辞が付くため、名前から URL を推測されることはありません。</Tip>

## 一時リンク

[オブジェクトのダウンロード](/ja/blob-reference/endpoint/download)は、1 つのファイルへのリンクに署名します。有効期間は 60 秒から 24 時間 (デフォルトは 1 時間) です。プライベートファイルを今すぐ届けるときに使用します: ダウンロードボタン、メールの添付、バックエンドが別のサービスに渡すファイルなどです。

* リンクに認証情報は不要で、**取り消すことはできません**。リンクが機能しなくなるのは、期限切れになったとき、またはファイルが削除、移動されたり公開範囲が変わったりしたときだけです。有効期間は短くしてください。
* `Range` (再開可能なダウンロードや動画のシーク) と条件付きリクエスト (`If-None-Match`、`If-Modified-Since`) に対応しています。
* ダウンロードを強制し、ブラウザが保存するファイル名を指定できます (`disposition` と `filename`)。
* これらの上書き指定がない公開ファイルの場合、オブジェクトのダウンロードは公開 URL そのものを返します。
* 1 つのリンクは IP あたり 1 分間に 60 リクエストを受け付けます。これに加えて、アカウントのすべてのリンクに全体の制限があります。超えるとプレーンテキストで `429` を返します。1 つのファイルを多くの人に渡すには、ファイルを公開してください: 公開ファイルは CDN から配信され、この制限はありません。期限切れまたは無効なリンクは `404` を返します。

## 共有リンク

[共有の作成](/ja/blob-reference/endpoint/shares-create)は、独自のページを持つリンクを作成します。プログラムではなく人向けのリンクです: クライアントへのファイル送付、チームへのレポート、テスターへのビルドなどに使います。

* 有効期間は 60 秒から 30 日 (デフォルトは 24 時間) です。
* [共有の削除](/ja/blob-reference/endpoint/shares-delete)でいつでも**取り消す**ことができ、[共有の一覧](/ja/blob-reference/endpoint/shares-list)に表示されます。
* `max_downloads` はファイルをダウンロードできる回数を制限します。同時ダウンロードがあってもカウントは正確です。上限に達すると、リンクは `410` を返します。
* **Pro と Enterprise** では、`password` を指定するとダウンロード前にページがパスワードを要求します。誤った試行は IP ごと、リンクごとに制限されます。ダウングレード前に作成されたパスワード付きリンクは、パスワードを保持します。
* ページは訪問者のブラウザの言語 (英語、ポルトガル語、スペイン語、フランス語、ドイツ語、イタリア語、日本語、中国語) に従います。
* アカウントは最大 1000 件の有効な共有リンクを持てます。
* プライベートファイルのダウンロードは一時リンクを経由するため、同じ制限が適用されます: IP あたり 1 分間に 60 リクエスト、およびアカウント全体の制限。

共有リンクは、リンク作成時点のファイルに紐付けられます。ファイルを削除、移動、名前変更したり、公開範囲を変更したりすると、リンクはすぐに `404` を返します。これはパスワードページより前に判定され、ダウンロード回数も消費しません。次にアクセスがあった時点で、リンクは[共有の一覧](/ja/blob-reference/endpoint/shares-list)から削除されます。

<Warning>
  **公開**ファイルへの共有リンクは、最終的にファイルの恒久的な公開 URL へリダイレクトします。リンクを開いた人はその URL を取得でき、リンクを経由せずに再びファイルをダウンロードできます。そのため、パスワード、ダウンロード回数の上限、有効期限が本当に保護できるのは**プライベート**ファイルだけです。保護が重要な場合は、プライベートファイルを共有してください。
</Warning>

## ファイルをプライベートまたは公開にする

公開範囲は[オブジェクトの更新](/ja/blob-reference/endpoint/update) (`private: true` または `false`) で変更するか、[オブジェクトのコピー](/ja/blob-reference/endpoint/copy)でコピーする際に変更します。

* オブジェクトの **id が変わります**: `pub/...` は `prv/...` になり、その逆も同様です。レスポンスの新しい `id` を保存してください。
* **ファイルをプライベートにする**と、リクエストが応答する前に公開コピーが削除されます。公開 URL は機能しなくなり、CDN キャッシュからは約 60 秒で削除されます。公開コピーを削除できなかった場合、オブジェクトは `VISIBILITY_CHANGE_FAILED` を返して**公開されたまま**になるため、再試行できます。
* **ファイルを公開する**には有料プランが必要です。プライベートにすることは、プランがなくても常に可能です。
* ファイルへの共有リンクと一時リンクは古い id を指しているため、機能しなくなります。新しい id に対して新しいリンクを作成してください。

<Warning>公開されていたファイルは、プライベートにする前に他者にダウンロードまたはキャッシュされている可能性があります。機密性の高いファイルは最初からプライベートでアップロードしてください (`private=true`)。</Warning>