# FlashData と公式 YouTube Data API の比較

タスクで選択し、メタデータ応答を1つ比較し、キャプションの承認と使用コストを確認します。

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

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

## タスクで選ぶ

FlashDataはGoogleのYouTube Data APIからの別のサービスです。 認証情報、応答フィールド、課金モデルが異なります。


<a id="comparison"></a>

### ひと目で

| タスク | YouTube Data APIの公式 | FlashData |
| --- | --- | --- |
| 動画のメタデータ | videos.list | youtube_metadata |
| 検索と発見 | YouTubeリソースのクエリとページネーション。 | 標準/拡張検索、チャネルおよび提案。 |
| キャプショントラック | 正規のキャプション操作; ダウンロードは、ビデオの編集権限を必要とします。 | 要求された言語とキャプションソースの既存のトラックを取得します。 |
| 口座変更 | アップロードされたアップロードとその他の許可された書き込みを文書化しました。 | 取得および配達;YouTubeの記述の変異無し。 |
| メディアファイル | ビデオリソースの応答はメタデータです。 | 背景は、ストレージにダウンロードします。 |

- [GoogleのAPIの概要](https://developers.google.com/youtube/data/getting-started)

<a id="metadata"></a>

## 1つのメタデータリクエストを比較する

Bash、cURLおよびjqを使用して下さい。 Google では、YouTube Data API v3 をプロジェクトで有効化し、GOOGLE_API_KEY を設定できます。 FlashData では、FLASHDATA_API_KEY を youtube_metadata 権限で設定します。 各タブは1つのリクエストを作成し、その応答を保存します。評価したいプロバイダを実行します。

### FlashData

#### Bash・flashdata-metadata.json

```bash
(
set -euC
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 120 \
  'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "source": "youtube_metadata",
  "video_id": "jNQXAC9IVRw",
  "params": {
    "include_formats": false,
    "include_chapters": false
  }
}' > flashdata-metadata.json
jq -e '.status == "done"' flashdata-metadata.json >/dev/null
jq '.results | map({video_id: .videoId, title, channel, duration_seconds: .duration})' \
  flashdata-metadata.json
)
```


### YouTube APIの公式

#### Bash・official-metadata.json

```bash
(
set -euC
: "${GOOGLE_API_KEY:?Set GOOGLE_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 30 --get \
  'https://www.googleapis.com/youtube/v3/videos' \
  --data-urlencode "key=$GOOGLE_API_KEY" \
  --data-urlencode 'part=snippet,contentDetails' \
  --data-urlencode 'id=jNQXAC9IVRw' > official-metadata.json
jq '.items | map({video_id: .id, title: .snippet.title,
  channel: .snippet.channelTitle, duration_iso8601: .contentDetails.duration})' \
  official-metadata.json
)
```


- [FlashDataキーを設定する](https://flashdata.dev/ja/docs/guides/http-quickstart/reference.md#prepare)
- [videos.list](https://developers.google.com/youtube/data/reference/rest/v3/videos/list)
- [FlashDataメタデータスキーマ](https://flashdata.dev/ja/docs/sources/youtube_metadata/reference.md#response)

<a id="fields"></a>

### 結果フィールドをマップする

成功した応答には、要求されたビデオが含まれています。 空のitems/results配列は、マッチングレコードが返されないことを意味します。 元の応答とマップフィールドをアプリケーションに明示的に保持します。

| バリュー | 正式な対応 | FlashData応答 |
| --- | --- | --- |
| 動画 ID | items[0].id | results[0].videoId |
| タイトル | items[0].snippet.title | results[0].title |
| チャンネル名 | items[0].snippet.channelTitle | results[0].channel |
| 再生時間 | contentDetails.duration・ISO 8601 | 所要時間・秒 |


<a id="captions"></a>

## キャプションアクセスを別々にチェック

Googleのcaptions.downloadはOAuthの承認および許可を要求し、ビデオを編集します。 FlashData は既存のトラックを取り出します: 自動キャプションに Transcript のデフォルト; デフォルトでは、uploader-provided のトラックをキャプションします。 出力を比較するときに言語と自動を明示的に指定します。

FlashDataは、転写や翻訳を生成しません。 ライセンス・ラベルのソースは、クリエイティブ・コモンズのメタデータを報告します。トレーニングの権利を付与したり、クリエイターの別のトレーニング・パーミッションの設定を読んでいません。

- [Googleのキャプションの条件](https://developers.google.com/youtube/data/reference/rest/v3/captions/download)
- [言語を選択し、追跡する](https://flashdata.dev/ja/docs/guides/youtube-data-guide/reference.md#captions)
- [ライセンスラベルフィールド](https://flashdata.dev/ja/docs/sources/youtube_trainability/reference.md)

<a id="workflows"></a>

## 1つの動画からコレクションへ移動

入力に一致するFlashDataワークフローを選択します。 標準的な調査は20に要求された結果まで受け入れます; 拡張検索は、700を別々のレートで受け付けます。

| 導入事例 | ワークフロー |
| --- | --- |
| トピックまたは検索クエリ | 標準または拡張検索 → ビデオ IDs → メタデータを保存します。 |
| リクエストの小さなリスト | パートごとの結果と定期的なバッチ投稿。 |
| ビデオのファイル IDs | Bulkメタデータ、トランスクリプト、キャプション、ライセンスラベル、ダウンロード |

- [ビデオリストをエンリッチ](https://flashdata.dev/ja/docs/guides/enrich-youtube-videos/reference.md)
- [Bulkメタデータレシピ](https://flashdata.dev/ja/docs/guides/bulk-metadata-recipe/reference.md)

<a id="billing"></a>

## クォータとクレジットを比較する

Google は、プロジェクト クォータとメソッド固有のコストを適用します。 FlashDataは、共有アカウントのクレジットとソース固有のレートを使用しており、ダウンロードの使用は、配信されたメディアバイトに基づいて行われます。 実際に使うメソッド、プラン料金、ワークロードをチェックしてください。

- [Google クォータのコスト](https://developers.google.com/youtube/data/determine_quota_cost)
- [FlashDataクレジットと価格設定](https://flashdata.dev/ja/docs/guides/credits-and-billing/reference.md)
