تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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` – تنسيق مسار الترجمة والشرح غير متوافق.