# Apify YouTube データの代替

FlashData と Apify YouTube アクターを比較します。アクター固有の価格、月々の使用予算、メタデータとキャプションのワークフロー、実行可能な Python および Bash の移行例。

アクターの実行から直接のビデオ検索まで。既知の IDs から開始し、アプリケーション フィールドを保持し、残りのパイプラインを変更する前に 1 つのプロデューサーを移動します。

Apifyの事実は、2026-11-10を見直しました。 FlashData レートおよび試験手当は、現在の公開カタログを使用します。

- [特長](#features)
- [俳優の価格設定](#actors)
- [料金を比較](#costs)
- [ルックアップを移行する](#migration)
- [データセットとスケジュール](#production)
- [AIエージェント向け](#agents)
- [よくある質問](#faq)

<a id="features"></a>
## 機能別の比較

### ターゲットを絞った検索を経済的に維持する

| 特徴 | FlashData | Apify YouTube 俳優 |
| --- | --- | --- |
| 月々のサブスクリプションなしの有料使用 | はい — 従量課金制クレジット。 $10からのチャージ | 無料予算、その後有料プラン — $5/月 無料; Starter $19/月 $19 を使用 |
| 1,000 既知のビデオ IDs のメタデータ | $0.50 — 従量課金制の利用料金 | $3.00 — streamers/youtube-scraper・Starterレート、プランの予算から差し引いた |
| 1 つのビデオ ルックアップ | はい — 明示的な 1 つの video_id | 俳優に依存する — ストリーマーはそれをサポートしています。 API Dojo では現在、単一ビデオ URLs を除外しています |

### アプリに必要なビデオを見つけて充実させます

| 特徴 | FlashData | Apify YouTube 俳優 |
| --- | --- | --- |
| 検索フィルターによるキーワード検出 | はい — 日付、期間、タイプ、並べ替えフィルター | はい — searchQueries プラス並べ替え、日付、ビデオフィルター |
| タイトル、チャンネル、エンゲージメントデータ | はい — ビデオによる専用のメタデータ検索 ID | はい — Actor データセット内のビデオ レコード |
| メタデータをキャプションとは別に更新する | はい — リフレッシュには youtube_metadata のみをリクエストしてください | はい — transcriptionAndSubtitle=NONE を指定して実行します |

### 申請用のキャプション証拠を準備する

| 特徴 | FlashData | Apify YouTube 俳優 |
| --- | --- | --- |
| 既存のキャプション言語をいくつか選択してください | 最大 10 の明示的な言語 — 1 つのトランスクリプト要求で言語ごとのエラーを追跡します | 主役: 1 つの言語または任意の言語 — 異なるアクターが異なる入力を公開できる |
| 厳密なキャプションのオリジンを選択してください | アップローダーまたは YouTube で生成された — params.auto は 1 つの原点を選択します。クロスオリジンフォールバックなし | 主演：出身地嗜好 — preferAutoGeneratedSubtitles は優先順位であり、同じ契約ではありません |
| 出典引用のタイムスタンプ付きテキスト | 正規化された JSON セグメント — 秒単位で start/end 回のテキストメッセージを送信します | SRT、VTT、または XML 字幕 — 選択した字幕形式を解析して引用タイミングを確認します |
| 要約用のプレーンテキスト | セグメントの横にfullText | 平文字幕形式 — または、時間指定された字幕出力を解析して結合します |
| 既存のトランスクリプトのないビデオ | 不足しているトラックを報告する — 音声からテキストへの生成はありません | オプションの AI 文字起こし — フォールバックまたは常に転写モード。別途利用料金 |

### 少ない統合コードでワークフローを実行

| 特徴 | FlashData | Apify YouTube 俳優 |
| --- | --- | --- |
| アクターのリソースを管理せずに直接結果が得られる | リアルタイム結果[] + 使用状況 — アクター ID なし、ビルドまたはメモリ設定 | アクターの実行 + 入力スキーマ — 同期エンドポイントは 1 回の HTTP 呼び出しで結果を返すこともできます |
| ブラウザコンソールで保存されたリストを処理する | Bulk Jobs ビデオ付き - ID ファイル — 進行状況を追跡し、マニフェストと結果部分を取得します | URL 入力を備えたアクター コンソール — CSV または Google シートのインポートをサポート |
| クライアントが切断された後のバックグラウンドの結果 | 保存済み async または一括ジョブ ID — ステータスチェックを再開し、completed 出力を取得します | 保存されたアクターの実行とデータセット IDs — 実行を検査し、そのデータセット項目を取得します |
| アプリケーションとエージェントの出力形式 | JSON、プレーンテキストまたはMarkdown | データセットのエクスポート — JSON、CSV、Excel およびその他の形式 |
| 定期的な収集 | スケジューラーまたはエージェントホスト — 所有者の資格情報と保存されたジョブの状態を再利用する | ホストアクターのスケジュール — Cron、タイムゾーン設定、およびオプションの Webhook |
| メタデータ、キャプション、および Google 検索を 1 つの API 契約で実行 | 1 つのクエリ API、ソース固有の権限 — 共有アカウント残高;ソース固有の価格 | 共有プラットフォーム。アクター固有のスキーマ — 関連するアクターの入力と出力を選択して維持する |
| CLI、SDK、自動化用のMCP | はい — スタンドアロン CLI; Python、TypeScript、および Go SDK。 MCP | はい — Apify CLI、Python/JavaScript クライアントおよび MCP |

別のアクターが指定されていない限り、アクター固有の行はストリーマー/youtube-scraper を参照します。どちらのサービスも SDK CLI と MCP を提供します。 Apify は、カスタム コード、ホストされたスケジュール、他の Web サイトのスクレイパーも実行します。

### 1 つのビデオのルックアップを小さくする

ビデオ ID を渡し、メタデータを直接受け取ります。ジョブにプラットフォームのサブスクリプションやチャネル クロールが必要ない場合は、従量課金制アクセスを使用します。

### アプリケーションのデータモデルを維持する

アプリが実際に読み取るフィールドをマップします。 null カウントを保持し、公開日を明示的に保ち、以前にデータセット項目を読んだ消費者のために JSON 配列を保存します。

### 発見を強化とは別にする

有用な検出ワークフローを継続し、ビデオ IDs を重複排除し、製品に必要なビデオのみ FlashData で強化します。

<a id="actors"></a>
## Apify YouTube という単一の価格はありません

Actor の作者は入力、出力および価格設定モデルを選びます。 これら3人の俳優は、一人のイベントで使われていますが、異なる機能を持っています。 下記の価格は1,000ごとのUSDはビデオを返しました。

| 俳優 | 無料 / 1,000 ビデオ | Starter | Scale | Business | 用途に合わせて選んでください |
| --- | --- | --- | --- | --- | --- |
| streamers/youtube-scraper | $4.00 | $3.00 | $2.60 | $2.40 | ビデオ URLs、ディスカバリー、およびオプションの既存の字幕。これが電卓のアクターです。 |
| streamers/youtube-channel-scraper | $1.30 | $1.00 | $0.80 | $0.50 | 基本的なビデオ データを使用したチャンネル検出。これは、任意の ID の完全なメタデータ検索ではありません。 |
| apidojo/youtube-scraper | $0.50 | $0.50 | $0.50 | $0.50 | ディスカバリー入力。現在の README では単一ビデオ URLs が除外されており、入力ごとに少なくとも 10 ビデオが必要です。無料デモ: 5 実行/月、最大10 アイテム/run. |

セルフサービスの月額プラン: Starter は Bronze、Scale は Silver、Business は Gold にマッピングされます。安価な発見アクターは、既知のビデオ計算機に置き換えられません。

### 課金対象イベントを確認する

Apify は、イベントごとの支払い、使用量ごとの支払い、および複合モデルをサポートします。ストリーマー/youtube-scraper の場合、結果イベントと選択したアドオンをカウントします。一般的なコンピューティング料金を自動的に追加しないでください。自分のアクター実行のイベントの内訳を調べます。

### 既存の字幕を AI 文字起こしから分離する

メイン アクタは、結果に既存の字幕を含めることができます。 AI 文字起こしは、ビデオごとに開始分ごとに請求されます。Starter では、10 分のビデオは、$0.003 結果イベントの前に $0.41 を追加します。 AI の概要、説明、チャネル日付フィルタリングにも独自のイベント価格があります。 FlashData は既存のトラックを取得します。欠落したキャプションは生成されません。

### 発見を強化とは別にする

既知のビデオ IDs がアプリにすでに存在する場合は、それを使用します。検出クロールでは、使用していないビデオが返されることがあります。予算の発見とその後の充実は個別に行います。

<a id="costs"></a>
## 本体料金と月額料金を比較する

USD、月間リストプラン。このモデルでは、ストリーマーの結果イベント/youtube-scraper、入力ごとに 1 つのビデオが返されますID、日付フィルタリングと AI アドオンがオフになっています。既存の字幕は ALWAYS_SUBTITLES 設定を使用します。メタデータとキャプションは 1 つのアクター結果ですが、2 つの FlashData リクエストです。 FlashData 価格は現在の YouTube データカタログに基づいています。追加の使用量が追加される前に、各プランに含まれる残高全体がこのワークフローに割り当てられます。 Apify $5 の予算内で無料で停車します。有料プランでは、含まれている予算を超える使用量が追加されます。 FlashData 残高ゼロからの購入には、追加クレジットが必要な場合の $10 の最小チャージが含まれます。税金、年間割引、その他のアクター、個別の保管料金/export およびfailed の試行は除外されます。動画がゼロの場合でも、選択した有料プランには月額料金がかかります。ビデオあたりの実効コストは定義されていません。

### Apify プラットフォーム計画

| Apifyプラン | 月額料金 | 含まれる使用量/月 | 主な俳優 / 1,000 ビデオ | この予算内での動画 |
| --- | --- | --- | --- | --- |
| 無料 | $0.00 | $5.00 | $4.00 | 1,250 |
| Starter | $19.00 | $19.00 | $3.00 | 6,333 |
| Scale | $199.00 | $199.00 | $2.60 | 76,538 |
| Business | $999.00 | $999.00 | $2.40 | 416,250 |

これらのカウントにより、アドオンや他のプラットフォームを使用せずに、結果のイベントに予算全体が割り当てられます。他のアクターに Apify を保持すると、そのサブスクリプションは残ります。増分使用量を残りの予算と比較します。

### FlashData YouTube データプラン

| FlashDataプラン | 1,000 リクエストごと | 月額料金 | 月間リクエスト枠 |
| --- | --- | --- | --- |
| 従量課金 | $0.50 | $0.00 | 0 |
| Micro | $0.40 | $49.00 | 125,000 |
| Starter | $0.35 | $199.00 | 571,428 |
| Pro | $0.30 | $499.00 | 1,666,666 |
| Scale | $0.25 | $999.00 | 4,000,000 |
| Business | $0.20 | $1,999.00 | 10,000,000 |

これらは標準の YouTube データ速度です。拡張検索とダウンロードには別の価格がかかります。 [完全な価格設定](https://flashdata.dev/ja/pricing/youtube-data)。

### 作業例

FlashData 従量課金制と Apify Starter およびストリーマー/youtube-scraper. メタデータと既存の字幕は 1 つのアクター結果イベントですが、2 つの FlashData リクエストです。これらは使用量と毎月のコストの見積もりであり、同一の応答フィールドを主張するものではありません。

| 動画 | ワークフロー | FlashData リクエスト | FlashData モデル化された使用法 | アクターイベントの使用法 | 月額Apify 手数料込み |
| --- | --- | --- | --- | --- | --- |
| 1,000 | 既知のビデオ IDs のメタデータ | 1,000 | $0.50 | $3.00 | $19.00 |
| 1,000 | メタデータ + 既存のキャプション | 2,000 | $1.00 | $3.00 | $19.00 |
| 10,000 | 既知のビデオ IDs のメタデータ | 10,000 | $5.00 | $30.00 | $30.00 |
| 10,000 | メタデータ + 既存のキャプション | 20,000 | $10.00 | $30.00 | $30.00 |
| 100,000 | 既知のビデオ IDs のメタデータ | 100,000 | $50.00 | $300.00 | $300.00 |
| 100,000 | メタデータ + 既存のキャプション | 200,000 | $100.00 | $300.00 | $300.00 |

残高ゼロからの FlashData の購入には、$10 の最低チャージ額があります。 Apify の料金には、含まれている使用量がすでに含まれています。その使用法を 2 回追加しないでください。 HTML 計算ツールを使用すると、両方のプランを個別に選択できます。

### 無料アクセス

Apify 無料には $5 の月間共有予算があります。個々のアクターのデモ制限も適用される場合があります。上記の API Dojo Actor では、無料のデモ実行は月あたり 5 回、実行ごとに 10 アイテムに制限されています。

4,000標準YouTubeデータ要求までの初期の許容値を受け取ることができる適格な検証済みFlashDataサインアップ。 毎月のリセットは行いません。

<a id="migration"></a>
## データセット リーダーを保持します。 1 つのルックアップを置き換える

既知の公開ビデオ ID から始めます。この例では、選択したよく知られた Actor フィールドを JSON 配列として書き込み、完全な FlashData 応答を個別に保存します。

### 1。アクセスを設定し、リクエストをマップする

[API キー](https://flashdata.dev/app/api-keys) で youtube_metadata 権限を持つキーを作成または再利用し、[利用可能なクレジット](https://flashdata.dev/app/billing) にチェックを入れます。エージェントは、最初にアクセスを再利用するか、対象となるトライアルを使用する必要があります。キーはチャットの外に保管してください。

既存のアクター呼び出し (移行の参照用):

```bash
# The existing Actor call, shown for migration reference.
curl --fail-with-body --silent --show-error --max-time 310 \
  --request POST \
  'https://api.apify.com/v2/acts/streamers~youtube-scraper/run-sync-get-dataset-items' \
  --header "Authorization: Bearer $APIFY_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"startUrls":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}],
    "maxResults":1,"maxResultsShorts":0,"maxResultStreams":0,
    "transcriptionAndSubtitle":"NONE","aiVideoDescription":false,"aiVideoSummary":false}'
```

FlashData JSON POST /v1/queries/realtime: 用ボディ

```json
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}
```

Actor 同期エンドポイントは、すでに 1 つの HTTP 応答でアイテムを返すことができます。リクエスト、エンベロープ、フィールドを移行します。不必要なポーリングを追加しないでください。

### 2。スクリプトを保存して実行します

Python または Bash を選択します。新しい出力フォルダーごとに 1 つのリクエストが送信されます。フォルダーを再利用すると、保存された出力が読み取られます。中断されるか、failed 検査のために停止しようとします。どちらのバージョンも同じファイルを使用します。

#### Python

Python 3.10+ が必要です。python -m pip install requests で依存パッケージをインストールしてください。新しい作業フォルダーで、以下の完全なスクリプトを video-lookup.py として保存してから実行してください。

```python
import argparse
import getpass
import json
import math
import os
import re
from pathlib import Path

import requests

parser = argparse.ArgumentParser()
parser.add_argument("video_id")
parser.add_argument("folder", type=Path)
args = parser.parse_args()
if not re.fullmatch(r"[A-Za-z0-9_-]{11}", args.video_id):
    raise SystemExit("Use an 11-character YouTube video ID")
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
out = args.folder
if not out.exists():
    key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
    if not key.strip():
        raise SystemExit("An API key is required")
    out.mkdir(parents=True)
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    try:
        response = requests.post(
            "https://data.flashdata.dev/v1/queries/realtime", json=body,
            headers={"X-API-Key": key, "Accept": "application/json"},
            timeout=120, allow_redirects=False,
        )
    except requests.RequestException:
        raise SystemExit("Outcome unknown. Keep this folder and check History before retrying.")
    (out / "response.json").write_bytes(response.content)
    (out / "http-status.txt").write_text(str(response.status_code), encoding="utf-8")
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""), encoding="utf-8")
else:
    print("Reading saved output; no API call.")

try:
    saved = json.loads((out / "request.json").read_text(encoding="utf-8"))
    status = (out / "http-status.txt").read_text(encoding="utf-8").strip()
except (OSError, ValueError):
    raise SystemExit("Incomplete attempt. Inspect this folder and History before retrying.")
if saved != body:
    raise SystemExit("This folder belongs to a different request. Use a new folder.")
if status != "200":
    raise SystemExit(f"HTTP {status}: inspect response.json and retry-after.txt")
data = json.loads((out / "response.json").read_text(encoding="utf-8"))
if not isinstance(data, dict) or data.get("status") != "done" or data.get("source") != body["source"]:
    raise SystemExit("Request did not complete successfully; inspect response.json")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict):
    raise SystemExit("Expected one metadata result")
item = items[0]
if item.get("videoId") != args.video_id:
    raise SystemExit("Returned video does not match the request")
seconds = item.get("duration")
duration = None
if seconds is not None:
    if type(seconds) not in (int, float) or not math.isfinite(seconds) or seconds < 0:
        raise SystemExit("Invalid duration")
    whole = int(seconds)
    duration = f"{whole // 3600:02d}:{whole % 3600 // 60:02d}:{whole % 60:02d}"
mapped = [{
    "id": item["videoId"],
    "url": "https://www.youtube.com/watch?v=" + item["videoId"],
    "title": item.get("title"), "text": item.get("description"),
    "channelName": item.get("channel"), "channelId": item.get("channelId"),
    "viewCount": item.get("viewCount"), "likes": item.get("likeCount"),
    "commentsCount": item.get("commentCount"), "duration": duration,
    "uploadDateRaw": item.get("uploadDate"),
    "captionLanguages": item.get("transcriptLanguages"),
}]
(out / "dataset-items.json").write_text(
    json.dumps(mapped, ensure_ascii=False, indent=2) + "\n", encoding="utf-8"
)
print(f"Saved {out}/dataset-items.json; actual usage: {json.dumps(data.get('usage'))}")

```

そのフォルダーから実行し、ID をデータセットの公開ビデオに置き換えます。

```bash
python video-lookup.py FUfGcZ092b0 video-001
```

#### Bash

Bash、cURL 7.76+、および jq 1.6+ が必要です。以下の完全なスクリプトを作業フォルダーに video-lookup.sh として保存します。

```bash
#!/usr/bin/env bash
set -euo pipefail
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Set OUTPUT_FOLDER}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ ]] || { echo 'Invalid video ID' >&2; exit 1; }
body=$(jq -n --arg id "$video_id" '{source: "youtube_metadata", video_id: $id,
  params: {include_formats: false, include_chapters: true}}')
if [[ ! -e "$out" ]]; then
  if [[ -z "${FLASHDATA_API_KEY:-}" ]]; then
    read -r -s -p 'FlashData API key: ' FLASHDATA_API_KEY; printf '\n'
  fi
  : "${FLASHDATA_API_KEY:?An API key is required}"
  mkdir -p -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  curl --fail-with-body --silent --show-error --max-time 120 \
    --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
    --header "X-API-Key: $FLASHDATA_API_KEY" \
    --header 'Content-Type: application/json' --header 'Accept: application/json' \
    --data-binary "@$out/request.json" --output "$out/response.json" \
    --dump-header "$out/response-headers.txt" --write-out '%{http_code}' \
    > "$out/http-status.txt" || {
      printf 'Request failed. Keep this folder and inspect History before retrying.\n' >&2
      exit 1
    }
else
  printf 'Reading saved output; no API call.\n'
fi
jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null
[[ "$(cat "$out/http-status.txt")" == 200 ]] || {
  printf 'Inspect the saved status, response and Retry-After header.\n' >&2; exit 1;
}
mapped=$(jq -e --arg id "$video_id" '
  def pad: tostring | if length < 2 then "0" + . else . end;
  def hms:
    if . == null then null
    elif type != "number" then error("Invalid duration")
    elif (isfinite | not) or . < 0 then error("Invalid duration")
    else floor | [(./3600 | floor | pad), ((.%3600)/60 | floor | pad), (.%60 | pad)] | join(":") end;
  if .source != "youtube_metadata" or .status != "done" then error("Request not done") else . end
  | .results | if type != "array" then error("Expected results")
    elif length != 1 then error("Expected one result") else .[0] end
  | if .videoId != $id then error("Wrong video") else . end
  | [{id: .videoId, url: ("https://www.youtube.com/watch?v=" + .videoId),
      title, text: .description, channelName: .channel, channelId,
      viewCount, likes: .likeCount, commentsCount: .commentCount,
      duration: (.duration | hms), uploadDateRaw: .uploadDate,
      captionLanguages: .transcriptLanguages}]' "$out/response.json")
printf '%s\n' "$mapped" > "$out/dataset-items.json"
printf 'Saved %s/dataset-items.json; actual usage: ' "$out"
jq -c '.usage' "$out/response.json"

```

そのフォルダーから実行します。

```bash
bash video-lookup.sh FUfGcZ092b0 video-001
```

### 3。保存された出力を読み取る

Video-001/dataset-items.json は、アプリケーションリーダーの配列です。 response.jsonは元の結果と使用率を維持します。 これは、ApifyデータセットAPIではなくフィールドアダプタです。 これは、データセットIDを作成しません, 未知のメトリクスをポップまたはコメントや収益化フィールドを製作.

説明 dataset-items.json:

```json
[
  {
    "id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "text": "Example description",
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "viewCount": 1200,
    "likes": null,
    "commentsCount": null,
    "duration": "00:03:17",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| 既存のアクターフィールド | FlashData メタデータ | 移行アクション |
| --- | --- | --- |
| ID/URL | videoId | ID を保持し、正規の YouTube ウォッチ URL を構築します。 |
| タイトル/本文 | タイトル/説明 | 読者がアクターのフィールド名を期待している場合は、説明をテキストにマップします。 |
| channelName / channelId | チャンネル / channelId | 名前とIDを保存します。表示名からチャネル ハンドルを推測しないでください。 |
| いいね / commentsCount / viewCount | likeCount / commentCount / viewCount | 欠損値は null として保持します。欠落しているメトリックはゼロではありません。 |
| 期間、多くの場合 HH:MM:SS | 持続時間（秒） | この例では、秒を HH:MM:SS 文字列に変換し、null を保持します。 |
| 絶対日付または相対日付 | uploadDate | この例では uploadDateRaw を維持します。正規化された日付を入力する前に、独自の日付パーサーを追加します。 |
| 字幕[] / transcriptionUrl | 個別の youtube_transcript または youtube_captions リクエスト | 既存のトラックと生成された音声合成は、アプリへの異なる入力となります。 |
| アクターのみのエンリッチメント フィールド | 自動的に相当するものはありません | コメント、チャネル拡張、AI による分析については、個別の強化ステップを保持します。 |

[メタデータスキーマ](https://flashdata.dev/ja/docs/sources/youtube_metadata/reference.md).

### 字幕の意図を引き継ぐ

| メインアクターの入力 | FlashData 移行 |
| --- | --- |
| ALWAYS_SUBTITLES | 既存のトラックに対して別の youtube_transcript または youtube_captions リクエストを追加します。 |
| subtitlesLanguage | params.language を使用します。最大 10 言語の配列は、トラックと言語ごとのエラーを返します。 |
| preferAutoGeneratedSubtitles | これは好みです。 FlashData params.auto は、クロスオリジン フォールバックなしで、YouTube が生成したキャプションまたはアップローダーが提供したキャプションを厳密に選択します。 |
| TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBE | 音声とテキストを分離してください。 FlashData は欠落トラックを生成しません。 |
| 字幕[].srt / transcriptionUrl | タイムスタンプ付きセグメントをマップするか、ファイルを明示的にフォーマットします。生成されたプレーンテキスト URL は、タイムスタンプ付きのセグメント配列ではありません。 |

[タイムスタンプ付きキャプションのレシピ](https://flashdata.dev/ja/docs/guides/timestamped-captions-recipe/reference.md).

<a id="production"></a>
## データセット、長いrunning のジョブとスケジュール

ツールが Apify データセット IDs とスケジュールに依存している場合は、カスタム アクタをオーケストレーターとして保持します。その中で FlashData を呼び出し、マップされたアイテムをそのデータセットに書き込みます。 FlashData の使用量に加えて、Actor のランタイムとストレージの予算を立てます。上記の計算機モデルは、FlashData 呼び出しを指示します。

| 懸念 | Apify | FlashData |
| --- | --- | --- |
| リクエスト | アクター ID + ビルド/input オプション;オプションの保存済みタスク | ソース + video_id + パラメータ;アクターのビルドまたはメモリのオプションはありません |
| 同期結果 | run-sync-get-dataset-items は項目配列を返します。文書化された HTTP の制限は 300 秒です | リアルタイム応答にはステータス、結果[]、および使用法があります。フィールドをマッピングする前に結果を抽出する |
| 長時間runningの仕事 | 実行を開始し、実行 ID を保存し、端末ステータスを待ち、defaultDatasetId を読み取ります | async または batch ジョブを送信し、その ID を保存し、ステータスをポーリングして結果を取得します |
| 出力ストレージ | データセット項目と、URL によって参照されるオプションの Key-Value レコード | 応答を保存するか、独自の耐久性のあるストレージにエクスポートします。 Apify データセット ID は FlashData ジョブ ID ではありません |
| 定期的な作業 | Apify スケジュールが開始 アクター/Tasks; Webhook は下流の消費者に通知します | アプリケーション、cron、CI、またはエージェント ホストを使用して、FlashData を呼び出します。スケジュールとコンシューマを一緒に移行する |

### 既存のデータセットを移動する

プロデューサーを切り替える前に、既存のデータセットのすべてのページをエクスポートします。まだ必要な参照字幕ファイルを保存します。すでに収集された出力をダウンロードするためだけにアクタを再実行しないでください。

[結果を保存して再利用する](https://flashdata.dev/ja/docs/guides/save-results/reference.md)

### ビデオライブラリを更新する

ビデオ IDs を重複排除し、各結果をチェックポイントして、入力から出力 IDs を維持します。より大きなリストにはバッチ処理または一括処理を使用します。エラーを検査した後、failed 項目を再試行してください。

[一括処理リファレンス](https://flashdata.dev/ja/docs/reference/bulk-processing/reference.md)

### スケジュールされた作業を予測可能に保つ

タイムゾーン、リズム、認証情報、出力先を引き継ぎます。古いプロデューサーを退職する前に 1 つの completed スケジュール ウィンドウを記録します。これにより、重複するスケジュールによって重複した作業が作成されなくなります。

[定期的なタスクを実行する](https://flashdata.dev/ja/docs/guides/recurring-tasks/reference.md)

### カットオーバーチェックリスト

1. 正確なアクター、ビルド、タスク入力、請求可能なイベント、出力フィールド、およびダウンストリーム コンシューマーを記録します。
2. 既存の実行をドレインし、すべてのデータセット ページをエクスポートします。 clean=true はレコードをスキップできるため、短いページだけではエクスポートが完了したことを証明できません。ページネーションのメタデータを確認します。
3. null メトリクス、日付、キャプションの発信元を含む、保存された IDs に対してアダプターを検証します。
4. ランナーにケイデンス、タイムゾーン、目的地を移します。チェックポイントを守ってください。 maxTotalChargeUsd は、FlashData API の重要な支出上限ではありません。アプリケーションレベルの支出制御を追加します。
5. 重複した実行を行わずに、次のスケジュール期間にプロデューサーを切り替えます。輸出を維持します。取り消された資格情報または残高不足に対する繰り返しの作業を停止します。

<a id="agents"></a>
## コーディングおよび個人エージェント

1 credit(100規格YouTubeデータリクエストまで)を72時間で開始できます。 メタデータとキャプションは、許容値を共有します。

1. アクター統合を特定し、最初に既存の FlashData 資格情報を再利用します。
2. 1 つのビデオ ルックアップを証明し、生の出力とマップされた出力の両方を実際の使用状況で保存します。
3. 所有者はサインインまたはサインアップし、電子メールを確認し、請求、範囲、および共有残高へのアクセスを承認します。未使用のトライアル クレジットは移行されません。
4. 繰り返し使用できるように所有者の資格情報を保持します。失効時には停止します。新しいトライアルを作成しないでください。

```text
Replace this project's Apify YouTube metadata lookup with FlashData.
Read https://flashdata.dev/auth.md and https://flashdata.dev/docs/sources/youtube_metadata/reference.md.
Identify the exact Actor ID, build, input, output fields, schedule and storage consumer first.
Reuse a saved FlashData credential or start one eligible trial with youtube_metadata permission.
Run one known video ID. Save the raw response, actual usage and a mapped JSON item array.
Keep null metrics and preserve the raw publication date. Do not invent Actor-only fields.
Keep channel discovery, comments, AI transcription and hosted scheduling separate unless explicitly migrated.
Reuse saved results after restart. Ask the owner to claim before recurring use and store keys outside chat.
Stop after revocation or insufficient balance; never create more trials to continue.
```

[トライアルと請求](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md) · [スタンドアロン CLI](https://flashdata.dev/ja/docs/guides/flashdata-cli/reference.md) · [MCP セットアップ](https://flashdata.dev/ja/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## 切り替える前に

### これは Apify プラットフォームの代替ですか?

ワークフロー内の特定の YouTube データ呼び出しを置き換えます。 Apify は、Actor マーケットプレイス、カスタム ランタイム、ホストされたスケジュール、ストレージも提供します。それらの部分を使用する場所に保持するか、その責任を独自のアプリケーションに移してください。

### すべてのアクターを 1 つの価格で比較してみませんか?

アクター開発者は、さまざまな価格設定モデル、出力、および入力制限を選択します。計算機はストリーマを使用します/youtube-scraper. アクター テーブルには、より安価なディスカバリー アクターも含まれています。オンデマンド ルックアップを置き換える場合、単一ビデオの制限が重要になります。

### Apify サブスクリプションには、含まれている使用量に対して 2 回の料金がかかりますか?

いいえ。プラン料金には前払いの使用予算が含まれています。計算機は、アクタの使用量をさらに追加する前に、その予算を差し引きます。予算全体がこのワークフローに利用可能であることを前提としています。他のアクターがそれを消費すると、YouTube に残る量は少なくなります。

### Apify データセット コンシューマを保持できますか?

この例では、選択した馴染みのあるフィールド名を使用して JSON 配列を書き込みます。 Apify データセットを作成したり、ID を実行したりすることはありません。新しいファイルを直接読み取るか、独自のストレージを通じて公開するか、既存のコンシューマー用にこれらのマップされたアイテムをデータセットに書き込むカスタム アクタを保持します。

### 字幕と AI 文字起こしはどうなりますか?

Apify の主演俳優は、既存の字幕とオプションの AI 文字起こしを提供します。 FlashData は既存の YouTube トラックを取得します。メタデータとキャプションを個別にリクエストし、返された言語と起源を確認し、音声テキスト変換または AI 要約ステップを分離します。

### 既存のスケジュールまたはランの支出上限は移行されますか?

いいえ。選択したランナーでスケジュールを再作成し、アプリケーション レベルの予算チェックを追加します。 Apify maxTotalChargeUsd 設定は、FlashData API キーの支出上限ではありません。所有者キーは共有アカウント残高を使用します。
