# YouTube Downloadベストプラクティス

適切なメディア出力を選択し、ダウンロードしたものを制御し、完成したジョブを使用可能なプライベートファイルに変換します。

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/youtube-download-guide
レビュー: FlashData による 2026-11-04

<a id="choose"></a>

## タスクが必要とするものから始める

| あなたの目標 | 利用条件 |
| --- | --- |
| 会話したコンテンツの監視やテキストインデックスの作成 | 既存のトランスクリプトを最初に読みます。 ワークフローが音声そのものを必要とするときだけ音声をダウンロードします。例えば、別々の音声テキストステップなどです。 |
| 音声または音声の処理 | 音声のみ出力。 アプリケーションが使用しないビデオトラックを運ぶことを避けて下さい。 |
| 短納期を表示 | start_at と end_at を設定します。 ソースビデオの期間内にあることを確認してください。 |
| 再生またはビデオの処理 | オーディオとアプリケーションに適した解像度のキャップを備えたMP4。 たとえば、<=720を使用しています。 |

- [キャプションからの要約](https://flashdata.dev/ja/docs/guides/youtube-summary/reference.md)
- [ビデオメタデータを調べる](https://flashdata.dev/ja/docs/guides/youtube-data-guide/reference.md#metadata)

<a id="formats"></a>

## 必要な出力を保存

1つのタブを選択し、リクエスト全体をdownload-request.jsonとして保存します。 video_idをソースに変更します。 下の送信コマンドは、このファイルを読み込みますので、音声またはクリップを選択すると、実際のリクエストが変更されます。

### MP4 / 720p

720p でおおわれた可聴周波の完全なビデオ。

#### download-request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720"
  }
}
```


### MP3

音声ファイルを聞き取り、さらに音声処理を行います。

#### download-request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio",
    "output_format": "mp3"
  }
}
```


### 5-秒クリップ

00:00:05から00:00:10までのMP4の抜粋。 選択したビデオに一致する時間を使用してください。

#### download-request.json

```json
{
  "source": "youtube_download",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "download_type": "audio_video",
    "output_format": "mp4",
    "video_quality": "<=720",
    "start_at": "00:00:05",
    "end_at": "00:00:10"
  }
}
```


- [すべてのフォーマットオプション](https://flashdata.dev/ja/docs/sources/youtube_download/reference.md#parameters)

<a id="prepare"></a>

## 所有者のアクセスとバイトベースの価格をチェックする

利用条件 Bash とりあえず jq保存されると、 CLI プロフィールか FLASHDATA_API_KEY のための HTTP. 鍵はyoutube_downloadの許可を必要とします。 ダウンロードは、所有者のアクセスが必要です。一時的なトライアルアクセスには含まれていません。 CLI の例では、デフォルトプロファイルを使用します。 お使いのコマンドが名前付けられている場合は、--profile NAME をすべてのコマンドに追加します。

| デコレーション | この方法を適用します。 |
| --- | --- |
| 見積り費用 | 推定出力バイトで返されたcreditsPerTbとbytesPerUnitを使用してください。 ダウンロード価格は、リクエストごとに固定料金ではありません。 |
| 制御範囲 | 送信前に、オーディオ、クリップ、解像度のキャップを選択します。 申請書に就職・就労規則を申請してください。 |
| 実際の料金を記録する | 完成した配達からの使用法を読んで下さい。 アップロードが落ちる前にクレジットを保持する場合があります。現在の残高は、ジョブの消費キャップではありません。 |

### 無料チェック・CLI

```bash
flashdata account balance --json
flashdata account pricing --source youtube_download --json
flashdata account limits --json
```

- [オーナーキーのセットアップ](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md)
- [HTTP バランスと価格](https://flashdata.dev/ja/docs/guides/credits-and-billing/reference.md#balance)

<a id="storage"></a>

## 各出力にプライベートな宛先を使用する

storage.jsonをプライベートに保存して、実際の宛先値で保存します。 外部のソース制御を保ちましょう。 異なる使用 object_prefix それぞれ video/output バージョン; 異なる出力のプレフィックスを再利用すると、アプリケーションレコードが難しく、再コンパイルが困難になります。

| 資格情報 | 目的: |
| --- | --- |
| FlashDataキー | ダウンロードを送信して、そのジョブと配信JSONを読んでください。 |
| ストレージのアップロード資格 | 意図した Bucket と prefix にメディアを書き込みます。 |
| アプリケーションストレージのアイデンティティ | 承認されたユーザーへのプライベートオブジェクトまたは問題アクセスを読み込みます。 |

### storage.json · S3

```json
{
  "storage_type": "s3",
  "storage_url": "YOUR_BUCKET",
  "access_key": "YOUR_ACCESS_KEY",
  "secret_key": "YOUR_SECRET_KEY",
  "region": "us-east-1",
  "object_prefix": "media/video-001/mp4-720p-v1"
}
```

### Linux/macOS・専用ファイル

```bash
chmod 600 storage.json
```

- [Windowsファイル許可](https://flashdata.dev/ja/docs/guides/cli-automation/reference.md#storage)
- [その他のストレージプロバイダ](https://flashdata.dev/ja/docs/sources/youtube_download/reference.md#storage)

<a id="submit"></a>

## 保存されたリクエストを一度に送信する

両方のファイルを保存した後に1つのタブを実行します。 コマンドは、stdin を介して storage.json を注入し、download-submission.json を保存します。 この領収書を保管してください。 CLI では、同じ実行 ID をリトライして保持します。新しい ID は、意図的な新しい出力のみを使用します。 HTTPの投稿は、CLIのローカルランジャーナルを使用しません。

### CLI

#### 選択した出力を送信

```bash
(
set -eu
umask 077
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async \
  --run-id download-001 --output download-submission.json
)
```


### HTTP / cURL

#### 選択した出力を送信

```bash
(
set -eu
umask 077
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e download-submission.json || { echo 'Inspect the saved submission first.' >&2; exit 1; }
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST 'https://data.flashdata.dev/v1/queries' \
  --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Content-Type: application/json' \
  --data-binary @- --output download-submission.json
)
```


- [Asyncリクエスト契約](https://flashdata.dev/ja/docs/reference/realtime-and-async/reference.md#async)

<a id="dry-run"></a>

### CLIで最初に検証する

ok: trueとdata.dryRun: trueを期待します。 これは、ジョブを送信せずに入力とFlashDataアクセスをチェックします。 アップロード資格情報は、バケットに書き込むことはできません。

#### 無料ドライラン

```bash
(
set -eu
PAYLOAD=$(jq -en --slurpfile request download-request.json --slurpfile storage storage.json '
  if ($request | length) != 1 or ($storage | length) != 1
      or ($storage[0] | type) != "object" or $request[0].source != "youtube_download"
  then error("Check download-request.json and storage.json")
  else $request[0] | .params.storage = $storage[0] end')
printf '%s' "$PAYLOAD" | flashdata query --input - --mode async --dry-run --json
)
```


<a id="status"></a>

### 既存のジョブの待ち合わせ

投稿レシートはメディアファイルではありません。 CLIが待ちます。HTTPコマンドは一度にステータスを読みます。 期限内に読み込まれるかどうかを繰り返して、完了または失敗するまで繰り返します。 ローカルタイムアウトはサーバージョブをキャンセルしません。

#### CLI

##### 保存されたジョブの待ち合わせ

```bash
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs wait "$JOB_ID"
)
```


#### HTTP / cURL

##### 一度にステータスを読んで下さい

```bash
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
STATUS_URL=$(jq -er '.links[] | select(.rel == "self") | .href' download-submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
  "$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)
```



<a id="delivery"></a>

## 配達記録を読んで、それから媒体にアクセスして下さい

完了後、送信するために使用した同じパスを使用して、delivery.jsonを取得します。 署名された結果 URL は JSON を、結果[0].file_url は保存中の媒体を識別します。 プライベートfile_urlは、アプリケーションが発行するストレージ読み取りIDまたはリンクが必要です。

### CLI

#### 保存 delivery.json

```bash
(
set -eu
JOB_ID=$(jq -er '.remoteId // .id' download-submission.json)
flashdata jobs result "$JOB_ID" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)
```


### HTTP / cURL

#### Fetch の配達 JSON · API のキーのオフの貯蔵の要求を保ちます

```bash
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
jq -e '.job.status == "completed"' job.json >/dev/null
RESULTS_URL=$(jq -er '.links[] | select(.rel == "results") | .href' download-submission.json)
# Get the signed JSON URL without forwarding the API key to storage.
STORAGE_URL=$(curl --fail-with-body --silent --show-error --max-time 30 \
  --header "X-API-Key: $FLASHDATA_API_KEY" --header 'Accept: application/json' \
  --output /dev/null --write-out '%{redirect_url}' "$RESULTS_URL")
: "${STORAGE_URL:?No signed result URL was returned}"
curl --fail-with-body --silent --show-error --compressed --max-time 70 \
  "$STORAGE_URL" --output delivery.json
jq '.results[0] | {file_url, file_size, md5, downloaded_bytes}' delivery.json
)
```



<a id="inspect"></a>

### 配送されたものをチェックする

1つのファイルの場所、肯定的な期待して下さい file_size, , , MD5 ご利用にあたって file_size は、納品されたオブジェクトのレコードです。 downloaded_bytes は、使用中の最終充電の代替ではありません転送フィールドです。

#### delivery.jsonを点検して下さい

```bash
(
set -eu
jq -e '.source == "youtube_download" and .status == "done"
  and (.results | length == 1) and (.results[0].file_size > 0)
  and (.results[0].md5 | test("^[a-fA-F0-9]{32}$"))' delivery.json >/dev/null
jq '{file: (.results[0] | {file_url, file_size, md5, duration, output_format}), usage}' delivery.json
)
```

- [プライベートオブジェクトの確認と提供](https://flashdata.dev/ja/docs/guides/media-delivery-pipeline/reference.md#verify)

<a id="verify-media"></a>

### S3からローカルコピーを確認します

OBJECT_KEY を file_url から配信されたメディアキーに設定します。 AWS CLI を読み取りアクセス、jq および OpenSSL で使用して下さい。 選択したリクエストに応じてmedia.mp4またはmedia.mp3を保存し、既存のローカルファイルを上書きせずにサイズとチェックサムをチェックします。

#### S3 読み込み・新規 FlashData クエリなし

```bash
(
set -eu
# Requires AWS CLI configured for read access, jq and OpenSSL.
# Set OBJECT_KEY to the delivered media object's key from file_url.
: "${OBJECT_KEY:?Set the delivered S3 object key}"
BUCKET=$(jq -er '.storage_url' storage.json)
REGION=$(jq -er '.region' storage.json)
FORMAT=$(jq -er '.params.output_format' download-request.json)
case "$FORMAT" in mp4|mp3) ;; *) echo 'Choose a filename for this format.' >&2; exit 1 ;; esac
LOCAL_FILE="media.$FORMAT"
test ! -e "$LOCAL_FILE" || { echo 'Keep the existing local file.' >&2; exit 1; }
EXPECTED_BYTES=$(jq -er '.results[0].file_size' delivery.json)
EXPECTED_MD5=$(jq -er '.results[0].md5 | ascii_downcase' delivery.json)
aws s3 cp "s3://$BUCKET/$OBJECT_KEY" "$LOCAL_FILE" --region "$REGION" --only-show-errors
ACTUAL_BYTES=$(wc -c < "$LOCAL_FILE" | tr -d '[:space:]')
ACTUAL_MD5=$(openssl dgst -md5 "$LOCAL_FILE" | awk '{print $NF}')
test "$ACTUAL_BYTES" = "$EXPECTED_BYTES"
test "$ACTUAL_MD5" = "$EXPECTED_MD5"
echo 'Delivery verified'
)
```

- [結果の保持と保存媒体](https://flashdata.dev/ja/docs/guides/save-results/reference.md#media)

<a id="operations"></a>

## 失敗した段階から回復する

| 何が起こったのか | 次のアクション |
| --- | --- |
| 提出は確認された仕事ID無しで期限切れ | 保存した CLI の実行やリクエスト履歴を調べます。 元の入力を保ち、再度提出しないで下さい。 |
| 勤務可; 待機時間外 | 同じ仕事を読んで、または回復します。 続行する別のダウンロードを作成しないでください。 |
| アップロード失敗 | ジョブのエラーを読んで、宛先の設定を修正したり、意図的に再試行する前にアクセスを書き込みます。 |
| 媒体は返された403を読みました | ストレージの読み込み権限またはアプリケーション発行されたリンクを確認してください。 FlashData APIキーはS3の鍵を開けません。 |
| 署名された結果 JSON 期限切れ | 結果が保持される間、ジョブ結果のエンドポイントを再度読みます。 保存されたメディアは、あなたのバケットのライフサイクルに従います。 |

### CLI・保存された実行を調べる

```bash
flashdata runs show download-001 --json
```

- [回復決定](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md)
- [エラーとステータスコード](https://flashdata.dev/ja/docs/errors/reference.md)
- [定期実行タスク](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md)

<a id="agent"></a>

## 代理店に出力および配達条件を与えて下さい

### エージェントのタスク · ビデオ、目的地、予算を供給

```text
保存した所有者のアクセスと構成されたプライベートストレージを使用します。
フィードバック download-request.json 映像や出力のため、サイレントに変更しないでください。
承認されたタスク予算に対して、ダウンロード価格設定と利用可能なクレジットを確認してください。
一度に送信し、run/job IDを保存し、そのジョブを完了に読みます。
配信記録を保存します。 保存したオブジェクトのサイズと、処理する前に MD5 を検証します。
オブジェクトの場所、選択した形式、検証結果、実際の使用状況を報告します。
提出が不確実な場合は、保存された作業を検査してください。交換アクセスや別のダウンロードを作成しないでください。
ストレージの認証情報をプライベートに保ちます。 アプリケーションの設定されたアクセス制御を介してメディアを共有する。
```

- [アプリケーションパイプラインの構築](https://flashdata.dev/ja/docs/guides/media-delivery-pipeline/reference.md)
