ドキュメントを探す
はじめに
タスクで選択し、メタデータ応答を1つ比較し、キャプションの承認と使用コストを確認します。
このページの内容
タスクで選ぶ
FlashDataはGoogleのYouTube Data APIからの別のサービスです。 認証情報、応答フィールド、課金モデルが異なります。
ひと目で
| タスク | YouTube Data APIの公式 | FlashData |
|---|---|---|
| 動画のメタデータ | videos.list | youtube_metadata |
| 検索と発見 | YouTubeリソースのクエリとページネーション。 | 標準/拡張検索、チャネルおよび提案。 |
| キャプショントラック | 正規のキャプション操作; ダウンロードは、ビデオの編集権限を必要とします。 | 要求された言語とキャプションソースの既存のトラックを取得します。 |
| 口座変更 | アップロードされたアップロードとその他の許可された書き込みを文書化しました。 | 取得および配達;YouTubeの記述の変異無し。 |
| メディアファイル | ビデオリソースの応答はメタデータです。 | 背景は、ストレージにダウンロードします。 |
1つのメタデータリクエストを比較する
Bash、cURLおよびjqを使用して下さい。 Google では、YouTube Data API v3 をプロジェクトで有効化し、GOOGLE_API_KEY を設定できます。 FlashData では、FLASHDATA_API_KEY を youtube_metadata 権限で設定します。 各タブは1つのリクエストを作成し、その応答を保存します。評価したいプロバイダを実行します。
(
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
)(
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
)結果フィールドをマップする
成功した応答には、要求されたビデオが含まれています。 空の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 | 所要時間・秒 |
キャプションアクセスを別々にチェック
Googleのcaptions.downloadはOAuthの承認および許可を要求し、ビデオを編集します。 FlashData は既存のトラックを取り出します: 自動キャプションに Transcript のデフォルト; デフォルトでは、uploader-provided のトラックをキャプションします。 出力を比較するときに言語と自動を明示的に指定します。
FlashDataは、転写や翻訳を生成しません。 ライセンス・ラベルのソースは、クリエイティブ・コモンズのメタデータを報告します。トレーニングの権利を付与したり、クリエイターの別のトレーニング・パーミッションの設定を読んでいません。
1つの動画からコレクションへ移動
入力に一致するFlashDataワークフローを選択します。 標準的な調査は20に要求された結果まで受け入れます; 拡張検索は、700を別々のレートで受け付けます。
| 導入事例 | ワークフロー |
|---|---|
| トピックまたは検索クエリ | 標準または拡張検索 → ビデオ IDs → メタデータを保存します。 |
| リクエストの小さなリスト | パートごとの結果と定期的なバッチ投稿。 |
| ビデオのファイル IDs | Bulkメタデータ、トランスクリプト、キャプション、ライセンスラベル、ダウンロード |
クォータとクレジットを比較する
Google は、プロジェクト クォータとメソッド固有のコストを適用します。 FlashDataは、共有アカウントのクレジットとソース固有のレートを使用しており、ダウンロードの使用は、配信されたメディアバイトに基づいて行われます。 実際に使うメソッド、プラン料金、ワークロードをチェックしてください。