Captions: download

تنزيل مسار الترجمة والشرح يتم عرض مسار الترجمة والشرح بتنسيقه الأصلي ما لم يحدّد الطلب قيمة للمَعلمة tfmt وبلغته الأصلية ما لم يحدّد الطلب قيمة للمَعلمة tlang.

تأثير الحصة: تبلغ تكلفة الحصة لاستدعاء هذه الطريقة 200 وحدة.

تتطلب هذه الطريقة أن يكون لدى المستخدم إذن تعديل الفيديو.

حالات الاستخدام الشائعة

طلب

طلب HTTP

GET https://www.googleapis.com/youtube/v3/captions/id

التفويض

يتطلب هذا الطلب تفويضًا باستخدام نطاق واحد على الأقل من النطاقات التالية (مزيد من المعلومات حول المصادقة والتفويض).

النطاق
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

المعلمات

يسرد الجدول أدناه المَعلمات التي يتيحها طلب البحث هذا. وجميع المَعلمات المُدرَجة هي مَعلمات طلب بحث.

المعلمات
المعلمات المطلوبة
id string
تحدّد المَعلمة id مسار الترجمة والشرح الذي يتم استرداده. القيمة هي رقم تعريف مسار الترجمة والشرح كما تحدّده السمة id في مصدر caption.
المعلمات الاختيارية
onBehalfOfContentOwner string
لا يمكن استخدام هذه المَعلمة إلا في طلب مُصرَّح به بشكلٍ صحيح. ملاحظة: هذه المَعلمة مخصّصة حصريًا لشركاء المحتوى على YouTube.

تشير المَعلمة onBehalfOfContentOwner إلى أنّ بيانات اعتماد التفويض الخاصة بالطلب تحدّد مستخدمًا في نظام إدارة محتوى YouTube يتصرّف نيابةً عن مالك المحتوى المحدّد في قيمة المَعلمة. هذه المَعلمة مخصّصة لشركاء المحتوى على YouTube الذين يملكون قنوات مختلفة على YouTube ويديرونها. تسمح هذه المَعلمة لمالكي المحتوى بالمصادقة مرة واحدة والوصول إلى جميع بيانات الفيديو والقناة، بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة فردية. يجب ربط حساب نظام إدارة المحتوى الفعلي الذي يصادق المستخدم عليه بمالك المحتوى المحدّد على YouTube.
tfmt string
تحدّد المَعلمة tfmt أنّه يجب عرض مسار الترجمة والشرح بتنسيق معيّن. إذا لم يتم تضمين المَعلمة في الطلب، يتم عرض المسار بتنسيقه الأصلي.

القيم المسموح بها هي:
  • sbv - ترجمة SubViewer
  • scc - تنسيق Scenarist لـ ترجمة وشرح
  • srt - ترجمة SubRip
  • ttml - ترجمة Timed Text Markup Language
  • vtt - ترجمة Web Video Text Tracks
tlang string
تحدّد المَعلمة tlang أنّه يجب أن يعرض الردّ من واجهة برمجة التطبيقات ترجمة لمسار الترجمة والشرح المحدّد. قيمة المَعلمة هي رمز لغة مكوّن من حرفَين وفقًا لمعيار ISO 639-1 يحدّد لغة الترجمة والشرح المطلوبة. يتم إنشاء الترجمة باستخدام الترجمة الآلية، مثل "ترجمة Google".

نص الطلب

لا تُدرِج نص طلب عند استدعاء هذه الطريقة.

الردّ

في حال نجاح هذه الطريقة، يتم عرض ملف ثنائي. يكون عنوان Content-Type للردّ هو application/octet-stream.

الأخطاء

يحدّد الجدول أدناه رسائل الخطأ التي يمكن أن تعرضها واجهة برمجة التطبيقات ردًا على استدعاء هذه الطريقة. يُرجى الاطّلاع على مستندات رسائل الخطأ لمزيد من التفاصيل.

نوع الخطأ تفاصيل الخطأ الوصف
forbidden (403) forbidden الأذونات المرتبطة بالطلب غير كافية لتنزيل مسار الترجمة والشرح. قد لا يكون الطلب مُصرَّحًا به بشكلٍ صحيح.
invalidValue (400) couldNotConvert تعذّر تحويل بيانات مسار الترجمة والشرح إلى اللغة و/أو التنسيق المطلوبَين. تأكَّد من أنّ قيمتَي tfmt وtlang المطلوبتَين صالحتان، وأنّ snippet.status لمسار الترجمة والشرح المطلوب ليس failed.
notFound (404) captionNotFound تعذّر العثور على مسار الترجمة والشرح. تحقَّق من قيمة المَعلمة id في الطلب للتأكّد من أنّها صحيحة.

جرِّبها الآن.

استخدِم APIs Explorer لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب بيانات من واجهة برمجة التطبيقات والردّ منها.