# Bright Data بديل لـ YouTube البيانات

قارن طلبات FlashData YouTube مع سجلات المكشطة Bright Data: المعدلات المدفوعة والبدلات الشهرية وحدود الوظائف وPython/Bash الهجرة من اللقطات إلى الوظائف المحفوظة.

بناء بحث فيديو حول طلبات المصدر. قارن المهمة بأكملها، ثم انقل سير عمل اللقطة إلى المهام المحفوظة والقابلة للاستئناف.

هذه هي المقارنة YouTube. [Bright Data بديل لـ Google البحث](https://flashdata.dev/ar/compare/brightdata/reference.md) صفحة منفصلة.

واستعرضت وقائع Bright Data 2026-11-10. FlashData وتستخدم المعدلات والبدلات فهرسها العام الحالي.

- [الميزات](#features)
- [التسعير](#pricing)
- [الحصص والحدود](#limits)
- [ترحيل وظيفة](#migration)
- [سير عمل الوكيل](#agents)
- [الأسئلة الشائعة](#faq)

<a id="features"></a>
## مقارنة الميزات

### انخفاض التكاليف المدفوعة لعمليات البحث المركزة عن الفيديو

| ميزة | FlashData | Bright Data YouTube |
| --- | --- | --- |
| البحث المدفوع عن البيانات الوصفية · 1,000 مقاطع فيديو | $0.50 — 1,000 طلبات المصدر · PAYG | $1.50 — 1,000 تسليم تسجيلات الفيديو · PAYG |
| البيانات الوصفية + التسميات التوضيحية الموجودة · 1,000 مقاطع فيديو | $1.00 — 2,000 طلبات المصدر · PAYG | $1.50 — 1,000 تسجيل فيديو عند تضمين حقول التسميات التوضيحية |
| دخول الخطة الشهرية | $49.00 — Micro/شهر; شمل رصيد الاستخدام المشترك | $499 — Scale/شهر ; 384,000 included |
| ادفع كما تذهب بدون اشتراك شهري | نعم | نعم |

### ابحث عن مقاطع الفيديو وقم ببناء مكتبة بحثية

| ميزة | FlashData | Bright Data YouTube |
| --- | --- | --- |
| اكتشف مقاطع الفيديو حسب الكلمات الرئيسية | نعم — البحث باستخدام مرشحات التاريخ والمدة والنوع والفرز | نعم — أوضاع اكتشاف الكلمات الرئيسية وتصفية البحث |
| البيانات الوصفية لمقطع فيديو معروف | نعم — العنوان والقناة والمدة والصور المصغرة وأعداد المشاركة | نعم — تسجيلات فيديو مع حقول الهوية والقناة والمشاركة |
| علامات الفصل للملاحة | نعم — include_chapters; أوقات الفصل في ثوان | نعم — عناوين الفصول والمعاينات وأوقات البدء بالمللي ثانية |
| اكتشف لغات التسميات التوضيحية المتاحة | قائمة اللغات في البيانات الوصفية | قائمة المسار في سجل الفيديو — يتضمن معلومات اللغة والتسمية التوضيحية التلقائية |

### اجعل التسميات التوضيحية قابلة للاستخدام كدليل

| ميزة | FlashData | Bright Data YouTube |
| --- | --- | --- |
| طلب التسميات التوضيحية دون تحديث البيانات الوصفية | مصدر نسخة مخصصة — طلب قياسي واحد لكل فيديو | حقول التسمية التوضيحية في سجل الفيديو — YouTube مكشطة الفيديو |
| طلب لغات تسمية توضيحية متعددة | ما يصل إلى 10 لغة صريحة — المسارات بالإضافة إلى الأخطاء لكل لغة | لغة واحدة مختارة — حدد اللغة عند جمع تسجيل الفيديو |
| حدد برنامج التحميل أو أصل التسمية التوضيحية التلقائية | نعم — params.auto يختار أصلًا واحدًا دون الرجوع إلى الأصل المشترك | الأصل الموضح في البيانات الوصفية للمسار — لم يتم إدراج أي مدخلات لتحديد الأصل في أداة استخراج مقاطع الفيديو التي تمت مراجعتها |
| النص الكامل والاستشهادات ذات الطوابع الزمنية | نص كامل + أجزاء محددة بوقت — ابدأ/end مرات في ثواني | نص كامل + أجزاء محددة بوقت — بداية المقطع ونهايته ومدته بالمللي ثانية |

### قم بتشغيل المجموعة في تطبيقك أو وكيلك

| ميزة | FlashData | Bright Data YouTube |
| --- | --- | --- |
| جمع التفاعلية والخلفية | الوقت الحقيقي أو async — اختر الوضع؛ احفظ الوظيفة ID للعمل في الخلفية | كشط المزامنة أو مشغل async — يستمر عمل المزامنة التي تتجاوز الدقيقة الواحدة كلقطة |
| معالجة قائمة كبيرة معدة | Bulk Jobs بملف فيديو-ID — وحدة التحكم أو API؛ أجزاء التقدم والبيان والنتيجة | دفعات الإدخال غير المتزامنة — قم بتشغيل المجموعة واسترجاعها أو تسليم لقطة لها |
| الإخراج للتطبيقات وLLMs | JSON، نص عادي أو Markdown | تنسيقات تصدير اللقطات — JSON و NDJSON و CSV |
| الاحتفاظ بـ completed نتيجة لتحليلها لاحقًا | حفظ النتائج أو استخدام التخزين بالجملة — احتفظ بالبيانات الأولية والبيانات في مخزنك الخاص | لقطات وتسليم التخزين — تم الاحتفاظ باللقطات لمدة 30 يوم |
| عميل المحطة المستقلة | أصلي CLI — Linux، macOS و Windows؛ لا يوجد وقت تشغيل Node/Python | Node.js CLI — أمر bdata المثبت على npm |
| MCP والمهارات وSDK الوصول | نعم | نعم |

الأسعار المدفوعة لا تشمل البدلات المجانية. كلاهما يقدم async وظيفة، وجمع بالجملة وأدوات الوكيل. احتفظ بجمع التعليقات والأنظمة الأساسية الاجتماعية الأخرى ومجموعات البيانات المُدارة وعمليات تكامل تسليم التخزين الحالية عند الحاجة.

### ادفع مقابل الحقول التي تحتاجها مهمتك

جلب البيانات الوصفية لقائمتك المختصرة. اطلب التسميات التوضيحية فقط لمقاطع الفيديو التي ستحللها. لا يحتاج تحديث بيانات التعريف إلى تكرار خطوة النص.

### اختر مسار التسمية التوضيحية بشكل صريح

اطلب لغة وحدد التسميات التوضيحية المقدمة من القائم بالتحميل أو التي تم إنشاؤها بواسطة YouTube. أبقِ الأخطاء اللغوية مرئية بدلاً من تغيير مدخلات البحث بصمت.

### احتفظ بالمهمة عبر جلسات الوكيل

احفظ الوظيفة المقبولة ID قبل الاقتراع. تستأنف عملية لاحقة نفس الوظيفة وتعيد استخدام النتيجة التي تم تنزيلها دون إرسال استعلام آخر.

<a id="pricing"></a>
## قارن مهمة الفيديو الكاملة

يمكن أن يتضمن سجل الفيديو الخاص بـ Bright Data بيانات وصفية وتسميات توضيحية. FlashData يستخدم طلب بيانات وصفية واحدًا وطلب تسمية توضيحية منفصل. قد يؤدي إدخال اكتشاف واحد إلى إرجاع العديد من السجلات القابلة للفوترة؛ تغطي هذه الآلة الحاسبة عمليات البحث عن مقاطع الفيديو المعروفة فقط.

| Bright Data YouTube عرض | الرسوم الشهرية | السجلات المدرجة | المعدل المدفوع / 1,000 السجلات |
| --- | --- | --- | --- |
| تجمع مجاني مؤهل | $0 | ما يصل إلى 5,000/شهر مشترك عبر المنتجات المؤهلة | ضمن البدل |
| الدفع حسب الاستخدام | $0.00 | لا يوجد بدل الخطة المدفوعة | $1.50 |
| Scale · $499/month | $499.00 | 384,000 | $1.30 additional |
| المؤسسة | مخصص | مخصص | مخصص |

Scale يشمل 384,000 سجلات $499/شهر؛ تكلفة السجلات الإضافية $1.30 لكل 1,000. لم يتم تصميم مطابقة المؤسسات المخصصة والودائع الترويجية.

| 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/ar/pricing/youtube-data).

### 10,000 مقاطع فيديو: ادفع حسب الاستخدام على كلا الجانبين

| المهمة | FlashData طلبات | FlashData فاتورة نموذجية | Bright Data تطبيق السجلات المجانية | Bright Data فاتورة نموذجية |
| --- | --- | --- | --- | --- |
| البيانات الوصفية للفيديو | 10,000 | $5.00 | 0 | $15.00 |
| البيانات الوصفية للفيديو | 10,000 | $5.00 | 5,000 | $7.50 |
| البيانات الوصفية + التسميات التوضيحية الموجودة | 20,000 | $10.00 | 0 | $15.00 |
| البيانات الوصفية + التسميات التوضيحية الموجودة | 20,000 | $10.00 | 5,000 | $7.50 |

USD لمدة شهر واحد من عمليات البحث الناجحة عن الفيديو. يمكن أن يحتوي سجل الفيديو Bright Data الذي تم إرجاعه على بيانات وصفية وتسميات توضيحية موجودة؛ تستخدم المهمة FlashData المدمجة طلبين للمصدر. يتم استبعاد الاكتشاف والتعليقات والنسخ بالذكاء الاصطناعي والبحث الموسع وتنزيلات الوسائط. أدخل فقط Bright Data الاعتمادات المجانية التي لا تزال متاحة لهذه السجلات؛ يتم مشاركة مجمع الائتمان 5,000، ولا يتم تكديس الاعتمادات المجانية المتكررة مع Scale. FlashData الأسعار تأتي من الكتالوج العام الحالي؛ يتم تخصيص رصيد الخطة المحدد بالكامل هنا قبل الاستخدام الإضافي. FlashData أرصدة البداية والاشتراك/agent لا تشمل التجارب. تقيس الفاتورة النموذجية الاستخدام بالإضافة إلى أي رسوم شهرية، وليس شراء محفظة جديدة: FlashData عمليات إعادة التعبئة تبدأ من $10. لا يتم تضمين أي ضرائب أو عروض ترويجية لمطابقة الودائع أو أسعار مخصصة أو خصومات سنوية.

### عروض البداية

تم التحقق منها FlashData يمكن أن تحصل الاشارات على علاوة أولية تصل إلى الحد الأقصى 4,000 المعيار YouTube طلبات البيانات. هذا رصيد أولي وليس حصة شهرية متكررة.

تتلقى حسابات Bright Data المؤهلة 5,000 أرصدة مجانية شهريًا تتم مشاركتها عبر المنتجات المؤهلة، بما في ذلك Scraper API. يتم تسليم YouTube سجل واحد يستهلك رصيدا واحدا. لا يتم ترحيل الأرصدة المجانية غير المستخدمة؛ لا تتلقى حسابات الالتزام المسبق أرصدة مجانية متكررة. لا تكدسوا المسبح المجاني الشهري بـ Scale.

<a id="limits"></a>
## البدلات وbatch المقاسات وrunning الوظائف

| قلق | FlashData | Bright Data مكشطة API |
| --- | --- | --- |
| ما الذي يستهلك البدل؟ | كل استعلام مصدر؛ البيانات الوصفية والتسميات التوضيحية منفصلة | تم تسليم السجلات بنجاح؛ يمكن لمدخل اكتشاف واحد إرجاع الكثير |
| طلب تفاعلي واحد | POST /v1/queries/realtime; اختر async للعمل في الخلفية | POST /datasets/v3/scrape; بعد 1 دقيقة، HTTP 202 تُرجع لقطة ID وتستمر المهمة |
| مدخلات أكبر | حجم الدفعة يعتمد على الخطة؛ استخدم المعالجة المجمعة لملف IDs | غير متزامن /trigger يقبل ما يصل إلى 1 غيغابايت من الإدخال؛ الحد الأدنى لعدد المدخلات يعتمد على المكشطة |
| تشغيل العمل | يعتمد تزامن الحساب على الخطة المحددة، الموضحة أدناه | 5,000 وظائف نشطة/snapshots; تجاوز الحد يعود 429 |
| التراجع | الشرف Retry-After؛ تسمح تجارب الوكيل المؤقت بطلب واحد في الثانية | الشرف Retry-After؛ 25 HTTP 429 الردود لكل عنوان IP في 5 دقيقة يمكن أن تؤدي إلى حظر 1 ساعة API |
| النتائج المحفوظة | قم بتنزيل JSON والاحتفاظ به في مخزن المهام الخاص بك | يتم الاحتفاظ باللقطات لمدة 30 يوم؛ تدعم طلبات التنزيل ما يصل إلى 5 جيجابايت، مع استرجاع جزئي للحصول على نتائج أكبر |

| FlashData خطة | الاستعلامات المتزامنة | الاستعلامات لكل طلب دفعة |
| --- | --- | --- |
| الدفع حسب الاستخدام | 25 | 100 |
| Micro | 50 | 100 |
| Starter | 100 | 200 |
| Pro | 200 | 300 |
| Scale | 300 | 400 |
| Business | 400 | 500 |

التزامن ليس طلبات في الثانية الواحدة. لا تزال الاعتمادات تنطبق على كل استعلام. [الوقت الحقيقي و async](https://flashdata.dev/ar/docs/reference/realtime-and-async/reference.md) · [دفعة وسائبة](https://flashdata.dev/ar/docs/reference/batch-and-bulk/reference.md) · [مرجع المعالجة بالجملة](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md).

<a id="migration"></a>
## من لقطة إلى مهمة محفوظة

### 1. قم بإعداد الوصول ورسم خريطة للطلب

قم بإنشاء مفتاح أو إعادة استخدامه بإذن youtube_metadata. [API مفاتيح](https://flashdata.dev/app/api-keys) · [الاعتمادات المتاحة](https://flashdata.dev/app/billing). قم بتخزين FLASHDATA_API_KEY في متجر سري أو أدخله في المطالبة المخفية للبرنامج النصي.

التقديم الحالي Bright Data، لمرجع الترحيل:

```bash
# Existing Bright Data job submission, for migration reference.
curl --fail-with-body --silent --show-error --max-time 120 \
  --request POST \
  'https://api.brightdata.com/datasets/v3/trigger?dataset_id=gd_lk56epmy2i5g7lzu0k&format=json' \
  --header "Authorization: Bearer $BRIGHTDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"input":[{"url":"https://www.youtube.com/watch?v=FUfGcZ092b0"}]}'
```

FlashData POST https://data.flashdata.dev/v1/queries مع X-API-Key:

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

### 2. احفظ البرنامج النصي قبل running

يتطلب Python 3.10+. ثبّت المكتبة باستخدام python -m pip install requests. في مجلد عمل جديد، احفظ السكربت الكامل أدناه باسم migrate-video.py قبل تشغيله.

```python
# Save as migrate-video.py in your working folder.
import argparse
import getpass
import json
import os
import re
import time
from pathlib import Path
from urllib.parse import urlsplit

import requests

parser = argparse.ArgumentParser()
parser.add_argument("video_id")
parser.add_argument("folder", help="A new folder name, such as video-001")
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")
if not re.fullmatch(r"[A-Za-z0-9_-]+", args.folder):
    raise SystemExit("Use a simple output folder name")
os.umask(0o077)
out = Path(args.folder)
body = {"source": "youtube_metadata", "video_id": args.video_id,
        "params": {"include_formats": False, "include_chapters": True}}
key = None

def read(name):
    return json.loads((out / name).read_text(encoding="utf-8"))

def call(method, url, name, payload=None, authenticated=True):
    global key
    headers = {"Accept": "application/json"}
    if authenticated:
        if key is None:
            key = os.environ.get("FLASHDATA_API_KEY") or getpass.getpass("FlashData API key: ")
        if not key.strip():
            raise SystemExit("An API key is required")
        headers["X-API-Key"] = key
    try:
        response = requests.request(method, url, json=payload, headers=headers,
                                    timeout=(10, 120), allow_redirects=False)
    except requests.RequestException:
        raise SystemExit("Network outcome unknown. Keep this folder and check History; do not resubmit.")
    (out / name).write_bytes(response.content)
    (out / (name + ".http")).write_text(str(response.status_code))
    (out / "retry-after.txt").write_text(response.headers.get("Retry-After", ""))
    return response

if not out.exists():
    out.mkdir()
    (out / "request.json").write_text(json.dumps(body), encoding="utf-8")
    submitted = call("POST", "https://data.flashdata.dev/v1/queries", "submission.json", body)
    if submitted.status_code not in (200, 201, 202):
        raise SystemExit(f"HTTP {submitted.status_code}. Inspect submission.json and retry-after.txt.")
else:
    try:
        if read("request.json") != body:
            raise SystemExit("This folder belongs to another request. Use a new folder.")
    except (OSError, ValueError):
        raise SystemExit("Incomplete attempt. Check the folder and History before resubmitting.")
try:
    receipt = read("submission.json")
    job_id = receipt["id"]
    status = (out / "submission.json.http").read_text().strip()
    if status not in ("200", "201", "202") or receipt["source"] != body["source"] or not re.fullmatch(r"[A-Za-z0-9_-]+", job_id):
        raise ValueError()
except (OSError, ValueError, KeyError, TypeError):
    raise SystemExit("No valid saved receipt. Check History; this script will not submit again.")

if not (out / "result.json").exists():
    url = "https://api.flashdata.dev/v2/jobs/" + job_id
    for attempt in range(12):
        response = call("GET", url, "job.json")
        if response.status_code != 200:
            raise SystemExit(f"HTTP {response.status_code}. Resolve the error; then resume this folder.")
        job = response.json()["job"]
        if job["id"] != job_id or job["source"] != body["source"]:
            raise SystemExit("Job does not match the saved receipt")
        if job["status"] == "completed":
            break
        if job["status"] not in ("pending", "processing"):
            raise SystemExit("Job " + job["status"] + ". Inspect job.json; do not resubmit.")
        delay = response.headers.get("Retry-After", "5")
        if attempt == 11 or not delay.isdigit() or int(delay) > 60:
            raise SystemExit("Still running. Wait for Retry-After, then run the same command to resume.")
        time.sleep(max(1, int(delay)))
    result = call("GET", url + "/results", "result.pending.json")
    if result.status_code == 302:
        location = result.headers.get("Location", "")
        parsed = urlsplit(location)
        if parsed.scheme != "https" or not parsed.hostname or parsed.username or parsed.password:
            raise SystemExit("Expected an HTTPS storage URL")
        # Separate request: the API key is never sent to storage.
        result = call("GET", location, "result.pending.json", authenticated=False)
    if result.status_code != 200:
        raise SystemExit(f"HTTP {result.status_code}. Resolve the error, then resume this folder.")
    data = result.json()
else:
    print("Reading saved result; no API call.")
    data = read("result.json")
if not isinstance(data, dict) or data.get("source") != body["source"] or data.get("status") != "done":
    raise SystemExit("Result did not complete successfully")
items = data.get("results")
if not isinstance(items, list) or len(items) != 1 or not isinstance(items[0], dict) or items[0].get("videoId") != args.video_id:
    raise SystemExit("Expected the requested video in results")
item = items[0]
mapped = [{"video_id": item["videoId"], "url": "https://www.youtube.com/watch?v=" + item["videoId"],
           "title": item.get("title"), "description": item.get("description"),
           "views": item.get("viewCount"), "likes": item.get("likeCount"),
           "num_comments": item.get("commentCount"), "video_length": item.get("duration"),
           "channelName": item.get("channel"), "channelId": item.get("channelId"),
           "uploadDateRaw": item.get("uploadDate"), "captionLanguages": item.get("transcriptLanguages")}]
if not (out / "result.json").exists():
    (out / "result.pending.json").replace(out / "result.json")
(out / "video-records.json").write_text(json.dumps(mapped, ensure_ascii=False, indent=2), encoding="utf-8")
print(f"Saved {out}/video-records.json; actual usage: {json.dumps(data.get('usage'))}")

```

تشغيل من نفس المجلد:

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

وبدلاً من ذلك، استخدم Bash وcURL 7.76+ وjq 1.6+. احفظ النص الكامل أدناه باسم migrate-video.sh في مجلد عمل جديد.

```bash
#!/usr/bin/env bash
# Save as migrate-video.sh in your working folder.
set -euo pipefail
umask 077
video_id="${1:?Use: VIDEO_ID OUTPUT_FOLDER}"
out="${2:?Use a folder name such as video-001}"
[[ "$video_id" =~ ^[A-Za-z0-9_-]{11}$ && "$out" =~ ^[A-Za-z0-9_-]+$ ]] || exit 2
body=$(jq -n --arg id "$video_id" '{source:"youtube_metadata", video_id:$id,
  params:{include_formats:false, include_chapters:true}}')
call() {
  local method="$1" url="$2" name="$3" authenticated="$4" payload="${5:-}"
  local -a options=(--silent --show-error --compressed --proto '=https'
    --connect-timeout 10 --max-time 120 --request "$method"
    --header 'Accept: application/json' --output "$out/$name"
    --dump-header "$out/$name.headers" --write-out '%{http_code}')
  if [[ "$authenticated" == yes ]]; 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}"
    options+=(--header "X-API-Key: $FLASHDATA_API_KEY")
  fi
  if [[ -n "$payload" ]]; then options+=(--header 'Content-Type: application/json' --data-binary "$payload"); fi
  curl "${options[@]}" "$url" > "$out/$name.http" || {
    echo 'Network outcome unknown. Keep this folder and check History; do not resubmit.' >&2; exit 1;
  }
  status=$(cat "$out/$name.http")
}
if [[ ! -e "$out" ]]; then
  mkdir -- "$out"
  printf '%s\n' "$body" > "$out/request.json"
  call POST 'https://data.flashdata.dev/v1/queries' submission.json yes "@$out/request.json"
  [[ "$status" =~ ^20[012]$ ]] || { echo "HTTP $status. Inspect submission.json and its headers." >&2; exit 1; }
else
  jq -e --argjson expected "$body" '. == $expected' "$out/request.json" >/dev/null || {
    echo 'Incomplete or different request. Check this folder and History.' >&2; exit 1;
  }
fi
[[ "$(cat "$out/submission.json.http")" =~ ^20[012]$ ]] || exit 1
id=$(jq -er 'select(.source == "youtube_metadata") | .id | select(type == "string" and test("^[A-Za-z0-9_-]+$"))' "$out/submission.json")
if [[ ! -f "$out/result.json" ]]; then
  url="https://api.flashdata.dev/v2/jobs/$id"
  for attempt in {1..12}; do
    call GET "$url" job.json yes
    [[ "$status" == 200 ]] || { echo "HTTP $status. Inspect job.json and its headers; resume after resolving." >&2; exit 1; }
    state=$(jq -er --arg id "$id" 'select(.job.id == $id and .job.source == "youtube_metadata") | .job.status' "$out/job.json")
    [[ "$state" == completed ]] && break
    [[ "$state" == pending || "$state" == processing ]] || { echo "Job $state. Do not resubmit." >&2; exit 1; }
    delay=$(awk 'tolower($1)=="retry-after:" {sub(/\r$/, "", $2); print $2}' "$out/job.json.headers")
    delay="${delay:-5}"
    [[ "$attempt" -lt 12 && "$delay" =~ ^[0-9]+$ && "$delay" -le 60 ]] || {
      echo 'Still running. Wait for Retry-After, then run the same command to resume.' >&2; exit 1;
    }
    [[ "$delay" -gt 0 ]] || delay=1
    sleep "$delay"
  done
  call GET "$url/results" result.pending.json yes
  if [[ "$status" == 302 ]]; then
    location=$(awk 'tolower($1)=="location:" {sub(/\r$/, "", $2); print $2}' "$out/result.pending.json.headers")
    [[ "$location" =~ ^https://[^/@[:space:]]+(/|$) ]] || { echo 'Expected HTTPS storage URL.' >&2; exit 1; }
    # Separate request, without the API key. Do not add -L to an authenticated request.
    call GET "$location" result.pending.json no
  fi
  [[ "$status" == 200 ]] || { echo "HTTP $status. Resolve it, then resume this folder." >&2; exit 1; }
  result="$out/result.pending.json"
else
  echo 'Reading saved result; no API call.'
  result="$out/result.json"
fi
mapped=$(jq -e --arg id "$video_id" '
  if .source != "youtube_metadata" or .status != "done" then error("Result 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
  | [{video_id:.videoId, url:("https://www.youtube.com/watch?v=" + .videoId), title, description,
      views:.viewCount, likes:.likeCount, num_comments:.commentCount, video_length:.duration,
      channelName:.channel, channelId, uploadDateRaw:.uploadDate, captionLanguages:.transcriptLanguages}]' "$result")
[[ "$result" == "$out/result.json" ]] || mv -- "$result" "$out/result.json"
printf '%s\n' "$mapped" > "$out/video-records.json"
printf 'Saved %s/video-records.json; actual usage: ' "$out"
jq -c '.usage' "$out/result.json"

```

تشغيل من نفس المجلد:

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

إذا كان لا يزال running، كرر نفس الأمر لاستئناف المهمة المحفوظة. يتم إعادة استخدام عمليات التشغيل المكتملة result.json بدون مكالمة API. يرسل مجلد جديد طلبًا جديدًا؛ تحقق من السجل قبل إعادة محاولة الإرسال غير المؤكد. احتفظ بالمفاتيح خارج الدردشة ولا تعيد توجيهها مطلقًا إلى وحدة التخزين الموقعة URLs.

### 3. قراءة السجل المعين

ويحتفظ شريط فيديو - 001/video-records.json بالأسماء الميدانية المشتركة للفيديو؛ وتحتفظ شركة result.json بالبيانات والاستخدامات الخام. وتظل القياسات المفقودة هي null. channelName اسم عرض، وليس مقبضا؛ و uploadDateRaw ليس تاريخا عاديا. ومجالات المخطوطات ووسائط الإعلام غير ملفقة.

```json
[
  {
    "video_id": "FUfGcZ092b0",
    "url": "https://www.youtube.com/watch?v=FUfGcZ092b0",
    "title": "Example video",
    "description": "Example description",
    "views": 1200,
    "likes": null,
    "num_comments": null,
    "video_length": 197,
    "channelName": "Example channel",
    "channelId": "UC_EXAMPLE",
    "uploadDateRaw": "2025-01-15",
    "captionLanguages": [
      "en",
      "es"
    ]
  }
]
```

| قلق | التكامل القائم | FlashData تغير |
| --- | --- | --- |
| اختيار مكشطة | dataset_id=gd_lk56epmy2i5g7lzu0k | المصدر=youtube_metadata; تستخدم التسميات التوضيحية youtube_transcript بشكل منفصل |
| الإدخال | ساعة URL في مصفوفة الإدخال | 11-حرف video_id |
| المصادقة | التفويض: حامل | X-API-Key بإذن المصدر المطلوب |
| إرسال | POST /datasets/v3/trigger → snapshot_id | POST /v1/queries → المعرف; احفظ الإيصال |
| المسار | تقدم اللقطة → ready | GET /v2/jobs/{id} → job.status=completed |
| استرداد | قم بتنزيل لقطة كـ JSON أو NDJSON أو CSV | GET /v2/jobs/{id}/results → التخزين الموقع URL; جلب بدون مفتاح API |
| حقول الفيديو | video_id, title, description, views, likes, num_comments, video_length | videoId، عنوان، وصف، viewCount، likeCount، commentCount، المدة (ثواني) |
| القناة والتاريخ | اليوتيوب هو مقبض؛ date_posted موعد | احتفظ بـ channelName وchannelId وuploadDateRaw؛ لا تقم بإعادة تسمية اسم العرض إلى مقبض |
| نسخة | يمكن تضمينها كنص وformatted_transcript في تسجيل الفيديو | طلب مسار منفصل؛ fullText والشرائح تستخدم ثواني. قم بتعيين الطوابع الزمنية إذا كان المحلل اللغوي الحالي يتوقع ميلي ثانية |
| إعلام مباشر URL | video_url بث URL | استخدم سير عمل YouTube تنزيل المنفصل للتوصيل إلى مساحة التخزين الخاصة بك |

### التسميات التوضيحية الاختيارية

منح youtube_transcript إذن. أرسل هذه الهيئة إلى POST https://data.flashdata.dev/v1/queries مع X-API-Key واحفظ وظيفتها الخاصة ID. يؤدي هذا إلى إضافة طلب قياسي واحد لكل فيديو:

```json
{
  "source": "youtube_transcript",
  "video_id": "FUfGcZ092b0",
  "params": {
    "language": "en",
    "auto": true
  }
}
```

auto=false يحدد التسميات التوضيحية المقدمة من القائم بالتحميل. الحفاظ على اللغة والأصل. Bright Data أوقات النسخ المنسقة تستخدم المللي ثانية؛ FlashData شرائح تستخدم ثواني. اضرب بـ 1,000 للمحلل الذي يتوقع ميلي ثانية. [وصفة التسميات التوضيحية ذات الطوابع الزمنية القابلة للتشغيل](https://flashdata.dev/ar/docs/guides/timestamped-captions-recipe/reference.md).

### التعافي

- Pending/processing: resume the Save ID. (بولينغ) مقيد و يشرف رقمياً Retry-After.
- 401/403: عالج مشكلة المصادقة أو الصلاحية، وأوقف الطلبات عند إلغاء الوصول.
- 402: استعادة رصيد المالك المتوفر قبل المتابعة.
- 429: توقف عن الإرسال وتكريم Retry-After; لا تقم بإعادة محاولة الإرسال تلقائيًا.
- المهلة بدون إيصال: افحص السجل قبل إنشاء مجلد آخر.

[الأخطاء ورموز الحالة](https://flashdata.dev/ar/docs/errors/reference.md).

<a id="agents"></a>
## اتصال واحد، مهام قابلة لإعادة الاستخدام

ووفرت شركة يمكن أن يبدأ عملاء مؤهلون 1 الائتمان (حتى) 100 المعيار YouTube طلبات البيانات) 72 ساعات. إمكانية الوصول أولا؛ وتتقاسم البيانات الوصفية والأغطية البدل.

1. اكتشف مقاطع الفيديو والقائمة المختصرة قبل إثرائها.
2. قم بإحضار مقطع فيديو واحد، وتحقق من اختيار الحقول والتسميات التوضيحية، واحفظ المخرجات الأولية.
3. اطلب من المالك إكمال عملية الاشتراك/sign-in والموافقة على النطاقات والرصيد المشترك. لا يتم نقل الاعتمادات المؤقتة غير المستخدمة.
4. احتفظ ببيانات الاعتماد وقم بتشغيل المجلدات عبر المهام المتكررة. إعادة استخدام النتائج والتوقف عند الإلغاء أو استنفاد الرصيد.

```text
Migrate one Bright Data YouTube video lookup to FlashData.
Read https://flashdata.dev/auth.md and reuse saved access first.
Inspect the current video-record parser and list its required fields.
Fetch metadata for one known video. Request captions separately only if needed.
Keep channel handles, dates, caption origin and timestamp units explicit.
Save the submission receipt, job ID, raw JSON and normalized output.
Resume accepted work; do not submit again after a timeout or agent restart.
Verify the output before scheduling. Have the owner claim access and approve
the required permissions and shared balance for continued use.
Keep keys in the host's secret store. Stop on revoked access or insufficient balance.
```

[المحاكمة والمطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md) · [المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md) · [حفظ النتائج](https://flashdata.dev/ar/docs/guides/save-results/reference.md).

<a id="faq"></a>
## أسئلة الهجرة

### هل هذه هي مقارنة البحث Bright Data Google؟

تغطي هذه الصفحة YouTube المكشطة API. يستخدم البحث Google منتج SERP الخاص بـ Bright Data، مع وحدات تسعير مختلفة وتكوين الطلب. مقارنة البحث Google لها صفحتها الخاصة.

### هل Bright Data يتقاضى رسومًا مرتين مقابل البيانات الوصفية والنص؟

يشتمل مخطط الفيديو YouTube الخاص به على البيانات الوصفية وحقول التسميات التوضيحية في سجل الفيديو الذي تم إرجاعه. لا تحسب سجلين تلقائيًا. FlashData يستخدم بيانات تعريف منفصلة واستعلامات نصية؛ يحسب عبء العمل المدمج في الآلة الحاسبة طلبين FlashData لكل فيديو. قد لا يكون حقل التسمية التوضيحية متاحًا لمقطع فيديو معين.

### ما هو المزود الذي لديه البدل المجاني الأكبر؟

Bright Data يقدم حسابات مؤهلة 5,000 رصيد مشترك كل شهر. بدل الاشتراك المؤهل لـ FlashData هو رصيد أولي، وتجربة الوكيل المؤقت منفصلة. هذه العروض لها قواعد تجديد مختلفة. استخدم مدخلات التسجيل الحر المتبقية للنموذج Bright Data PAYG بدقة.

### هل يمكنني استبدال كل مكشطة Bright Data؟

انقل بيانات التعريف YouTube المدعومة وسير عمل البحث والقناة والتسمية التوضيحية التي تحتاجها. احتفظ بجمع التعليقات والأنظمة الأساسية الاجتماعية الأخرى ومجموعات البيانات المُدارة وعمليات تكامل تسليم التخزين الحالية حيث لا يزال تطبيقك يعتمد عليها.

### هل يدعم كلا المزودين وكلاء الذكاء الاصطناعي؟

نعم. كلاهما يقدم MCP، CLI ومهارات الوكيل. تعد FlashData المستقلة CLI وأذونات المصدر ورصيد Google/YouTube المشترك مفيدة لسير عمل بحثي مركّز. أعد استخدام الوصول المحفوظ واطلب من المالك الموافقة على استمرار الوصول إلى الحساب قبل جدولة العمل المتكرر.

### هل يمكنني إعادة استخدام لقطة ID بعد الترحيل؟

لا، احفظ لقطة Bright Data ووظيفة FlashData الجديدة ID كمعرفات منفصلة. يعيد المثال استخدام إيصال FlashData المحفوظ فقط ويتحقق من أن الفيديو الذي تم إرجاعه يطابق ID المطلوب.

[احصل على مفتاح API](https://flashdata.dev/signup) · [Google مقارنة البحث](https://flashdata.dev/ar/compare/brightdata/reference.md).
