تخطَّ إلى المحتوى
AR
الحصول على مفتاح API

YouTube مقارنة البيانات API

Apify بديل

من تشغيل الممثل إلى عمليات البحث المباشرة عن الفيديو.

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

القراءة بصيغة Markdown

01 · لتطبيقات الفيديو والوكلاء

مقارنة الميزات

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

مقارنة الميزات على حدة: FlashData و Apify YouTube ممثلين
ميزةFlashDataApify YouTube ممثلين
حافظ على عمليات البحث المستهدفة اقتصادية
الاستخدام المدفوع بدون اشتراك شهرينعماعتمادات الدفع أولاً بأول؛ عمليات تعبئة الرصيد من $10ميزانية مجانية، ثم خطة مدفوعة$5/شهر مجاناً؛ Starter $19/شهر مع استخدام $19
البيانات الوصفية لـ 1,000 الفيديو المعروف IDs$0.50معدل استخدام الدفع عند الاستخدام$3.00streamers/youtube-scraper · Starter, deducted from the plan’s budget
بحث فيديو واحدنعمواحد صريح video_idتعتمد على الممثليدعمها اللافتات. API يستبعد Dojo حاليًا الفيديو الفردي URLs
ابحث عن مقاطع الفيديو التي يحتاجها تطبيقك وقم بإثرائها
اكتشاف الكلمات الرئيسية باستخدام مرشحات البحثنعممرشحات التاريخ والمدة والنوع والفرزنعمsearchQueries بالإضافة إلى مرشحات الفرز والتاريخ والفيديو
بيانات العنوان والقناة والمشاركةنعمبحث مخصص عن البيانات الوصفية بالفيديو IDنعمتسجيلات الفيديو في مجموعة بيانات الممثل
قم بتحديث البيانات التعريفية بشكل منفصل عن التسميات التوضيحيةنعماطلب فقط youtube_metadata للتجديدنعماركض باستخدام transcriptionAndSubtitle=NONE
قم بإعداد دليل التسمية التوضيحية لتطبيقك
اختر العديد من لغات التسميات التوضيحية الموجودةما يصل إلى 10 لغة صريحةالمسارات بالإضافة إلى الأخطاء لكل لغة في طلب نسخة واحدالفاعل الرئيسي: لغة واحدة أو أي لغة أخرىيمكن للجهات الفاعلة المختلفة الكشف عن مدخلات مختلفة
حدد أصل التسمية التوضيحية الصارمةالرافع أو الذي تم إنشاؤه YouTubeparams.auto يختار أصل واحد؛ لا يوجد احتياطي عبر الأصلالفاعل الرئيسي: تفضيل الأصلpreferAutoGeneratedSubtitles تفضيل وليس نفس العقد
نص ذو طابع زمني لاستشهادات المصدرتطبيع JSON شرائحإرسال رسالة نصية تبدأ /end مرة في ثوانٍترجمات SRT أو VTT أو XMLتحليل تنسيق الترجمة المحدد لتوقيت الاقتباس
نص عادي للتلخيصfullText بجانب الشرائحتنسيق العنوان الفرعي نص عاديأو قم بتحليل والانضمام إلى إخراج الترجمة الموقوتة
مقاطع فيديو بدون نص موجودالإبلاغ عن المسار المفقودلا يوجد توليد الكلام إلى النصالنسخ الاختياري لمنظمة العفو الدوليةأوضاع النسخ الاحتياطي أو النسخ دائمًا؛ رسوم استخدام منفصلة
قم بتشغيل سير العمل برمز تكامل أقل
النتيجة المباشرة دون إدارة موارد الممثلالنتائج في الوقت الحقيقي[] + الاستخداملا يوجد ممثل 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.

02 · أعرف ما الذي تستبدله

لا يوجد سعر واحد "Apify YouTube".

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

معدلات نتائج الممثل المنشورة، USD لكل 1,000 مقاطع فيديو
ممثلمقاطع فيديو مجانية / 1,000StarterScaleBusinessاختره ل
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.

Reviewed 2026-11-10. - وضع خطط شهرية للمحافظة الذاتية؛ Starter خرائط إلى Bronze, Scale إلى Silver و Business إلى Gold. المكتشفون الأرخص لا يُستبدلون بآلة حاسبة الفيديو المعروفة

تحقق من الحدث القابل للفوترة

اقرأ الممثل الدقيق ID وتفاصيل الأحداث في مسيرتك الحالية. توجد نماذج الدفع لكل حدث والدفع لكل استخدام والنماذج المجمعة. بالنسبة للممثل الرئيسي هنا، قم بإحصاء الأحداث الناتجة والإضافات الممكّنة؛ لا تقم بإضافة رسوم حسابية عامة ثانية.

تسميات توضيحية منفصلة عن النص الصوتي الذي تم إنشاؤه

يمكن للترجمات الموجودة أن تصاحب النتيجة. تتم محاسبة النسخ باستخدام الذكاء الاصطناعي لكل دقيقة فيديو يتم تشغيلها: على Starter، يضيف الفيديو الذي تبلغ مدته 10 دقيقة $0.41 قبل حدث النتيجة $0.003. FlashData يسترد المسارات الموجودة. لا يؤدي هذا الجيل.

أبقِ تكاليف الاكتشاف مرئية

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

03 · أسعار الوحدات ورسوم المنصة

قارن المهمة بأكملها، مع الخطط على كلا الجانبين.

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

1,000 FlashData requests · 1,000 Actor result events

الممثل : streamers/youtube-scraper. نتيجة واحدة لكل فيديو معروف، مع ترجمات اختيارية موجودة. الجهات الفاعلة في مجال الاكتشاف الأرخص لها مدخلات مختلفة وهي مدرجة أعلاه.

FlashData · الدفع حسب الاستخدام

$0.50لكل 1,000 مقطع فيديو · سير العمل المحدد

$0.50 / 1,000 طلبات × 1 لكل فيديو

الرسوم الشهرية
$0.00
الاستخدام المشترك متضمن / شهر
$0.00
مقاطع الفيديو ضمن الاستخدام المضمن
0
الاستخدام فوق الرصيد المتضمن
$0.50
التكلفة الشهرية النموذجية
$0.50
الشراء من رصيد صفر
$10.00
تكلفة فعالة / 1,000 مقاطع فيديو
$0.50

لا يوجد اشتراك شهري. يمكن للحد الأدنى من تعبئة الرصيد الذي يبلغ $10 تمويل هذا الطلب والطلبات اللاحقة.

Apify · Starter

$3.00لكل 1,000 مقطع فيديو · سير العمل المحدد

حدث نتيجة واحد لكل فيديو؛ تم تضمين الترجمات الموجودة

الرسوم الشهرية
$19.00
الاستخدام المشترك متضمن / شهر
$19.00
مقاطع الفيديو ضمن الاستخدام المضمن
6,333
الاستخدام فوق الرصيد المتضمن
$0.00
التكلفة الشهرية النموذجية
$19.00
تكلفة فعالة / 1,000 مقاطع فيديو
$19.00

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

كيف يعمل التقدير

USD، خطط القائمة الشهرية. يستخدم هذا النموذج الحدث الناتج لأجهزة البث/youtube-scraper، وهو مقطع فيديو واحد يتم إرجاعه لكل إدخال ID، مع تصفية التاريخ وإيقاف تشغيل الوظائف الإضافية للذكاء الاصطناعي. تستخدم الترجمات الموجودة الإعداد ALWAYS_SUBTITLES؛ البيانات الوصفية بالإضافة إلى التسميات التوضيحية هي نتيجة ممثل واحد ولكن طلبين FlashData. FlashData الأسعار تأتي من كتالوج البيانات YouTube الحالي. يتم تخصيص الرصيد المضمن بالكامل لكل خطة لسير العمل هذا قبل إضافة الاستخدام الإضافي. Apify توقفات مجانية بميزانيتها $5؛ تضيف الخطط المدفوعة استخدامًا أعلى من الميزانية المضمنة. FlashData المشتريات من رصيد صفر تتضمن $10 الحد الأدنى لتعبئة الرصيد عند الحاجة إلى رصيد إضافي. يتم استبعاد الضرائب والخصومات السنوية والممثلين الآخرين ورسوم التخزين المنفصلة/export والمحاولات failed. عند عدم وجود مقاطع فيديو، لا تزال الخطة المدفوعة المحددة لها رسوم شهرية؛ التكلفة الفعلية لكل فيديو غير محددة.

خطط منصة Apify الشهرية

خطط لميزانيات البث المباشر /youtube-scraper أحداث النتيجة
Apify خطةالرسوم الشهريةشامل الاستخدام/شهرالممثل الرئيسي / 1,000 مقاطع الفيديومقاطع الفيديو ضمن هذه الميزانية
مجاني$0.00$5.00$4.001,250
Starter$19.00$19.00$3.006,333
Scale$199.00$199.00$2.6076,538
Business$999.00$999.00$2.40416,250

تقوم أعداد مقاطع الفيديو هذه بتخصيص ميزانية الخطة الكاملة للأحداث الناتجة، دون أي إضافات مدفوعة أو أي استخدام آخر للنظام الأساسي. إذا احتفظت بـ Apify لممثلين آخرين، قارن بين الاستخدام المتزايد والميزانية المتبقية؛ ولا يختفي هذا الاشتراك عندما يتحرك عبء عمل واحد.

جميع خطط البيانات FlashData YouTube
FlashData YouTube تسعير البيانات
FlashData خطةلكل 1,000 طلباتالرسوم الشهريةالطلبات المشمولة شهريًا
الدفع حسب الاستخدام$0.50$0.000
Micro$0.40$49.00125,000
Starter$0.35$199.00571,428
Pro$0.30$499.001,666,666
Scale$0.25$999.004,000,000
Business$0.20$1,999.0010,000,000

هذه هي معدلات طلب البيانات القياسية YouTube. البحث الموسع والتنزيل لهما أسعار منفصلة.

كامل YouTube تسعير البيانات →
حرية الوصول والشراء الأول

Apify مجاني لديه ميزانية استخدام شهرية $5 مشتركة؛ يمكن للجهات الفاعلة الفردية فرض قيود على العرض التوضيحي. تم التحقق منها FlashData يمكن أن تحصل الاشارات على علاوة أولية تصل إلى الحد الأقصى 4,000 المعيار YouTube طلبات البيانات. FlashData لا تتم إعادة تعيين بدل الاشتراك الأولي شهريًا. تم شرح تجربة الوكيل المنفصلة أدناه.

يمكن أن يكلف استخدام FlashData الدفع أولاً بأول أقل من $10 الحد الأدنى لشراء الرصيد. تعرض الآلة الحاسبة كلاً من تكلفة الاستخدام والشراء من رصيد صفري.

04 · هجرة قابلة للتشغيل

احتفظ بقارئ مجموعة البيانات. استبدال بحث واحد.

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

1 إعداد الوصول وخريطة الطلب

أنشئ مفتاحًا أو أعد استخدامه بإذن youtube_metadata في API مفاتيح وتحقق من الاعتمادات المتاحة. يمكن للوكيل إعادة استخدام الوصول أو بدء تجربة مؤهلة. احتفظ بالمفتاح في بيئتك أو في المطالبة المخفية للبرنامج النصي.

استدعاء الممثل الحالي · مرجع فقط
# 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 · POST /v1/queries/realtime
{
  "source": "youtube_metadata",
  "video_id": "FUfGcZ092b0",
  "params": {
    "include_formats": false,
    "include_chapters": true
  }
}

تقوم نقطة نهاية مزامنة الممثل بالفعل بإرجاع البيانات في استجابة واحدة HTTP. التغيير هو الإدخال ومغلف النتيجة وتعيين الحقل - وليس ادعاء بأن كل بحث عن ممثل يحتاج إلى الاقتراع.

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

يتطلب Python 3.10+ و requests. التثبيت مع python -m pip install requests. احفظ النص الكامل كـ video-lookup.py في مجلد عمل جديد. يقرأ FLASHDATA_API_KEY من البيئة أو يطالب بشكل خاص.

video-lookup.py
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 بفيديو عام من مجموعة البيانات الموجودة لديك.

بحث واحد عن البيانات الوصفية
python video-lookup.py FUfGcZ092b0 video-001

إعادة استخدام video-001 يقرأ الرد المحفوظ دون اتصال API آخر. استخدم مجلدًا جديدًا فقط لطلب جديد مقصود. المحاولات الفاشلة أو المتقطعة تتوقف للتفتيش؛ ولا يتم إعادة إرسالها تلقائيًا.

3 قم بتوجيه القارئ إلى العناصر المحفوظة

video-001/dataset-items.json يحتوي على عنصر واحد معين. response.json يحافظ على النتيجة الأولية والاستخدام الفعلي. استبدل خطوة جلب مجموعة البيانات بقارئ الملفات أو التخزين.

هذا محول حقل، وليس Apify مجموعة البيانات API. التهم المفقودة تبقى null. يبقى تاريخ النشر الأولي في uploadDateRaw؛ لا يخترع البرنامج النصي date أو التعليقات أو حالة تحقيق الدخل أو حقول النص التي تم إنشاؤها.

مخطط البيانات الوصفية →
توضيحية dataset-items.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 / viewCountlikeCount / commentCount / viewCountاحتفظ بالقيم المفقودة مثل null. المقياس المفقود ليس صفراً.
المدة، غالبًا HH:MM:SSالمدة بالثوانييقوم المثال بتحويل الثواني إلى سلسلة HH:MM:SS، مع الاحتفاظ بـ null.
التاريخ، والذي قد يكون مطلقًا أو نسبيًاuploadDateالمثال يبقي uploadDateRaw. أضف محلل التاريخ الخاص بك قبل ملء التاريخ الطبيعي.
ترجمات[] / transcriptionUrlطلب youtube_transcript أو youtube_captions منفصلتعد المسارات الحالية وتحويل الكلام إلى نص مُدخلات مختلفة لتطبيقك.
مجالات الإثراء للممثل فقطلا يوجد معادل تلقائياحتفظ بخطوة إثراء منفصلة للتعليقات وتوسيع القناة والتحليلات التي ينشئها الذكاء الاصطناعي.
حمل نية الترجمة، وليس مجرد قيمة منطقية
خيارات الترجمة للممثل الرئيسي وترحيل FlashData
إعداد الممثل الحاليFlashData تغير
ALWAYS_SUBTITLESقم بإضافة طلب youtube_transcript أو youtube_captions منفصل لمسار موجود.
subtitlesLanguage: arاضبط params.language على en. تقوم مجموعة تصل إلى 10 من اللغات بإرجاع المسارات بالإضافة إلى الأخطاء لكل لغة.
preferAutoGeneratedSubtitlesيعد إعداد الممثل هذا بمثابة تفضيل. FlashData params.auto صارم: true لـ YouTube الذي تم إنشاؤه، false للتحميل المقدم. اختر عمدا؛ لا يوجد احتياطي عبر الأصل.
TRANSCRIPTION_AS_FALLBACK / ALWAYS_TRANSCRIBEاحتفظ بخطوة منفصلة لتحويل الكلام إلى نص. FlashData لا يُنشئ مسارًا عندما تكون التسميات التوضيحية الموجودة مفقودة.
ترجمات[].srt / transcriptionUrlقم بتكييف المقاطع ذات الطابع الزمني لتناسب القارئ الخاص بك، أو قم بتنسيق ملف التسميات التوضيحية بشكل صريح. لا تعامل النص العادي الذي تم إنشاؤه URL كبيانات مقطعية.
وصفة التسميات التوضيحية ذات الطابع الزمني →

05 · الحفاظ على باقي سير العمل

نقل المنتج والتخزين والجدول الزمني عمدا.

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

من البنية الأساسية للممثل إلى سير عمل التطبيق
قلقApifyFlashData
طلبخيارات الممثل 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؛ ترحيل الجدول الزمني والمستهلك معا

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

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

حفظ وإعادة استخدام النتائج →

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

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

مرجع المعالجة المجمعة →

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

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

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

06 · الترميز والوكلاء الشخصيين

قم بترحيل مهمة واحدة مفيدة قبل الاستخدام المتكرر.

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

  1. فحص تكامل الممثل الحالي.

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

  2. إثبات بحث واحد.

    استخدم CLI أو SDK أو MCP، واحفظ الاستجابة الأولية وقم بتعيين الحقول التي يحتاجها تطبيقك فقط.

  3. المطالبة باستمرار الاستخدام.

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

  4. إعادة استخدام بيانات اعتماد المالك.

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

قم بإعطاء مهمة الترحيل هذه إلى وكيلك
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.

07 · أسئلة الهجرة

قبل التبديل

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

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

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

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

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

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

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

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

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

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

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

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

ابدأ بفيديو واحد معروف

تحويل نتيجة الممثل إلى تطبيق API مكالمة.

احتفظ بالبيانات التي تحتاجها واحفظ المخرجات التي يتوقعها القارئ.