تصفح الوثائق
مرجع API
YouTube Trainability API
تحقق من YouTube البيانات الوصفية لرخصة الفيديو لعلامة مشاعات الإبداع واسترجاع النتيجة JSON.
إنشاء طلب
المعرّف المكوّن من 11 حرفًا في رابط الفيديو، وليس الرابط الكامل.
https://data.flashdata.dev/v1/queries/realtimeالبارامترات
أرسل source و video_id على المستوى الأعلى ولا يوجد في هذا المصدر مواظير خاصة بمصدر محدد. ويمكن إغفال الحقول الاختيارية.
نص الطلب
sourcestring / مطلوب- جاهزون إلى youtube_trainability.
video_idstring / مطلوب- معرّف فيديو YouTube من 11 محرفًا، مثل FUfGcZ092b0. يقبل الحروف والأرقام والشرطات السفلية والواصلات.بالضبط 11 الشخصياتالتقصير:
غير محددالشكل المقبول
^[A-Za-z0-9_-]{11}$ callback_urlstring · nullable / اختياري- لـ async وbatch فقط. رابط HTTPS عام للإشعار بالاكتمال على المنفذ 443، بطول يصل إلى 2,048 حرفًا، دون بيانات اعتماد مستخدم أو جزء رابط. احذف القيمة أو استخدم null أو سلسلة فارغة لعدم إرسال إشعار. في batch، ضعه في كل استعلام خارج params.التقصير:
غير محدد
استجابة
Realtime Returns status: done. اقرأ الناتج المصدري في results[0].permitted; usage.credits سجل التهمة.
تعيد النتيجة videoId وتعرض kind وetag وpermitted. يفحص العامل وسم ترخيص الفيديو: ["all"] عند اكتشاف وسم Creative Commons، وإلا ["none"]، بما في ذلك عند غياب بيانات الترخيص.
اقرأ النتيجة
وفّر ردّ شركة JSON الناجح على أنها response.json. احفظ هذا read-response.py و اركضوا بيثون read-response.py. إنها تستخدم فقط Pythonمكتبة عادية ولا تقدم طلباً جديداً
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {"videoId": result.get("videoId"), "permitted": result.get("permitted", [])}
# Keep the label values; this is not a training-rights authorization.
print(json.dumps(output, ensure_ascii=False, indent=2))وليس لهذا المصدر خيارات خاصة بمصدر معين. إرسال video_id على أعلى مستوى؛ omit params.
هذه النقطه النهائيه لا تسترجع المبدعين YouTube - أماكن تدريب طرف ثالث. ولا القيمة المسموح بها تمنح حقوق التدريب، الحقل هو فقط ناتج شيك الترخيص
جميع مجالات الاستجابة
| الميدان | الوصف |
|---|---|
sourcestring | المصدر المطلوب من شركة API. |
statusstring | تم عندما يتكلل الطلب بالنجاح. |
created_atstring | وقت إنشاء الاستجابة في شكل ISO 8601. |
usage.creditsnumber | إئتمانات مُقيدة على الطلب، بناءً على خطتك. |
results[0].videoIdstring | الفيديو المطلوب ID. |
results[0].kindstring | FlashData result type: youtube#videoTrainability. |
results[0].etagstring | Video ID echoed as the response tag. |
results[0].permittedarray<string> | ["all"] عند اكتشاف وسم Creative Commons؛ وإلا ["none"]، بما في ذلك عند غياب بيانات الترخيص. لا تعبّر هذه القيم عن إعدادات المنشئ لتدريب الجهات الخارجية في YouTube. |
وتصف المجالات المذكورة أعلاه رد شركة JSON. JSON, plain text and Markdown formats.
Async Returns one job receipt; batch return one per أشرطة فيديو ID. تحققي من حالة كل وظيفة وإسترجاع نتائجها باستخدام الوصلات العائدة
Async ' batch lifecycle
يعيد الإرسال إيصالًا وليس نتائج. ينشئ Async مهمة واحدة؛ ويعيد batch مهمة مستقلة في queries[] لكل سؤال مقبول تتبع كل وظيفة واسترجاعها بشكل مستقل.
Submit to data.flashdata.dev; قراءــة مركز العمل والنتائج api.flashdata.dev مع نفس X-API-Key. وتستخدم الأمثلة الأساسية للزدحام الزكسكسيك ذات الصلة API Python و cURL.
1. وفّر الوظيفة IDs
أبقوا حقول طلب هذا المصدر عند التحول إلى Async. وبالنسبة إلى Batch، وضع كل طلب داخل مجموعة الاستفسارات من جسم JSON. انقذوا كل عمل ID.
2. حالة التحقق
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: استطلاع مع التأخير والاحترامRetry-Afterعندما تكون حاضراًcompleted: تحقيق النتائجfailed: التفتيشjob.error.اقرأ job.statusليس حالة إيصال المعلومات.
المرجعي API3. نتائج الرسم
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsبعد الإكمال، توثّق النتيجة على النحو التالي، ثمّ تُحضر مخزن 302 URL بدون مفتاحك API. وفّر الرقم JSON في غضون ساعات الإنجاز من تاريخ الـ 24.
نتائج المشاهدة: Python و cURL · تنسيقات الاستجابة
Result download API reference
ولا تستهلك السياسات وتحقق النتائج القائمة أي تنازلات للأسئلة. ولا يلغى وقت الاقتراع هذا العمل: فإبقاء مقره ID بدلاً من تقديم عمل مكرر قابل للتعديل. شفرات الرعب وسلوك الاعادة.
إشعارات Webhook عند الاكتمال
Subscribe per query
المجموعة callback_url على أعلى مستوى لطلب الأسينك، أو داخل كل استفسار في دفعة، في الخارج params. ولا يلزم طلب تسجيل منفصل على الشبكة العالمية. ولا تُرسل طلبات شركة Realtime ردوداً.
استخدم عنوان HTTPS عامًا على المنفذ 443. ترسل FlashData إشعار POST لكل مهمة تصل إلى completed أو failed; The event contains links, not the result itself.
الاعتراف والتحقق
العودة 2xx بعد قبول الحدث بشكل مكثف. مُتَوَجَّل delivery_id, كما أُرسلت X-Delivery-Id. لا تتبع إعادة التوجيه.
عمليات التسليم الفاشلة تُعاد مع التراجع المفاجئ، حتى 8 مجموع المحاولات على الأكثر 24 بعد ساعات من الانتهاء. استمر في الاقتراع كتراجع
النداءات غير موقعة. تأكد من معرّف المهمة ومصدرها وحالتها النهائية باستخدام نقطة نهاية الوضع الموثقة قبل تجهيز الإخطار. التسليم ID هو للتحلل، وليس إثبات صحة.
مناسبة وميادين على الشبكة العالمية
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_trainability",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| الميدان | الوصف |
|---|---|
delivery_idstring | معرّف تسليم ثابت. امنع تكرار الإشعارات باستخدام هذه القيمة؛ وتُرسل أيضًا في ترويسة X-Delivery-Id. |
idstring | وظيفة(ب) ID. |
sourcestring | طلب مصدر بيانات. |
statusstring | اكتملت أو فشلت |
linksarray | وصلات الوضع والنتائج. ولا تشمل الإخطارات محتوى النتائج أو مفتاحاً من طراز API. |
links[].relstring | ذاتي أو نتائج. |
links[].hrefstring | عنوان URL كامل لواجهة الإدارة؛ صادِق باستخدام مفتاح API. |
links[].methodstring | GET. |
تجهيز ملفات Bulk
تحميل شريط فيديو واحد من طراز ID لكل خط وإنشاء وظيفة من طراز Bulk مع المصدر: youtube_trainability. وتنطبق الخيارات المشتركة على كل شركة ID في الملف.
وليس لدى هذا المصدر خيارات خاصة بمصدر محدد؛ ويضع المصدر ويرفع ملف ID.
استرجع المجموعة المكتملة كملف manifest وأجزاء نتائج NDJSON مضغوطة بـ gzip. يمكن لمصادر البيانات أيضًا تسليم أجزاء النتائج إلى تخزينك السحابي بضبط options.result_storage عند إنشاء مهمة Bulk. وفّر البيان وقطعه في غضون ساعات العمل التي تنجزها شركة 24 بعد أن اكتملت جميع وظائف شركة Bulk.
Bulk processing API ; Python and cURL · Batch JSON
بناء تدفق عمل من طراز Bulk لهذا المصدر · وقف، واستئناف واستعادة
التعافي من الأخطاء
نتيجة ["none"] هي فحص ترخيص مكتمل وليست مهمة فاشلة. وقد تعني غياب وسم الترخيص. قد يفشل استخراج الفيديوهات المحذوفة أو غير القابلة للوصول.
وللتوثيق، والتوازن، وطريقة الطلب، والإخفاقات في الحد الأقصى للمعدلات، تستخدم مرجع الخطأ المشترك. وقد يكون الوقت المتاح لتقديم الطلبات قد أدى إلى خلق وظيفة؛ والتحقق من العمل القائم قبل إعادة التجريب.
الأخطاء ورموز الحالة · متى يُعيدُ النظر · الحد الأقصى للمعدل
دليل الخطوة خطوة: بطاقات ترخيص الترجمة الشفوية
الأسعار
| الخطط | معدلات الاستخداملكل 1,000 طلب قياسي | الاشتراكات | تشمل الأرصدة الدائنة لكل فترة من فترات إعداد الفواتير |
|---|---|---|---|
| الدفع حسب الاستخدام | 0.50 US$ | بلا رسوم شهرية | أضف رصيدًا عند الحاجة |
| Micro | 0.40 US$ | 49.00 US$ / الشهر | 1,000 credits (50.00 US$ of API usage) included |
| Starter | 0.35 US$ | 199.00 US$ / الشهر | 4,000 credits (200.00 US$ of API usage) included |
| Pro | 0.30 US$ | 499.00 US$ / الشهر | 10,000 credits (500.00 US$ of API usage) included |
| Scale | 0.25 US$ | 999.00 US$ / الشهر | 20,000 credits (1,000.00 US$ of API usage) included |
| Business | 0.20 US$ | 1,999.00 US$ / الشهر | 40,000 credits (2,000.00 US$ of API usage) included |
خطة واحدة للحساب. رصيد مشترك للمنتجات الثلاثة. لا تُفرض رسوم مرة أخرى على الاستخدام المغطى بالرصيد المضمّن.
الأسعار والحدود الحالية للخطة