# Apify بديل لـ YouTube البيانات

قارن FlashData مع الجهات الفاعلة Apify YouTube: الأسعار الخاصة بالممثل، وميزانيات الاستخدام الشهرية، والبيانات الوصفية وسير عمل التسميات التوضيحية، وأمثلة ترحيل Python وBash القابلة للتشغيل.

من تشغيل الممثل إلى عمليات البحث المباشرة عن الفيديو. ابدأ بالـ IDs المعروف، واحتفظ بحقول التطبيق الخاصة بك وانقل منتجًا واحدًا قبل تغيير بقية خط الأنابيب.

واستعرضت وقائع Apify 2026-11-10. وتستخدم معدلات زيكس كيزوك (FlashData) وبدلات المحاكمة فهرسها العام الحالي.

- [الميزات](#features)
- [تسعير الممثل](#actors)
- [مقارنة التكاليف](#costs)
- [ترحيل البحث](#migration)
- [مجموعات البيانات والجداول الزمنية](#production)
- [لوكلاء الذكاء الاصطناعي](#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, deducted from the plan’s budget |
| بحث فيديو واحد | نعم — واحد صريح video_id | تعتمد على الممثل — يدعمها اللافتات. API يستبعد Dojo حاليًا الفيديو الفردي URLs |

### ابحث عن مقاطع الفيديو التي يحتاجها تطبيقك وقم بإثرائها

| ميزة | FlashData | Apify YouTube ممثلين |
| --- | --- | --- |
| اكتشاف الكلمات الرئيسية باستخدام مرشحات البحث | نعم — مرشحات التاريخ والمدة والنوع والفرز | نعم — searchQueries بالإضافة إلى مرشحات الفرز والتاريخ والفيديو |
| بيانات العنوان والقناة والمشاركة | نعم — بحث مخصص عن البيانات الوصفية بالفيديو ID | نعم — تسجيلات الفيديو في مجموعة بيانات الممثل |
| قم بتحديث البيانات التعريفية بشكل منفصل عن التسميات التوضيحية | نعم — اطلب فقط youtube_metadata للتجديد | نعم — اركض باستخدام transcriptionAndSubtitle=NONE |

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

| ميزة | FlashData | Apify YouTube ممثلين |
| --- | --- | --- |
| اختر العديد من لغات التسميات التوضيحية الموجودة | ما يصل إلى 10 لغة صريحة — المسارات بالإضافة إلى الأخطاء لكل لغة في طلب نسخة واحد | الفاعل الرئيسي: لغة واحدة أو أي لغة أخرى — يمكن للجهات الفاعلة المختلفة الكشف عن مدخلات مختلفة |
| حدد أصل التسمية التوضيحية الصارمة | الرافع أو الذي تم إنشاؤه YouTube — params.auto يختار أصل واحد؛ لا يوجد احتياطي عبر الأصل | الفاعل الرئيسي: تفضيل الأصل — preferAutoGeneratedSubtitles تفضيل وليس نفس العقد |
| نص ذو طابع زمني لاستشهادات المصدر | تطبيع JSON شرائح — إرسال رسالة نصية تبدأ /end مرة في ثوانٍ | ترجمات SRT أو VTT أو XML — تحليل تنسيق الترجمة المحدد لتوقيت الاقتباس |
| نص عادي للتلخيص | fullText بجانب الشرائح | تنسيق العنوان الفرعي نص عادي — أو قم بتحليل والانضمام إلى إخراج الترجمة الموقوتة |
| مقاطع فيديو بدون نص موجود | الإبلاغ عن المسار المفقود — لا يوجد توليد الكلام إلى النص | النسخ الاختياري لمنظمة العفو الدولية — أوضاع النسخ الاحتياطي أو النسخ دائمًا؛ رسوم استخدام منفصلة |

### قم بتشغيل سير العمل برمز تكامل أقل

| ميزة | FlashData | Apify YouTube ممثلين |
| --- | --- | --- |
| النتيجة المباشرة دون إدارة موارد الممثل | النتائج في الوقت الحقيقي[] + الاستخدام — لا يوجد ممثل ID، بناء أو إعداد الذاكرة | تشغيل الممثل + مخطط الإدخال — يمكن لنقطة نهاية المزامنة أيضًا إرجاع النتائج في مكالمة واحدة بقيمة HTTP |
| معالجة القائمة المحفوظة في وحدة تحكم المتصفح | Bulk Jobs بملف فيديو-ID — تتبع التقدم واسترجاع أجزاء البيان والنتيجة | وحدة تحكم الممثل مع مدخلات URL — يدعم CSV أو Google واردات الورقة |
| نتائج الخلفية بعد قطع اتصال العميل | تم الحفظ async أو مهمة مجمعة ID — استئناف التحقق من الحالة واسترداد مخرجات completed | تشغيل الممثل المحفوظ ومجموعة البيانات IDs — فحص التشغيل واسترداد عناصر مجموعة البيانات الخاصة به |
| تنسيقات إخراج التطبيق والوكيل | JSON، نص عادي أو Markdown | صادرات مجموعة البيانات — JSON، CSV، إكسل وغيرها من التنسيقات |
| جمع متكرر | مضيف الجدولة أو الوكيل الخاص بك — أعد استخدام بيانات اعتماد المالك وحالة المهمة المحفوظة | جداول الممثل المستضاف — كرون وإعدادات المنطقة الزمنية وخطافات الويب الاختيارية |
| البيانات الوصفية والتسميات التوضيحية وGoogle البحث في عقد API واحد | استعلام واحد API، أذونات خاصة بالمصدر — رصيد الحساب المشترك؛ أسعار محددة المصدر | منصة مشتركة؛ مخططات خاصة بالممثل — اختيار مدخلات ومخرجات الممثل ذات الصلة والحفاظ عليها |
| CLI وSDKs وMCP للأتمتة | نعم — مستقل CLI؛ Python، TypeScript وGo SDKs؛ MCP | نعم — Apify CLI, Python/JavaScript العملاء و MCP |

تشير الصفوف الخاصة بالممثل إلى القائمين بالبث/youtube-scraper ما لم يتم تسمية ممثل آخر. تقدم كلتا الخدمتين أدوات تطوير البرمجيات (SDK)، CLI وMCP. Apify يدير أيضًا تعليمات برمجية مخصصة وجداول مستضافة وكاشطات لمواقع الويب الأخرى.

### اجعل عمليات البحث عن مقطع فيديو واحد صغيرة

قم بتمرير مقطع فيديو ID واحصل على البيانات الوصفية مباشرةً. استخدم إمكانية الوصول للدفع عند الاستخدام عندما لا تحتاج المهمة إلى اشتراك في النظام الأساسي أو الزحف إلى القناة.

### احتفظ بنموذج بيانات تطبيقك

قم بتعيين الحقول التي يقرأها تطبيقك بالفعل. احتفظ بأعداد null، واحتفظ بتواريخ النشر بشكل واضح واحفظ مصفوفة JSON للمستهلكين الذين قرأوا عناصر مجموعة البيانات مسبقًا.

### أبقِ الاكتشاف منفصلاً عن الإثراء

واصل سير عمل الاكتشاف المفيد، وقم بإلغاء تكرار الفيديو الخاص به IDs، ثم قم بإثراء مقاطع الفيديو التي يحتاجها منتجك فقط باستخدام FlashData.

<a id="actors"></a>
## لا يوجد سعر واحد Apify YouTube

يختار المؤلفون الممثلون المدخلات والمخرجات ونماذج التسعير. تستخدم هذه الجهات الفاعلة الثلاثة الأحداث لكل نتيجة، ولكن لديها قدرات مختلفة. الأسعار أدناه هي USD لكل 1,000 مقاطع فيديو يتم إرجاعها.

| ممثل | مقاطع فيديو مجانية / 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 الخاص به لكل دقيقة بدء لكل فيديو: على Starter، يضيف مقطع فيديو مدته 10 دقيقة $0.41 قبل حدث النتيجة $0.003. ملخصات الذكاء الاصطناعي والأوصاف وتصفية تاريخ القناة لها أيضًا أسعار الأحداث الخاصة بها. FlashData يسترد المسارات الموجودة. ولا يُنشئ التسميات التوضيحية المفقودة.

### أبقِ الاكتشاف منفصلاً عن الإثراء

استخدم الفيديو المعروف IDs عندما يكون هذا هو ما يحتوي عليه تطبيقك بالفعل. يمكن أن يؤدي الزحف الاكتشافي إلى إرجاع مقاطع الفيديو التي لا تستخدمها أبدًا. اكتشاف الميزانية وأي إثراء لاحق بشكل منفصل.

<a id="costs"></a>
## قارن أسعار الوحدات والرسوم الشهرية

USD، خطط القائمة الشهرية. يستخدم هذا النموذج الحدث الناتج لأجهزة البث/youtube-scraper، وهو مقطع فيديو واحد يتم إرجاعه لكل إدخال ID، مع تصفية التاريخ وإيقاف تشغيل الوظائف الإضافية للذكاء الاصطناعي. تستخدم الترجمات الموجودة الإعداد ALWAYS_SUBTITLES؛ البيانات الوصفية بالإضافة إلى التسميات التوضيحية هي نتيجة ممثل واحد ولكن طلبين 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/ar/pricing/youtube-data).

### أمثلة عملت

FlashData ادفع حسب الاستخدام مقابل Apify Starter واللافتات/youtube-scraper. البيانات الوصفية بالإضافة إلى الترجمات الموجودة هي حدث نتيجة ممثل واحد، ولكن طلبين 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 تحتوي بالفعل على الاستخدام المضمن؛ لا تضيف هذا الاستخدام مرتين. تتيح لك الآلة الحاسبة HTML اختيار كلا الخطتين بشكل مستقل.

### حرية الوصول

Apify مجاني لديه $5 ميزانية مشتركة شهرية؛ يمكن أيضًا تطبيق قيود العرض التوضيحي للممثل الفردي. حدود API Dojo Actor الموضحة أعلاه تصل إلى خمس عمليات تشغيل تجريبية شهريًا وعشرة عناصر لكل عملية تشغيل.

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

<a id="migration"></a>
## احتفظ بقارئ مجموعة البيانات؛ استبدال بحث واحد

ابدأ بفيديو عام معروف ID. يكتب المثال حقول الممثل المألوفة المحددة كمصفوفة JSON ويحفظ الاستجابة FlashData الكاملة بشكل منفصل.

### 1. قم بإعداد الوصول وتعيين الطلب

أنشئ مفتاحًا أو أعد استخدامه بإذن youtube_metadata في [API مفاتيح](https://flashdata.dev/app/api-keys) وتحقق من [الاعتمادات المتاحة](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
  }
}
```

يمكن لنقطة نهاية مزامنة الممثل بالفعل إرجاع العناصر في استجابة واحدة HTTP. ترحيل الطلب والمظروف والحقول؛ لا تقم بإضافة الاقتراع غير الضرورية.

### 2. احفظ البرنامج النصي، ثم قم بتشغيله

اختر Python أو Bash. يقدم كل مجلد إخراج جديد طلبًا واحدًا. إعادة استخدام المجلد يقرأ المخرجات المحفوظة؛ تمت مقاطعتها أو 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. اقرأ المخرجات المحفوظة

فيديو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 البيانات الوصفية | عمل الهجرة |
| --- | --- | --- |
| معرف / رابط | videoId | احتفظ بالمعرف وقم ببناء الساعة 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 منفصل | تعد المسارات الحالية وتحويل الكلام إلى نص مُدخلات مختلفة لتطبيقك. |
| مجالات الإثراء للممثل فقط | لا يوجد معادل تلقائي | احتفظ بخطوة إثراء منفصلة للتعليقات وتوسيع القناة والتحليلات التي ينشئها الذكاء الاصطناعي. |

[مخطط البيانات الوصفية](https://flashdata.dev/ar/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/ar/docs/guides/timestamped-captions-recipe/reference.md).

<a id="production"></a>
## مجموعات البيانات والوظائف والجداول الزمنية الطويلة running

إذا كانت أدواتك تعتمد على مجموعة البيانات Apify IDs والجداول الزمنية، فاحتفظ بممثل مخصص كمنسق: اتصل بـ FlashData بداخله واكتب العناصر المعينة في مجموعة البيانات الخاصة به. قم بموازنة وقت تشغيل الممثل وتخزينه جنبًا إلى جنب مع استخدام FlashData. الآلة الحاسبة أعلاه الموديلات مكالمات مباشرة FlashData.

| قلق | Apify | FlashData |
| --- | --- | --- |
| طلب | خيارات الممثل ID + البناء/input ؛ مهمة محفوظة اختيارية | المصدر + video_id + معلمات ؛ لا توجد خيارات بناء الممثل أو الذاكرة |
| نتيجة متزامنة | يقوم run-sync-get-dataset-items بإرجاع مصفوفة عناصر؛ حدها الموثق HTTP هو 300 ثانية | الاستجابة في الوقت الفعلي لها الحالة والنتائج[] والاستخدام؛ استخراج النتائج قبل تعيين الحقول |
| عمل طويل-running | ابدأ الجري، احفظ التشغيل ID، انتظر الحالة الطرفية، اقرأ defaultDatasetId | أرسل وظيفة async أو batch، واحفظ ID، واستطلع حالتها واحصل على نتيجتها |
| تخزين الإخراج | عناصر مجموعة البيانات بالإضافة إلى سجلات القيمة الرئيسية الاختيارية المشار إليها بـ URL | احفظ الاستجابة أو قم بالتصدير إلى وحدة التخزين الدائمة الخاصة بك؛ مجموعة البيانات Apify ID ليست FlashData وظيفة ID |
| العمل المتكرر | Apify يبدأ الجدول الزمني للممثلين/Tasks; تقوم خطافات الويب بإخطار المستهلكين المتلقين للمعلومات | استخدم مضيف التطبيق أو cron أو CI أو الوكيل للاتصال بـ FlashData؛ ترحيل الجدول الزمني والمستهلك معا |

### نقل مجموعة بيانات موجودة

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

[حفظ النتائج وإعادة استخدامها](https://flashdata.dev/ar/docs/guides/save-results/reference.md)

### تحديث مكتبة الفيديو

قم بإلغاء تكرار الفيديو IDs، وتحقق من كل نتيجة واحتفظ بالإدخال إلى الإخراج IDs. استخدم المعالجة المجمعة أو المجمعة للقوائم الأكبر حجمًا؛ أعد محاولة العناصر failed بعد التحقق من أخطائها.

[مرجع المعالجة بالجملة](https://flashdata.dev/ar/docs/reference/bulk-processing/reference.md)

### اجعل العمل المجدول قابلاً للتنبؤ به

قم بنقل المنطقة الزمنية والإيقاع وبيانات الاعتماد ووجهة الإخراج الخاصة بك. قم بتسجيل نافذة جدول completed واحدة قبل تقاعد المنتج القديم، بحيث لا تؤدي الجداول المتداخلة إلى إنشاء عمل مكرر.

[تشغيل المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)

### قائمة مراجعة القطع

1. قم بتسجيل الممثل الدقيق والبناء وإدخال المهمة والأحداث القابلة للفوترة وحقول الإخراج والمستهلك النهائي.
2. استنزاف عمليات التشغيل الحالية وتصدير جميع صفحات مجموعة البيانات. clean=true يمكنه تخطي السجلات، لذا فإن الصفحة القصيرة وحدها ليست دليلاً على اكتمال التصدير؛ التحقق من البيانات الوصفية لترقيم الصفحات.
3. تحقق من المحول مقابل IDs المحفوظة، بما في ذلك null المقاييس والتواريخ وأصل التسمية التوضيحية.
4. انقل الإيقاع والمنطقة الزمنية والوجهة إلى العداء الخاص بك. احتفظ بنقاط التفتيش. maxTotalChargeUsd ليس FlashData API-سقف إنفاق المفتاح؛ إضافة ضوابط الإنفاق على مستوى التطبيق.
5. قم بتبديل المنتج لنافذة الجدول الزمني التالية دون عمليات تشغيل مكررة. الحفاظ على الصادرات. توقف عن العمل المتكرر على بيانات الاعتماد الملغاة أو عدم كفاية الرصيد.

<a id="agents"></a>
## الترميز والوكلاء الشخصيين

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

1. حدد تكامل الممثل وأعد استخدام بيانات اعتماد FlashData الموجودة أولاً.
2. أثبت بحثًا واحدًا عن الفيديو واحفظ كلاً من المخرجات الأولية والمعينة مع الاستخدام الفعلي.
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/ar/docs/guides/agent-onboarding/reference.md) · [مستقل CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md) · [MCP الإعداد](https://flashdata.dev/ar/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>
## قبل التبديل

### هل هذا بديل لمنصة Apify؟

إنه يستبدل مكالمات بيانات YouTube محددة في سير العمل الخاص بك. يوفر Apify أيضًا سوقًا للممثلين وأوقات تشغيل مخصصة وجداول زمنية مستضافة وتخزينًا. احتفظ بتلك الأجزاء التي تستخدمها فيها، أو انقل مسؤولياتها إلى تطبيقك الخاص.

### لماذا لا تقارن كل ممثل بسعر واحد؟

يختار مطورو الممثل نماذج تسعير مختلفة ومخرجات وقيود على المدخلات. تستخدم الآلة الحاسبة أدوات البث/youtube-scraper. يتضمن جدول الممثل أيضًا ممثل اكتشاف أرخص؛ تعتبر القيود المفروضة على الفيديو الفردي مهمة عند استبدال البحث عند الطلب.

### هل يتم تحصيل رسوم اشتراك Apify مرتين مقابل الاستخدام المضمن؟

لا، رسوم الخطة تتضمن ميزانية استخدام مدفوعة مسبقًا. تقوم الآلة الحاسبة بطرح تلك الميزانية قبل إضافة المزيد من استخدام الممثل. ويفترض أن الميزانية بأكملها متاحة لسير العمل هذا. إذا استهلكه الممثلون الآخرون، يبقى أقل بـ YouTube.

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

يكتب المثال مصفوفة JSON بأسماء الحقول المألوفة المحددة. لا يقوم بإنشاء مجموعة بيانات Apify أو تشغيل ID. اقرأ الملف الجديد مباشرة، أو انشره من خلال وحدة التخزين الخاصة بك، أو احتفظ بممثل مخصص يكتب هذه العناصر المعينة إلى مجموعة البيانات الخاصة به للمستهلك الحالي.

### ماذا يحدث للترجمات والنسخ بالذكاء الاصطناعي؟

يقدم الممثل الرئيسي لـ Apify ترجمات موجودة ونسخًا اختياريًا مدعومًا بالذكاء الاصطناعي. FlashData يسترد المسارات YouTube الموجودة. اطلب البيانات التعريفية والتسميات التوضيحية بشكل منفصل، وتحقق من اللغة والأصل المرتجعين، واحتفظ بأي خطوة منفصلة لتحويل الكلام إلى نص أو خطوة ملخصة للذكاء الاصطناعي.

### هل سيتم تحويل جدولي الحالي أو الحد الأقصى للإنفاق؟

لا، أعد إنشاء الجدول في العداء الذي اخترته، وأضف فحص الميزانية على مستوى التطبيق. الإعداد Apify maxTotalChargeUsd ليس الحد الأقصى لإنفاق المفتاح FlashData API. تستخدم مفاتيح المالك رصيد الحساب المشترك.
