# 購入したファイルをダウンロード

現在オンライン購入は提供していません。`catabricks catalog list` で公開商品を確認するか、[データ利用についてお問い合わせ](/contact?lang=ja)ください。`SALES_DISABLED` または `PAYMENT_NOT_CONFIGURED` の場合は購入の再試行を停止してください。問い合わせだけではファイルへのアクセス権は付与されません。既存注文のダウンロードには、その権限と期限が適用されます。

先に [CLI をインストール](/docs/cli?lang=ja)してください。以下は CLI 0.2.5 の例です。

## 1. ログイン

```sh
catabricks login
```

ブラウザで Google にログインし、ターミナルに表示された端末コードを確認して承認してください。

## 2. 注文 ID を確認

```sh
catabricks orders list
```

取得したい購入済みファイルの `data.items[].id` をコピーします。これが次のコマンドの `ORDER_ID` です。

以下は一部のフィールドだけを示した説明用 JSON です。ID と商品名は実際の注文ではありません。自分の実行結果を使ってください。標準出力はインデント付き JSON で、`--json` を付けると1行になります。

```json
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "93db21a6-0f62-40d9-a4e8-56d7a954c4b2",
        "productTitle": "Example dataset"
      }
    ]
  }
}
```

## 3. ダウンロード

`ORDER_ID` をコピーした注文 ID に置き換えてください。`--output` は保存先のファイルパスです。

```sh
catabricks download ORDER_ID --output ./dataset.zip
```

取得後、CLI がファイルサイズと SHA-256 を検証します。`"ok": true` と保存先が表示されれば完了です。決済が済み、配信準備が完了した注文をダウンロードできます。

中断した場合は、同じ注文とパスに `--resume` を付けて再開します。`.part` と `.part.json` の両方を保持してください。

```sh
catabricks download ORDER_ID --output ./dataset.zip --resume
```

後で再検証するには `catabricks verify ./dataset.zip --order ORDER_ID` を実行します。ダウンロード期間内は繰り返し取得できます。

## 新しく購入するには

購入済みの注文がなければ、公開カタログから確認してください。商品検索にはログイン不要です。

```sh
catabricks catalog list
```

以下も一部のフィールドを示した説明用の例です。`Product.id` は商品確認用、`offerId` は購入用で、異なる ID です。

```json
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "78c3be2a-3f14-4bf2-a219-e985443d3c79",
        "title": "Example dataset",
        "offerId": "d6a92d43-f931-44af-b3b2-8c26f2aa24b8"
      }
    ]
  }
}
```

`PRODUCT_ID` に商品の `id` を入れ、構成・フォーマット・ライセンス・全体価格 `priceKrw`・期間 `downloadHours` を確認します。購入時は商品の `offerId` を `OFFER_ID` に入れてください。

```sh
catabricks catalog show PRODUCT_ID
catabricks buy OFFER_ID --buyer personal
```

`buy` は注文を準備して決済ページを開きます。同じ Google アカウントで金額・条件・購入主体を確認し、ブラウザで決済してください。CLI にカード情報を入力しないでください。実際の商品と価格は現在の検索結果で確認します。

`buy` の結果の `data.orderId` が新しい注文の `Order.id` です。`orders list` では同じ値が `data.items[].id` に表示されます。決済後、この ID で上記のダウンロード手順を進めてください。組織購入は[コマンドリファレンス](/docs/cli/reference?lang=ja)を参照してください。

## セッションを終了

作業後は `catabricks logout` で現在の CLI セッションを終了します。全 CLI セッションを終了する場合は、代わりに `catabricks logout --all` を使います。取得済みのファイルは保持されます。