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 CMS الذي يتصرف نيابةً عن مالك المحتوى المحدد في قيمة المعلمة. هذه المعلمة مخصصة لشركاء محتوى YouTube الذين يملكون ويديرون العديد من قنوات YouTube المختلفة. تتيح هذه الميزة لمالكي المحتوى المصادقة مرة واحدة والوصول إلى كل بيانات الفيديو والقناة بدون الحاجة إلى تقديم بيانات اعتماد المصادقة لكل قناة على حدة. يجب ربط حساب CMS الفعلي الذي يصادق المستخدم معه بمالك محتوى YouTube المحدد.
tfmt string
تحدّد المعلّمة tfmt أنّه يجب عرض مسار الترجمة بتنسيق معيّن. إذا لم يتم تضمين المعلمة في الطلب، سيتم عرض المسار بتنسيقه الأصلي.

القيم المسموح بها هي:
  • sbv – الترجمة المصاحبة للمشاهد الفرعي
  • scc – تنسيق Scenarist Closed Caption
  • srt – الترجمة المصاحبة
  • ttml – تسمية توضيحية بلغة ترميز النص المحدد بوقت
  • vtt – تسمية توضيحية لمسارات نصوص الفيديو على الويب
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 لاستدعاء واجهة برمجة التطبيقات هذه والاطّلاع على طلب واجهة برمجة التطبيقات والاستجابة له.