التنفيذ: الترجمة والشرح

توضّح الأمثلة التالية كيفية استخدام YouTube Data API (الإصدار 3) لتنفيذ وظائف ذات صلة بالترجمة والشرح.

استرداد قائمة بمسارات الترجمة والشرح لفيديو

لاسترداد قائمة بمقاطع الترجمة والشرح المتاحة لفيديو معيّن، يمكنك استدعاء الطريقة captions.list. اضبط قيمة المَعلمة videoId على معرّف فيديو YouTube الذي يحدّد الفيديو الذي يتم استرداد ترجمة وشرح له بشكل فريد. يجب أن تتم الموافقة على طلبك باستخدام بروتوكول OAuth 2.0.

يسترجع الطلب أدناه قائمة بالمقاطع الصوتية لفيديو على قناة Google Stories على YouTube:

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.list?
part=snippet
&videoId=PRU2ShMzQRg

اطّلِع على مستندات طريقة captions.list للحصول على عيّنات الرموز البرمجية.

إنشاء مقطع ترجمة وشرح

لا يمكن اختبار طلب البحث هذا باستخدام "مستكشف واجهات برمجة التطبيقات" لأنّه لا يتيح إمكانية تحميل الملفات، وهو شرط أساسي لاستخدام هذه الطريقة.

يمكنك استخدام طريقة captions.insert في واجهة برمجة التطبيقات لتحميل ملف ترجمة وشرح جديد لفيديو. عند تحميل مقطع صوتي، يجب تحديد قيمة لسمات مورد caption التالية:

  • snippet.videoId: يحدِّد هذا المَعلمة الفيديو الذي تتم إضافة مسار الترجمة والشرح إليه.
  • snippet.language - لغة مسار الترجمة والشرح
  • snippet.name: اسم مسار الترجمة.

تتوفّر الخيارات الإضافية التالية عند تحميل مسار ترجمة وشرح:

  • إذا عيّنت المَعلمة sync على true، سيتجاهل YouTube أي رموز زمنية في ملف الترجمة الذي تم تحميله وسينشئ رموز زمنية جديدة للترجمة.

    يجب ضبط المَعلمة sync على true إذا كنت تحمّل نصًا لا يحتوي على رموز زمنية، أو إذا كنت تشتبه في أنّ الرموز الزمنية في ملفك غير صحيحة وتريد أن تحاول YouTube تصحيحها.

  • في حال ضبط السمة snippet.isDraft لمصدر caption على true، لن يكون المقطع الصوتي مرئيًا للجميع.

اطّلِع على مستندات طريقة captions.insert للحصول على عيّنات الرموز البرمجية.

تنزيل مسار ترجمة وشرح

لا يمكن اختبار طلب البحث هذا باستخدام "مستكشف واجهات برمجة التطبيقات" لأنّه لا يتيح إمكانية تنزيل الملفات.

لتنزيل مقطع ترجمة وشرح محدّد، يمكنك استدعاء الطريقة captions.download. اضبط قيمة المَعلمة id على معرّف مسار الترجمة والشرح على YouTube الذي يحدّد بشكل فريد مسار الترجمة والشرح الذي يتم تنزيله. يجب أن تتم الموافقة على طلبك باستخدام بروتوكول OAuth 2.0.

تتيح واجهة برمجة التطبيقات من الإصدار 3 الخيارات التالية:

  • لتحديد أنّه يجب عرض مسار ترجمة وشرح بتنسيق معيّن، اضبط قيمة المَعلمة tfmt لتحديد التنسيق المطلوب. يسرد تعريف المَعلمة القيم المتوافقة.

  • لاسترداد ترجمة لمسار ترجمة، اضبط قيمة المَعلمة tlang على رمز لغة مكوّن من حرفَين وفقًا لمعيار ISO 639-1 يحدّد لغة الترجمة المطلوبة. يتم إنشاء الترجمة باستخدام الترجمة الآلية، مثل "ترجمة Google".

اطّلِع على مستندات طريقة captions.download للحصول على عيّنات الرموز البرمجية.

تعديل مسار ترجمة وشرح

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

يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" لاختبار إمكانية تغيير حالة مسودة أغنية. ومع ذلك، لا يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" لتعديل مسار الترجمة والشرح الفعلي لأنّ الأداة لا تتيح إمكانية تحميل الملفات.

يسترجع الطلب أدناه قائمة بالمقاطع الصوتية لفيديو على قناة Google Stories على YouTube:

يعدّل الطلب حالة مسودة مسار الترجمة إلى true، ما يعني أنّ المسار لن يكون مرئيًا للجميع. لإكمال الطلب في "مستكشف واجهات برمجة التطبيقات"، عليك ضبط قيمة السمة id لتحديد مسار ترجمة وشرح.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.update?
part=snippet

اطّلِع على مستندات طريقة captions.update للحصول على عيّنات الرموز البرمجية.

حذف مسار ترجمة وشرح

يوضّح هذا المثال كيفية حذف مسار ترجمة. يتضمّن المثال الخطوات التالية:

  • الخطوة 1: استرداد رقم تعريف مسار الترجمة والشرح

    اتّبِع الخطوات أعلاه لاسترداد قائمة بمقاطع الترجمة والشرح لفيديو معيّن. يمكن استخدام القائمة لعرض قائمة بمقاطع الترجمة والشرح، باستخدام معرّف كل مقطع كمفتاح.

  • الخطوة 2: حذف المقطع الصوتي

    استخدِم الطريقة captions.delete لحذف فيديو معيّن. في الطلب، تحدِّد المَعلمة id رقم تعريف مسار الترجمة والشرح للمقطع الصوتي الذي تحذفه. يجب تفويض الطلب باستخدام OAuth 2.0. إذا كنت تختبر طلب البحث هذا في "مستكشف واجهات برمجة التطبيقات"، عليك استبدال قيمة المَعلمة id بمعرّف مقطع صوتي صالح للترجمة والشرح.

    https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.captions.delete?
id=CAPTION_TRACK_ID