Captions

ملاحظة: في 13 آذار (مارس) 2024، أعلنت YouTube عن إيقاف مَعلمة sync نهائيًا في نقطة نهاية واجهة برمجة التطبيقات captions.insert و captions.update. لا تزال ميزة "مزامنة الترجمة والشرح تلقائيًا" متاحة في "استوديو YouTube". اطّلِع على سجلّ المراجعات لواجهة برمجة التطبيقات للحصول على المزيد من التفاصيل.

يمثّل مورد caption مسار ترجمة في YouTube. يتم إقران مسار الترجمة المصاحبة بفيديو واحد على YouTube فقط.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد captions:

list
استرداد قائمة بمقاطع الترجمة المصاحبة المرتبطة بفيديوه معيّن يُرجى العِلم أنّ استجابة واجهة برمجة التطبيقات لا تحتوي على الترجمة والشرح الفعليين وأنّ الطريقة captions.download توفّر إمكانية استرداد مسار ترجمة وشرح. جرِّب ذلك الآن.
إدراج
حمِّل مسار ترجمة وشرح. التجربة الآن
تعديل
تعديل مسار ترجمة وشرح عند تعديل مسار ترجمة، يمكنك تغيير حالة المسودة الخاصة بالمسار أو تحميل ملف ترجمة جديد للمسار أو كليهما. جرِّب ذلك الآن.
تنزيل
نزِّل مسار ترجمة وشرح. يتم عرض مسار الترجمة والشرح بتنسيقه الأصلي ما لم يحدّد الطلب قيمة للمَعلمة tfmt وبلغته الأصلية ما لم يحدّد الطلب قيمة للمَعلمة tlang. جرِّب ذلك الآن.
حذف
حذف مسار ترجمة وشرح محدّد التجربة الآن

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد captions:

{
  "kind": "youtube#caption",
  "etag": etag,
  "id": string,
  "snippet": {
    "videoId": string,
    "lastUpdated": datetime,
    "trackKind": string,
    "language": string,
    "name": string,
    "audioTrackType": string,
    "isCC": boolean,
    "isLarge": boolean,
    "isEasyReader": boolean,
    "isDraft": boolean,
    "isAutoSynced": boolean,
    "status": string,
    "failureReason": string
  }
}

الخصائص

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

الخصائص
kind string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#caption.
etag etag
رقم تعريف Etag لهذا المورد.
id string
المعرّف الذي تستخدمه YouTube لتحديد المقطع الصوتي للترجمة والشرح بشكل فريد
snippet object
يحتوي عنصر snippet على تفاصيل أساسية عن الترجمة والشرح.
snippet.videoId string
المعرّف الذي تستخدمه YouTube لتحديد الفيديو المرتبط بمسار الترجمة والشرح بشكل فريد
snippet.lastUpdated datetime
يشير هذا الحقل إلى تاريخ ووقت آخر تعديل على مسار الترجمة. يتم تحديد القيمة بتنسيق ISO 8601.
snippet.trackKind string
نوع مسار الترجمة والشرح.

في ما يلي القيم الصالحة لهذه السمة:
  • ASR: مسار ترجمة تم إنشاؤه باستخدام ميزة "التعرّف التلقائي على الكلام"
  • forced: مقطع ترجمة وشرح يتم تشغيله عندما لا يتم اختيار مقطع صوتي آخر في المشغّل. على سبيل المثال، قد يتضمّن فيديو يعرض أجنبيًين يتحدثان بلغة أجنبية مسار ترجمة مُجبَرًا لعرض ترجمة للغة الأجنبية فقط.
  • ‫standard: مسار ترجمة وشرح عادي هذه هي القيمة الافتراضية.
snippet.language string
تشير هذه السمة إلى لغة مسار الترجمة والشرح. قيمة السمة هي علامة لغة BCP-47.
snippet.name string
اسم مسار الترجمة. من المفترض أن يظهر الاسم للمستخدم كخيار أثناء التشغيل. الحد الأقصى المسموح به لطول الاسم هو 150 حرفًا.
snippet.audioTrackType string
نوع المقطع الصوتي المرتبط بمسار الترجمة والشرح.

في ما يلي القيم الصالحة لهذه السمة:
  • commentary – يرتبط مقطع الترجمة والشرح بمقطع صوتي بديل يتضمّن تعليقًا، مثل تعليقات حول الدليل.
  • descriptive – يرتبط مسار الترجمة والشرح بمسار صوتي بديل يتضمّن محتوًى صوتيًا وصفيًا إضافيًا.
  • ‫primary: يتوافق مسار الترجمة والشرح مع المقطع الصوتي الأساسي للفيديو، وهو المقطع الصوتي المرتبط عادةً بالفيديو.
  • unknown: هذه هي القيمة التلقائية.
snippet.isCC boolean
تشير هذه العلامة إلى ما إذا كان المقطع الصوتي يتضمّن مقاطع ترجمة وشرح للصم وضعاف السمع. تكون القيمة التلقائية false.
snippet.isLarge boolean
يشير إلى ما إذا كان مسار الترجمة والشرح يستخدم نصًا كبيرًا لذوي البصر المحدود. تكون القيمة التلقائية false.
snippet.isEasyReader boolean
يشير إلى ما إذا كان تنسيق مسار الترجمة المصاحبة مخصّصًا "للقارئ البسيط"، أي أنّه على مستوى الصف الثالث لمتعلّمي اللغة. تكون القيمة التلقائية false.
snippet.isDraft boolean
يشير إلى ما إذا كان مسار الترجمة والشرح مسودة. إذا كانت القيمة هي true، يعني ذلك أنّ المقطع الصوتي غير مرئي للجميع. تكون القيمة التلقائية false.
snippet.isAutoSynced boolean
يشير هذا الحقل إلى ما إذا كانت منصة YouTube قد تمت مزامنتها مع المقطع الصوتي في الفيديو. ستكون القيمة true إذا تم طلب المزامنة صراحةً عند تحميل مسار الترجمة والشرح. على سبيل المثال، عند استدعاء الطريقتَين captions.insert أو captions.update، يمكنك ضبط المَعلمة sync على true لتوجيه YouTube إلى مزامنة المقطع الصوتي المحمَّل مع الفيديو. إذا كانت القيمة هي false، يستخدم YouTube رموز الوقت في مسار الترجمة المصاحبة الذي تم تحميله لتحديد وقت عرض الترجمة.
snippet.status string
حالة مسار الترجمة والشرح.

في ما يلي القيم الصالحة لهذه السمة:
  • failed
  • serving
  • syncing
snippet.failureReason string
سبب تعذّر معالجة مسار الترجمة في YouTube لا تظهر هذه السمة إلا إذا كانت قيمة السمة state هي failed.

في ما يلي القيم الصالحة لهذه السمة:
  • processingFailed - تعذّر على YouTube معالجة مسار الترجمة الذي تم تحميله.
  • unknownFormat - لم يتم التعرّف على تنسيق مسار الترجمة.
  • unsupportedFormat – تنسيق مسار الترجمة والشرح غير متوافق.