ملاحظة: في 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 علامة هذا المرجع. |
id |
string هو المعرّف الذي تستخدمه منصة YouTube لتحديد مسار الترجمة بشكل فريد. |
snippet |
object يحتوي الكائن snippet على تفاصيل أساسية حول الشرح. |
snippet.videoId |
string تشير هذه السمة إلى المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو المرتبط بمسار الترجمة والشرح بشكل فريد. |
snippet.lastUpdated |
datetime تشير هذه السمة إلى تاريخ ووقت آخر تعديل لمسار الترجمة والشرح. ويتم تحديد القيمة بتنسيق ISO 8601. |
snippet.trackKind |
string نوع مسار الترجمة والشرح. القيم الصالحة لهذه السمة هي:
|
snippet.language |
string لغة مسار الترجمة والشرح وتكون قيمة السمة علامة اللغة BCP-47. |
snippet.name |
string اسم مسار الترجمة والشرح ويجب أن يكون الاسم مرئيًا للمستخدم كخيار أثناء التشغيل. يبلغ الحدّ الأقصى لطول الاسم المسموح به 150 حرفًا. |
snippet.audioTrackType |
string يكون نوع المقطع الصوتي المرتبط بمسار الترجمة والشرح. القيم الصالحة لهذه السمة هي:
|
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 حالة مسار الترجمة والشرح. القيم الصالحة لهذه السمة هي:
|
snippet.failureReason |
string سبب عدم معالجة YouTube لمسار الترجمة لا تتوفّر هذه السمة إلا إذا كانت قيمة السمة state هي failed .القيم الصالحة لهذه السمة هي:
|