سيتم حظر إمكانية مشاهدة جميع الفيديوهات التي تم تحميلها من خلال نقطة نهاية
videos.insert
من مشاريع واجهة برمجة التطبيقات التي لم يتم التحقّق منها والتي تم إنشاؤها بعد 28 تموز (يوليو) 2
2020، إلا في وضع المشاهدة الخاصة. لإزالة هذا القيد، يجب أن يخضع كل مشروع لواجهة برمجة التطبيقات
لمراجعة للتحقّق
من الامتثال لبنود
الخدمة. يُرجى الاطّلاع على سجلّ النُسخ السابقة لواجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.
يمثّل المورد video فيديو على YouTube.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد videos:
- getRating
- استرداد التقييمات التي قدّمها المستخدم المفوَّض لقائمة فيديوهات محدّدة التجربة الآن
- list
- يعرض قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- إدراج
- تحميل فيديو إلى YouTube وضبط بياناته الوصفية اختياريًا
- تعديل
- تعديل البيانات الوصفية للفيديو التجربة الآن
- حذف
- حذف فيديو على YouTube التجربة الآن
- السعر
- إضافة تقييم "أعجبني" أو "لم يعجبني" إلى فيديو أو إزالة تقييم من فيديو التجربة الآن
- reportAbuse
- الإبلاغ عن فيديو يتضمّن محتوًى مسيئًا التجربة الآن
تمثيل الموارد
تعرض بنية JSON التالية تنسيق مورد videos:
{
"kind": "youtube#video",
"etag": etag,
"id": string,
"snippet": {
"publishedAt": datetime,
"channelId": string,
"title": string,
"description": string,
"thumbnails": {
(key): {
"url": string,
"width": unsigned integer,
"height": unsigned integer
}
},
"channelTitle": string,
"tags": [
string
],
"categoryId": string,
"liveBroadcastContent": string,
"defaultLanguage": string,
"localized": {
"title": string,
"description": string
},
"defaultAudioLanguage": string
},
"contentDetails": {
"duration": string,
"dimension": string,
"definition": string,
"caption": string,
"licensedContent": boolean,
"regionRestriction": {
"allowed": [
string
],
"blocked": [
string
]
},
"contentRating": {
"acbRating": string,
"agcomRating": string,
"anatelRating": string,
"bbfcRating": string,
"bfvcRating": string,
"bmukkRating": string,
"catvRating": string,
"catvfrRating": string,
"cbfcRating": string,
"cccRating": string,
"cceRating": string,
"chfilmRating": string,
"chvrsRating": string,
"cicfRating": string,
"cnaRating": string,
"cncRating": string,
"csaRating": string,
"cscfRating": string,
"czfilmRating": string,
"djctqRating": string,
"djctqRatingReasons": [,
string
],
"ecbmctRating": string,
"eefilmRating": string,
"egfilmRating": string,
"eirinRating": string,
"fcbmRating": string,
"fcoRating": string,
"fmocRating": string,
"fpbRating": string,
"fpbRatingReasons": [,
string
],
"fskRating": string,
"grfilmRating": string,
"icaaRating": string,
"ifcoRating": string,
"ilfilmRating": string,
"incaaRating": string,
"kfcbRating": string,
"kijkwijzerRating": string,
"kmrbRating": string,
"lsfRating": string,
"mccaaRating": string,
"mccypRating": string,
"mcstRating": string,
"mdaRating": string,
"medietilsynetRating": string,
"mekuRating": string,
"mibacRating": string,
"mocRating": string,
"moctwRating": string,
"mpaaRating": string,
"mpaatRating": string,
"mtrcbRating": string,
"nbcRating": string,
"nbcplRating": string,
"nfrcRating": string,
"nfvcbRating": string,
"nkclvRating": string,
"oflcRating": string,
"pefilmRating": string,
"rcnofRating": string,
"resorteviolenciaRating": string,
"rtcRating": string,
"rteRating": string,
"russiaRating": string,
"skfilmRating": string,
"smaisRating": string,
"smsaRating": string,
"tvpgRating": string,
"ytRating": string
},
"projection": string,
"hasCustomThumbnail": boolean
},
"status": {
"uploadStatus": string,
"failureReason": string,
"rejectionReason": string,
"privacyStatus": string,
"publishAt": datetime,
"license": string,
"embeddable": boolean,
"publicStatsViewable": boolean,
"madeForKids": boolean,
"selfDeclaredMadeForKids": boolean,
"containsSyntheticMedia": boolean
},
"statistics": {
"viewCount": string,
"likeCount": string,
"dislikeCount": string,
"favoriteCount": string,
"commentCount": string
},
"paidProductPlacementDetails": {
"hasPaidProductPlacement": boolean
},
"player": {
"embedHtml": string,
"embedHeight": long,
"embedWidth": long
},
"topicDetails": {
"topicIds": [
string
],
"relevantTopicIds": [
string
],
"topicCategories": [
string
]
},
"recordingDetails": {
"recordingDate": datetime
},
"fileDetails": {
"fileName": string,
"fileSize": unsigned long,
"fileType": string,
"container": string,
"videoStreams": [
{
"widthPixels": unsigned integer,
"heightPixels": unsigned integer,
"frameRateFps": double,
"aspectRatio": double,
"codec": string,
"bitrateBps": unsigned long,
"rotation": string,
"vendor": string
}
],
"audioStreams": [
{
"channelCount": unsigned integer,
"codec": string,
"bitrateBps": unsigned long,
"vendor": string
}
],
"durationMs": unsigned long,
"bitrateBps": unsigned long,
"creationTime": string
},
"processingDetails": {
"processingStatus": string,
"processingProgress": {
"partsTotal": unsigned long,
"partsProcessed": unsigned long,
"timeLeftMs": unsigned long
},
"processingFailureReason": string,
"fileDetailsAvailability": string,
"processingIssuesAvailability": string,
"tagSuggestionsAvailability": string,
"editorSuggestionsAvailability": string,
"thumbnailsAvailability": string
},
"suggestions": {
"processingErrors": [
string
],
"processingWarnings": [
string
],
"processingHints": [
string
],
"tagSuggestions": [
{
"tag": string,
"categoryRestricts": [
string
]
}
],
"editorSuggestions": [
string
]
},
"liveStreamingDetails": {
"actualStartTime": datetime,
"actualEndTime": datetime,
"scheduledStartTime": datetime,
"scheduledEndTime": datetime,
"concurrentViewers": unsigned long,
"activeLiveChatId": string
},
"localizations": {
(key): {
"title": string,
"description": string
}
}
}الخصائص
يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:
| الخصائص | |
|---|---|
kind |
stringتُحدِّد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#video. |
etag |
etagرقم تعريف Etag لهذا المرجع. |
id |
stringالمعرّف الذي تستخدمه YouTube لتحديد الفيديو بشكلٍ فريد |
snippet |
objectيحتوي العنصر snippet على تفاصيل أساسية عن الفيديو، مثل عنوانه ووصفه وفئتَه. |
snippet.publishedAt |
datetimeتاريخ نشر الفيديو ووقته يُرجى العِلم أنّ هذه الفترة قد تختلف عن وقت تحميل الفيديو. على سبيل المثال، إذا تم تحميل فيديو كفيديو خاص ثم تم نشره علنًا في وقت لاحق، سيحدّد هذا السمة وقت نشر الفيديو علنًا. هناك حالتان خاصتان:
|
snippet.channelId |
stringالمعرّف الذي يستخدمه YouTube لتحديد القناة التي تم تحميل الفيديو إليها بشكل فريد |
snippet.title |
stringعنوان الفيديو. الحد الأقصى لطول قيمة السمة هو 100 حرف، ويمكن أن تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و>. يجب ضبط قيمة لهذه السمة في حال استدعاء طريقة videos.update وتعديل الجزء snippet من مورد video. |
snippet.description |
stringوصف الفيديو الحد الأقصى لطول قيمة السمة هو 5,000 بايت، ويمكن أن تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و>. |
snippet.thumbnails |
objectخريطة تعرض الصور المصغّرة المرتبطة بالفيديو بالنسبة إلى كل عنصر في الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى عن الصورة المصغّرة. |
snippet.thumbnails.(key) |
objectفي ما يلي القيم الصالحة للمفتاح:
|
snippet.thumbnails.(key).url |
stringعنوان URL للصورة. |
snippet.thumbnails.(key).width |
unsigned integerعرض الصورة. |
snippet.thumbnails.(key).height |
unsigned integerارتفاع الصورة. |
snippet.channelTitle |
stringعنوان القناة التي ينتمي إليها الفيديو |
snippet.tags[] |
listقائمة بعلامات الكلمات الرئيسية المرتبطة بالفيديو يمكن أن تحتوي العلامات على مسافات. يبلغ الحد الأقصى لعدد الأحرف في قيمة السمة 500 حرف. يُرجى مراعاة القواعد التالية المتعلّقة بطريقة احتساب عدد الأحرف المسموح به:
|
snippet.categoryId |
stringفئة الفيديو على YouTube المرتبطة بالفيديو يجب ضبط قيمة لهذه السمة في حال استدعاء طريقة videos.update وتعديل الجزء snippet من مورد video. |
snippet.liveBroadcastContent |
stringتشير هذه السمة إلى ما إذا كان الفيديو بثًا مباشرًا نشطًا أو قادمًا. أو تكون القيمة "none" إذا لم يكن الفيديو بثًا مباشرًا قادمًا أو نشطًا. في ما يلي القيم الصالحة لهذه السمة:
|
snippet.defaultLanguage |
stringلغة النص في السمتَين snippet.title وsnippet.description لمصدر video |
snippet.localized |
objectيحتوي العنصر snippet.localized على عنوان ووصف مترجَمَين للفيديو أو العنوان باللغة التلقائية للبيانات الوصفية للفيديو.
localizations لإضافة عناوين مترجَمة أو تعديلها أو حذفها. |
snippet.localized.title |
stringعنوان الفيديو المترجَم |
snippet.localized.description |
stringوصف الفيديو المترجَم |
snippet.defaultAudioLanguage |
stringتحدد السمة default_audio_language اللغة المحكية في المقطع الصوتي التلقائي للفيديو. |
contentDetails |
objectيحتوي العنصر contentDetails على معلومات حول محتوى الفيديو، بما في ذلك مدة الفيديو وما إذا كانت مقاطع الترجمة والشرح متاحة للفيديو. |
contentDetails.duration |
stringمدّة الفيديو قيمة السمة هي مدة ISO 8601. على سبيل المثال، إذا كان الفيديو مدته دقيقة واحدة على الأقل وأقل من ساعة واحدة، تكون المدة بالتنسيق PT#M#S، حيث تشير الأحرف PT إلى أنّ القيمة تحدّد فترة زمنية، وتشير الأحرف M وS إلى المدة بالدقائق والثواني على التوالي. إنّ أحرف # التي تسبق حرفَي M وS هما عددان صحيحان يحدّدان عدد دقائق (أو ثوانٍ) الفيديو. على سبيل المثال، تشير القيمة PT15M33S إلى أنّ مدة الفيديو 15 دقيقة و33 ثانية.إذا كان طول الفيديو ساعة واحدة على الأقل، يتم عرض المدة بالتنسيق PT#H#M#S، حيث يحدّد الرقم # الذي يسبق الحرف H مدة الفيديو بالساعات، وتبقى جميع التفاصيل الأخرى كما هو موضّح أعلاه. إذا كان طول الفيديو يومًا واحدًا على الأقل، يتم فصل الحرفين P وT، ويكون تنسيق القيمة P#DT#H#M#S. يُرجى الرجوع إلى مواصفات ISO 8601 للحصول على التفاصيل الكاملة. |
contentDetails.dimension |
stringتشير هذه السمة إلى ما إذا كان الفيديو متوفّرًا بتقنية ثلاثية الأبعاد أو ثنائية الأبعاد. |
contentDetails.definition |
stringتشير هذه السمة إلى ما إذا كان الفيديو متوفّرًا بدقة عالية ( HD) أو بدقة عادية فقط.في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.caption |
stringتشير هذه السمة إلى ما إذا كانت مقاطع الترجمة والشرح متاحة للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.licensedContent |
booleanيشير هذا الحقل إلى ما إذا كان الفيديو يمثّل محتوى مرخّصًا، أي أنّه تم تحميل المحتوى إلى قناة مرتبطة بشريك محتوى على YouTube ثم طالب هذا الشريك بملكية الفيديو. |
contentDetails.regionRestriction |
objectيحتوي العنصر regionRestriction على معلومات عن البلدان التي يمكن فيها مشاهدة الفيديو (أو لا يمكن فيها ذلك). سيحتوي الكائن على السمة contentDetails.regionRestriction.allowed أو السمة contentDetails.regionRestriction.blocked. |
contentDetails.regionRestriction.allowed[] |
listقائمة برموز المناطق التي تحدّد البلدان التي يمكن فيها عرض الفيديو إذا كانت هذه السمة متوفّرة ولم يتم إدراج بلد في قيمتها، يتم حظر ظهور الفيديو في ذلك البلد. إذا كانت هذه السمة متوفّرة وتتضمن قائمة فارغة، يتم حظر الفيديو في جميع البلدان. |
contentDetails.regionRestriction.blocked[] |
listقائمة برموز المناطق التي تحدّد البلدان التي تم حظر الفيديو فيها إذا كانت هذه السمة متوفّرة ولم يتم إدراج بلد في قيمتها، يعني ذلك أنّ الفيديو معروض في ذلك البلد. إذا كانت هذه السمة متوفّرة وتتضمن قائمة فارغة، يعني ذلك أنّ الفيديو معروض في جميع البلدان. |
contentDetails.contentRating |
objectتحدد التقييمات التي حصل عليها الفيديو بموجب أنظمة تقييم مختلفة. |
contentDetails.contentRating.acbRating |
stringالتقييم الذي منحه مجلس التصنيف الأسترالي (ACB) أو هيئة الاتصالات والإعلام الأسترالية (ACMA) للفيديو تُستخدَم تقييمات ACMA لتصنيف برامج الأطفال التلفزيونية. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.agcomRating |
stringالتقييم الذي منحته هيئة Autorità per le Garanzie nelle Comunicazioni (AGCOM) في إيطاليا للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.anatelRating |
stringالتقييم الذي تمنحه هيئة Anatel (Asociación Nacional de Televisión) للفيديو على التلفزيون التشيلي. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.bbfcRating |
stringيشير هذا الحقل إلى تقييم المجلس البريطاني لتصنيف الأفلام (BBFC) للفيديو. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.bfvcRating |
stringيشير هذا الحقل إلى تقييم الفيديو من مجلس رقابة الأفلام والفيديوهات في تايلاند. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.bmukkRating |
stringيشير هذا الحقل إلى تقييم الفيديو الصادر عن مجلس التصنيف الإعلامي النمساوي (Bundesministerium für Unterricht, Kunst und Kultur). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.catvRating |
stringنظام التقييم للبرامج التلفزيونية الكندية - نظام تصنيف البرامج التلفزيونية الكندية: تقييم الفيديو من هيئة الإذاعة والتلفزيون والاتصالات الكندية (CRTC) للبرامج التلفزيونية الكندية باللغة الإنجليزية لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني للمجلس الكندي لمعايير البث. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.catvfrRating |
stringتقييم الفيديو من "لجنة الإذاعة والتلفزيون والاتصالات الكندية" (CRTC) للبث باللغة الفرنسية في كندا لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني للمجلس الكندي لمعايير البث. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cbfcRating |
stringيشير هذا الحقل إلى تقييم المجلس المركزي لاعتماد الأفلام (CBFC) في الهند. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.cccRating |
stringيشير هذا الحقل إلى تقييم Consejo de Calificación Cinematográfica (تشيلي) للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.cceRating |
stringيشير هذا الحقل إلى تقييم الفيديو من "اللجنة البرتغالية لتصنيف العروض" (Comissão de Classificação de Espect´culos). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.chfilmRating |
stringيشير هذا الحقل إلى تقييم الفيديو في سويسرا. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.chvrsRating |
stringيشير هذا الحقل إلى تقييم الفيديو وفقًا لنظام تقييم الفيديوهات المنزلية في كندا (CHVRS). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.cicfRating |
stringتقييم الفيديو من "لجنة التحكّم في الأفلام" (بلجيكا) القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cnaRating |
stringالتقييم الذي منحه المجلس الوطني للوسائط السمعية المرئية (CNA) في رومانيا للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cncRating |
stringنظام التقييم في فرنسا - Commission de classification cinematographique في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.csaRating |
stringتقييم الفيديو من المجلس الأعلى للوسائط السمعية والمرئية في فرنسا الذي يقيم المحتوى المعروض. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cscfRating |
stringيشير هذا الحقل إلى تقييم الفيديو من قِبل هيئة CSCF في لوكسمبورغ. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.czfilmRating |
stringيشير هذا الحقل إلى تقييم الفيديو في التشيك. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.djctqRating |
stringيشير هذا الحقل إلى تقييم Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - البرازيل) الخاص بالفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.djctqRatingReasons[] |
listأسباب تشرح سبب حصول الفيديو على تقييم DJCQT (البرازيل) |
contentDetails.contentRating.ecbmctRating |
stringنظام التقييم في تركيا - مجلس التقييم والتصنيف التابع لوزارة الثقافة والسياحة القيم الصالحة لهذا الحقل هي:
|
contentDetails.contentRating.eefilmRating |
stringالتقييم الذي حصل عليه الفيديو في إستونيا. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.egfilmRating |
stringالتقييم الذي حصل عليه الفيديو في مصر. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.eirinRating |
stringتقييم Eirin (映倫) للفيديو Eirin هو نظام التقييم الياباني. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.fcbmRating |
stringيشير هذا الحقل إلى تقييم الفيديو من مجلس رقابة الأفلام في ماليزيا. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.fcoRating |
stringيشير هذا الحقل إلى تقييم الفيديو الصادر عن "مكتب إدارة الأفلام والصحف والمقالات" في هونغ كونغ. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.fmocRating |
stringتم إيقاف هذه السمة نهائيًا اعتبارًا من 2 تشرين الثاني (نوفمبر) 2015. استخدِم السمة contentDetails.contentRating.cncRating بدلاً من ذلك.تقييم الفيديو من قِبل المركز الوطني للسينما والصورة المتحركة (وزارة الثقافة الفرنسية). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.fpbRating |
stringالتقييم الذي منحه مجلس الأفلام والنشر في جنوب أفريقيا للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.fpbRatingReasons[] |
listالأسباب التي تفسّر سبب حصول الفيديو على تقييم FPB (جنوب أفريقيا) |
contentDetails.contentRating.fskRating |
stringالتقييم الذي تمنحه هيئة Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - ألمانيا) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.grfilmRating |
stringتقييم الفيديو في اليونان. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.icaaRating |
stringيشير هذا السمة إلى تقييم Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - أسبانيا) للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.ifcoRating |
stringيشير هذا الحقل إلى تقييم الفيديو الذي أصدره مكتب تصنيف الأفلام الأيرلندي (IFCO). يمكنك الاطّلاع على المزيد من المعلومات على الموقع الإلكتروني IFCO. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.ilfilmRating |
stringالتقييم الذي حصل عليه الفيديو في إسرائيل. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.incaaRating |
stringيشير هذا السمة إلى تقييم INCAA (Instituto Nacional de Cine y Artes Audiovisuales - الأرجنتين) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kfcbRating |
stringالتقييم الذي منحه مجلس تصنيف الأفلام في كينيا للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (هولندا). القيم الصالحة لهذا السمة هي:
|
contentDetails.contentRating.kmrbRating |
stringالتقييم الذي منحه مجلس تقييم الوسائط الكوري (영상물등급위원회) للفيديو تقيِّم KMRB الفيديوهات في كوريا الجنوبية. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.lsfRating |
stringيشير هذا السمة إلى تقييم الفيديو من Lembaga Sensor Film في إندونيسيا. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.mccaaRating |
stringيشير هذا الحقل إلى تقييم الفيديو من "مجلس تصنيف الأفلام حسب الفئة العمرية" في مالطا. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.mccypRating |
stringيشير هذا الحقل إلى تقييم الفيديو من مجلس الوسائط للأطفال والشباب التابع لمعهد الأفلام الدانمركي (Det Danske Filminstitut). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.mcstRating |
stringنظام تقييم الفيديو في فيتنام: MCST في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.mdaRating |
stringيشير هذا الحقل إلى تقييم الفيديو من هيئة تطوير الوسائط (MDA) في سنغافورة، وتحديدًا من مجلس فحص الأفلام (BFC). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.medietilsynetRating |
stringالتقييم الذي حصل عليه الفيديو من Medietilsynet، وهي هيئة الإعلام النرويجية. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mekuRating |
stringتقييم الفيديو من قِبل "المعهد الوطني للوسائط السمعية والمرئية" (Kansallinen Audiovisuaalinen Instituutti) في فنلندا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mibacRating |
stringتقييم الفيديو من وزارة Beni e delle Attività Culturali e del Turismo (إيطاليا). القيم الصالحة لهذا السمة هي:
|
contentDetails.contentRating.mocRating |
stringيشير هذا الحقل إلى تقييم Ministerio de Cultura (وزارة الثقافة في كولومبيا) للفيديو. في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.moctwRating |
stringتقييم الفيديو من وزارة الثقافة التايوانية (文化部). في ما يلي القيم الصالحة لهذا السمة:
|
contentDetails.contentRating.mpaaRating |
stringالتقييم الذي منحته Motion Picture Association of America (MPAA) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mpaatRating |
stringالتقييم الذي تمنحه جمعية الفيلم الأمريكي (MPAA) للمقاطع الدعائية للأفلام ومعاينات الأفلام. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mtrcbRating |
stringالتقييم الذي منحه مجلس مراجعة وتقييم الأفلام والبرامج التلفزيونية (الفلبين) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.nbcRating |
stringالتقييم الذي منحه "المكتب الوطني للتصنيف" في جزر المالديف للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.nfrcRating |
stringالتقييم الذي منحه مركز الأفلام الوطني البلغاري للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.nfvcbRating |
stringالتقييم الذي منحه مجلس الرقابة الوطني للأفلام والفيديوهات في نيجيريا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.nkclvRating |
stringيشير هذا الحقل إلى تقييم الفيديو من Nacionãlais Kino centrs (مركز الأفلام الوطني في لاتفيا). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.oflcRating |
stringالتقييم الذي منحه مكتب تصنيف الأفلام والأدب (OFLC) في نيوزيلندا للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.pefilmRating |
stringتقييم الفيديو في بيرو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.resorteviolenciaRating |
stringتقييم الفيديو في فنزويلا. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.rtcRating |
stringالتقييم الذي تمنحه "المديرية العامة للإذاعة والتلفزيون والسينما" (المكسيك) للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.rteRating |
stringالتقييم الذي حصل عليه الفيديو من Raidió Teilifís Éireann في أيرلندا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.russiaRating |
stringالتقييم الذي حصل عليه الفيديو من "السجلّ الوطني للأفلام في الاتحاد الروسي" (MKRF - روسيا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.skfilmRating |
stringتقييم الفيديو في سلوفاكيا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.smaisRating |
stringيشير ذلك إلى تقييم الفيديو في آيسلندا. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.smsaRating |
stringتقييم الفيديو من "مجلس الوسائط الوطني" (Statens medieråd) في السويد. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.tvpgRating |
stringيشير هذا الحقل إلى تقييم الفيديو وفقًا لإرشادات المراقبة الأبوية على المحتوى التلفزيوني (TVPG). في ما يلي القيم الصالحة لهذا الحقل:
|
contentDetails.contentRating.ytRating |
stringالتقييم الذي تستخدمه YouTube لتحديد المحتوى المحظور على فئات عمرية معيّنة. القيم الصالحة لهذه السمة هي:
|
contentDetails.projection |
stringتُحدِّد تنسيق عرض الفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.hasCustomThumbnail |
booleanتشير إلى ما إذا كان القائم بالتحميل قد قدّم صورة مصغّرة مخصّصة للفيديو. لا يظهر هذا الموقع إلّا للقائم بتحميل الفيديو. |
status |
objectيحتوي العنصر status على معلومات حول حالات تحميل الفيديو ومعالجته وخصوصيته. |
status.uploadStatus |
stringحالة الفيديو الذي تم تحميله. في ما يلي القيم الصالحة لهذه السمة:
|
status.failureReason |
stringتوضّح هذه القيمة سبب تعذّر تحميل الفيديو. لا تظهر هذه السمة إلا إذا كانت السمة uploadStatus تشير إلى تعذُّر التحميل.في ما يلي القيم الصالحة لهذه السمة:
|
status.rejectionReason |
stringتوضّح هذه القيمة سبب رفض YouTube لفيديو تم تحميله. لا تظهر هذه السمة إلا إذا كانت السمة uploadStatus تشير إلى رفض عملية التحميل.في ما يلي القيم الصالحة لهذه السمة:
|
status.privacyStatus |
stringحالة خصوصية الفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
status.publishAt |
datetimeالتاريخ والوقت المحدَّدان لنشر الفيديو ولا يمكن ضبطه إلا إذا كانت حالة خصوصية الفيديو "خاص". يتم تحديد القيمة بتنسيق ISO 8601. يُرجى مراعاة النقطةَين الإضافيتَين أدناه حول سلوك هذا الموقع:
|
status.license |
stringتشير هذه السمة إلى ترخيص الفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
status.embeddable |
booleanتشير هذه القيمة إلى ما إذا كان يمكن تضمين الفيديو على موقع إلكتروني آخر. |
status.publicStatsViewable |
booleanتشير هذه القيمة إلى ما إذا كانت إحصاءات الفيديو الموسّعة على صفحة مشاهدة الفيديو ظاهرة للجميع. تكون هذه الإحصاءات مرئية بشكل تلقائي، وستظل إحصاءات مثل عدد مشاهدات الفيديو وتقييماته مرئية للجميع حتى إذا تم ضبط قيمة هذه السمة على false. |
status.madeForKids |
booleanتشير هذه القيمة إلى ما إذا كان الفيديو موجّهًا إلى الأطفال، كما تحتوي على حالة الفيديو "محتوى مخصّص للأطفال" الحالية. على سبيل المثال، قد يتم تحديد الحالة استنادًا إلى قيمة السمة selfDeclaredMadeForKids. يمكنك الانتقال إلى
مركز المساعدة في YouTube للحصول على المزيد من
المعلومات حول ضبط إعدادات الجمهور لقناتك أو فيديوهاتك أو أحداث البث.
|
status.selfDeclaredMadeForKids |
booleanفي طلب videos.insert أو
videos.update، تتيح هذه السمة
لمالك القناة تصنيف الفيديو على أنّه موجّه إلى الأطفال. في طلب
videos.list، لا يتم عرض قيمة السمة
إلا إذا فوّض مالك القناة طلب واجهة برمجة التطبيقات. |
status.containsSyntheticMedia |
booleanفي طلب videos.insert أو
videos.update، تسمح هذه
السمة لصاحب القناة بالإفصاح عن أنّ الفيديو يتضمّن محتوى معدَّلاً أو
اصطناعيًا (A/S) يبدو واقعيًا. يمكنك الاطّلاع على مزيد من المعلومات حول
سياسات
YouTube المتعلّقة بالمحتوى الذي يتضمن محتوى جنسيًا أو عنيفًا.في ما يلي أمثلة على المحتوى الذي يتضمن إعلانات أثناء عرض الفيديو:
|
statistics |
objectيحتوي عنصر statistics على إحصاءات عن الفيديو. |
statistics.viewCount |
unsigned longتمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو. اعتبارًا من 31 مارس 2025، سيعرض مقياس viewCount عدد مرّات بدء تشغيل فيديو Shorts أو إعادة تشغيله، بدون فرض حدّ أدنى لوقت المشاهدة. |
statistics.likeCount |
unsigned longيشير ذلك إلى عدد المستخدمين الذين أبدوا إعجابهم بالفيديو. |
statistics.dislikeCount |
unsigned longملاحظة: تم تحديد الموقع
statistics.dislikeCount
كموقع خاص اعتبارًا من 13 كانون الأول (ديسمبر) 2021. وهذا يعني أنّه لا يتم تضمين الموقع في استجابة واجهة برمجة التطبيقات إلا إذا تم مصادقة طلب واجهة برمجة التطبيقات من قِبل مالك الفيديو. يمكنك الاطّلاع على
سجلّ النُسخ السابقة للحصول على مزيد من المعلومات.عدد المستخدمين الذين أبدوا عدم إعجابهم بالفيديو |
statistics.favoriteCount |
unsigned longملاحظة: تم إيقاف هذه السمة نهائيًا. وسيتم إيقاف هذه الميزة نهائيًا اعتبارًا من 28 آب (أغسطس) 2015. يتم الآن ضبط قيمة السمة دائمًا على 0. |
statistics.commentCount |
unsigned longعدد التعليقات على الفيديو |
paidProductPlacementDetails |
objectيحتوي العنصر paidProductPlacementDetails على معلومات عن موضع الإعلان المدفوع للمنتجات في الفيديو. |
paidProductPlacementDetails.hasPaidProductPlacement |
booleanاضبط القيمة على true إذا كان المحتوى يستخدم موضع إعلان مدفوعًا للمنتجات. الإعداد التلقائي هو false. |
player |
objectيحتوي عنصر player على معلومات يمكنك استخدامها لتشغيل الفيديو في مشغّل مضمّن. |
player.embedHtml |
stringالعلامة <iframe> التي تضمّن مشغّلًا لتشغيل الفيديو |
player.embedHeight |
longارتفاع المشغّل المضمّن الذي تم عرضه في السمة player.embedHtml. لا يتم عرض هذه السمة إلا إذا حدّد الطلب قيمة للمَعلمتَين maxHeight و/أو maxWidth وكانت نسبة عرض إلى ارتفاع الفيديو معروفة. |
player.embedWidth |
longعرض المشغّل المضمّن الذي تم عرضه في السمة player.embedHtml. لا يتم عرض هذه السمة إلا إذا حدّد الطلب قيمة للمَعلمتَين maxHeight و/أو maxWidth وكانت نسبة عرض إلى ارتفاع الفيديو معروفة. |
topicDetails |
objectيقدّم عنصر topicDetails معلومات عن المواضيع المرتبطة بالفيديو.ملاحظة مهمة: اطّلِع على تعريفات السمتَين topicDetails.relevantTopicIds[] وtopicDetails.topicIds[] بالإضافة إلى سجلّ المراجعات لمعرفة المزيد من التفاصيل عن التغييرات القادمة المرتبطة بأرقام تعريف المواضيع. |
topicDetails.topicIds[] |
listملاحظة مهمة: تم إيقاف هذا الحقل نهائيًا اعتبارًا من 10 تشرين الثاني (نوفمبر) 2016. لم تعُد واجهة برمجة التطبيقات تعرِض قيمًا لهذه السمة، ويتم الآن عرض أي مواضيع مرتبطة بالفيديو من خلال قيمة السمة topicDetails.relevantTopicIds[]. |
topicDetails.relevantTopicIds[] |
listقائمة بأرقام تعريف المواضيع ذات الصلة بالفيديو تم إيقاف هذه السمة نهائيًا اعتبارًا من 10 تشرين الثاني (نوفمبر) 2016. وسيظل متاحًا حتى 10 تشرين الثاني (نوفمبر) 2017. ملاحظة مهمة: بسبب إيقاف Freebase وFreebase API نهائيًا، بدأت أرقام تعريف المواضيع تعمل بشكل مختلف اعتبارًا من 27 شباط (فبراير) 2017. في ذلك الوقت، بدأت YouTube في عرض مجموعة صغيرة من معرّفات المواضيع المنظَّمة. |
topicDetails.topicCategories[] |
listقائمة بعناوين URL في ويكيبيديا تقدّم وصفًا عالي المستوى لمحتوى الفيديو |
recordingDetails |
objectيحتوي العنصر recordingDetails على معلومات عن الموقع الجغرافي والتاريخ والعنوان حيث تم تسجيل الفيديو. |
recordingDetails.locationDescription |
stringتم إيقاف هذه السمة نهائيًا اعتبارًا من 1 حزيران (يونيو) 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمعرفة المزيد من التفاصيل. الوصف النصي للموقع الجغرافي الذي تم تسجيل الفيديو فيه |
recordingDetails.location |
objectمعلومات الموقع الجغرافي المرتبطة بالفيديو يُرجى العِلم أنّ قيم السمات الفرعية تحدّد الموقع الجغرافي الذي يريد مالك الفيديو ربطه بالفيديو. تكون القيمة قابلة للتعديل وقابلة للبحث عنها في الفيديوهات العلنية، وقد يتم عرضها للمستخدمين في الفيديوهات العلنية. |
recordingDetails.location.latitude |
doubleتم إيقاف هذه السمة نهائيًا اعتبارًا من 1 حزيران (يونيو) 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمعرفة المزيد من التفاصيل. خط العرض بالدرجات. |
recordingDetails.location.longitude |
doubleتم إيقاف هذه السمة نهائيًا اعتبارًا من 1 حزيران (يونيو) 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمعرفة المزيد من التفاصيل. خط الطول بالدرجات |
recordingDetails.location.altitude |
doubleتم إيقاف هذه السمة نهائيًا اعتبارًا من 9 تموز (يوليو) 2018. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمعرفة المزيد من التفاصيل. الارتفاع فوق الشكل الإهليجي المرجعي، بالمتر |
recordingDetails.recordingDate |
datetimeالتاريخ والوقت اللذان تم فيهما تسجيل الفيديو يتم تحديد القيمة بتنسيق ISO 8601 ( YYYY-MM-DDThh:mm:ss.sssZ). |
fileDetails |
objectيتضمّن عنصر fileDetails معلومات عن ملف الفيديو الذي تم تحميله إلى YouTube، بما في ذلك درجة دقة الملف ومدته وبرامج ترميز الصوت والفيديو ومعدلات نقل البيانات أثناء البث وغير ذلك. ولا يمكن لأحد غير مالك الفيديو استرداد هذه البيانات.لن يتم عرض العنصر fileDetails إلا إذا كانت قيمة السمة processingDetails.fileAvailability هي available. |
fileDetails.fileName |
stringاسم الملف الذي تم تحميله. يظهر هذا الحقل سواء تم تحميل ملف فيديو أو نوع آخر من الملفات. |
fileDetails.fileSize |
unsigned longحجم الملف المحمَّل بالبايت يظهر هذا الحقل سواء تم تحميل ملف فيديو أو نوع آخر من الملفات. |
fileDetails.fileType |
stringنوع الملف الذي تم تحميله كما رصده محرّك معالجة الفيديو في YouTube لا تعالج YouTube حاليًا سوى ملفات الفيديو، ولكن يظهر هذا الحقل سواء تم تحميل ملف فيديو أو نوع آخر من الملفات. في ما يلي القيم الصالحة لهذا السمة:
|
fileDetails.container |
stringتنسيق حاوية ملف الفيديو الذي تم تحميله. |
fileDetails.videoStreams[] |
listقائمة بعمليات بث الفيديوهات المضمّنة في ملف الفيديو المحمَّل يحتوي كل عنصر في القائمة على بيانات وصفية تفصيلية حول بث فيديو. |
fileDetails.videoStreams[].widthPixels |
unsigned integerعرض محتوى الفيديو المرمّز بالبكسل يمكنك احتساب نسبة العرض إلى الارتفاع لتشفير الفيديو على النحو التالي: width_pixels / height_pixels. |
fileDetails.videoStreams[].heightPixels |
unsigned integerارتفاع محتوى الفيديو المرمّز بالبكسل |
fileDetails.videoStreams[].frameRateFps |
doubleعدد اللقطات في الثانية لبث الفيديو |
fileDetails.videoStreams[].aspectRatio |
doubleنسبة العرض إلى الارتفاع لعرض محتوى الفيديو، والتي تحدّد نسبة العرض إلى الارتفاع التي يجب عرض الفيديو بها. |
fileDetails.videoStreams[].codec |
stringبرنامج ترميز الفيديو الذي يستخدمه البث |
fileDetails.videoStreams[].bitrateBps |
unsigned longمعدّل نقل البيانات للفيديوهات المضمَّنة، بالبت في الثانية |
fileDetails.videoStreams[].rotation |
stringالدرجة التي تحتاج YouTube إلى تدوير المحتوى الأصلي المصدر بها لعرض الفيديو بشكل صحيح. القيم الصالحة لهذه السمة هي:
|
fileDetails.videoStreams[].vendor |
stringقيمة تحدّد بصفة فريدة مورّد الفيديو. وتكون القيمة عادةً رمز مورّد مكوّنًا من أربعة أحرف. |
fileDetails.audioStreams[] |
listقائمة بعمليات بث الصوت المتوفّرة في ملف الفيديو المحمَّل يحتوي كل عنصر في القائمة على بيانات وصفية تفصيلية حول بث صوتي. |
fileDetails.audioStreams[].channelCount |
unsigned integerعدد القنوات الصوتية التي يحتوي عليها البث |
fileDetails.audioStreams[].codec |
stringبرنامج ترميز الصوت الذي يستخدمه البث |
fileDetails.audioStreams[].bitrateBps |
unsigned longمعدّل نقل بيانات البث الصوتي، بالبت في الثانية |
fileDetails.audioStreams[].vendor |
stringقيمة تحدّد بصفة فريدة مورّد الفيديو. وتكون القيمة عادةً رمز مورّد مكوّنًا من أربعة أحرف. |
fileDetails.durationMs |
unsigned longتشير هذه السمة إلى مدة الفيديو الذي تم تحميله بالملي ثانية. |
fileDetails.bitrateBps |
unsigned longمعدّل نقل البيانات المجمّع (للفيديو والصوت) لملف الفيديو الذي تم تحميله بوحدة البت في الثانية |
fileDetails.creationTime |
stringتاريخ ووقت إنشاء ملف الفيديو المحمَّل. يتم تحديد القيمة بتنسيق ISO 8601. تتوفّر حاليًا تنسيقات ISO 8601 التالية:
|
processingDetails |
objectيتضمّن العنصر processingDetails معلومات حول مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله. تحدّد السمات في العنصر حالة المعالجة الحالية وتقديرًا للوقت المتبقّي إلى أن تنتهي منصة YouTube من معالجة الفيديو. يشير هذا الجزء أيضًا إلى ما إذا كانت أنواع مختلفة من البيانات أو المحتوى، مثل تفاصيل الملفات أو الصور المصغّرة، متاحة للفيديو.تم تصميم عنصر processingProgress ليتم الاستعلام عنه كي يتمكّن الفيديو المحمَّل من تتبُّع مستوى التقدّم الذي أحرزته YouTube في معالجة ملف الفيديو المحمَّل. لا يمكن لأحد غير مالك الفيديو استرداد هذه البيانات. |
processingDetails.processingStatus |
stringحالة معالجة الفيديو تشير هذه القيمة إلى ما إذا كان بإمكان YouTube معالجة الفيديو أو ما إذا كانت المعالجة لا تزال جارية. في ما يلي القيم الصالحة لهذا السمة:
|
processingDetails.processingProgress |
objectيحتوي عنصر processingProgress على معلومات حول مستوى التقدّم الذي أحرزته YouTube في معالجة الفيديو. لا تكون القيم ذات صلة إلا إذا كانت حالة معالجة الفيديو هي processing. |
processingDetails.processingProgress.partsTotal |
unsigned longتقدير للعدد الإجمالي للأجزاء التي يجب معالجتها في الفيديو وقد يتم تعديل هذا العدد باستخدام تقديرات أكثر دقة أثناء معالجة YouTube للفيديو. |
processingDetails.processingProgress.partsProcessed |
unsigned longيشير ذلك إلى عدد أجزاء الفيديو التي سبق أن عالجتها منصة YouTube. يمكنك تقدير النسبة المئوية للفيديو التي سبق أن تمت معالجتها من خلال YouTube من خلال احتساب ما يلي: 100 * parts_processed / parts_totalيُرجى العِلم أنّه بما أنّ العدد المقدَّر للأجزاء قد يزداد بدون زيادة مقابلة في عدد الأجزاء التي سبق أن تمت معالجتها، من الممكن أن ينخفض مستوى التقدّم المحسوب بشكل دوري أثناء معالجة YouTube للفيديو. |
processingDetails.processingProgress.timeLeftMs |
unsigned longيشير ذلك إلى الوقت المقدَّر الذي تحتاجه YouTube لإكمال معالجة الفيديو، وذلك بالملي ثانية. |
processingDetails.processingFailureReason |
stringسبب تعذّر معالجة الفيديو على YouTube لن تتضمّن هذه السمة قيمة إلا إذا كانت قيمة السمة processingStatus هي failed.في ما يلي القيم الصالحة لهذه السمة:
|
processingDetails.fileDetailsAvailability |
stringتشير هذه القيمة إلى ما إذا كانت تفاصيل الملف متاحة للفيديو الذي تم تحميله. يمكنك استرداد تفاصيل ملف الفيديو من خلال طلب الجزء fileDetails في طلب videos.list(). |
processingDetails.processingIssuesAvailability |
stringتشير هذه القيمة إلى ما إذا كان محرّك معالجة الفيديو قد أنشأ اقتراحات قد تحسّن قدرة YouTube على معالجة الفيديو، أو تحذيرات توضّح مشاكل معالجة الفيديو، أو أخطاء تتسبّب في مشاكل معالجة الفيديو. يمكنك استرداد هذه الاقتراحات من خلال طلب الجزء suggestions في طلب videos.list(). |
processingDetails.tagSuggestionsAvailability |
stringتشير هذه القيمة إلى ما إذا كانت اقتراحات الكلمات الرئيسية (العلامات) متاحة للفيديو. يمكن إضافة علامات إلى البيانات الوصفية للفيديو لتسهيل عثور المستخدمين الآخرين عليه. يمكنك استرداد هذه الاقتراحات من خلال طلب الجزء suggestions في طلب videos.list(). |
processingDetails.editorSuggestionsAvailability |
stringتشير هذه القيمة إلى ما إذا كانت اقتراحات تعديل الفيديوهات متاحة للفيديو، ما قد يؤدي إلى تحسين جودة الفيديو أو تجربة التشغيل. يمكنك استرداد هذه الاقتراحات من خلال طلب الجزء suggestions في طلب videos.list(). |
processingDetails.thumbnailsAvailability |
stringتشير هذه القيمة إلى ما إذا تم إنشاء صور مصغّرة للفيديو. |
suggestions |
objectيتضمّن العنصر suggestions اقتراحات تحدّد فرص تحسين جودة الفيديو أو البيانات الوصفية للفيديو الذي تم تحميله. لا يمكن لأحد غير مالك الفيديو استرداد هذه البيانات. لن يتم عرض العنصر suggestions إلا إذا كانت قيمة السمة processingDetails.tagSuggestionsAvailability أو السمة processingDetails.editorSuggestionsAvailability هي available. |
suggestions.processingErrors[] |
listقائمة بالأخطاء التي ستمنع YouTube من معالجة الفيديو المحمَّل بنجاح تشير هذه الأخطاء إلى أنّه بغض النظر عن حالة معالجة الفيديو الحالية، من المؤكد تقريبًا أن تصبح هذه الحالة failed.في ما يلي القيم الصالحة لهذه السمة:
|
suggestions.processingWarnings[] |
listقائمة بأسباب قد تؤدي إلى صعوبة تحويل ترميز الفيديو المحمَّل على YouTube أو قد تؤدي إلى تحويل ترميز خاطئ يتم إنشاء هذه التحذيرات قبل أن تعالج منصة YouTube ملف الفيديو المحمَّل. بالإضافة إلى ذلك، تحدد هذه القيم المشاكل التي لا تشير بالضرورة إلى أنّه سيتم تعذُّر معالجة الفيديو، ولكن قد تؤدي إلى حدوث مشاكل، مثل مشاكل في المزامنة أو تأثيرات غير مرغوب فيها في الفيديو أو عدم توفّر مقطع صوتي. في ما يلي القيم الصالحة لهذه السمة:
|
suggestions.processingHints[] |
listقائمة بالاقتراحات التي قد تُحسِّن قدرة YouTube على معالجة الفيديو القيم الصالحة لهذه السمة هي:
|
suggestions.tagSuggestions[] |
listقائمة بعلامات الكلمات الرئيسية التي يمكن إضافتها إلى البيانات الوصفية للفيديو لزيادة احتمالية عثور المستخدمين على الفيديو عند البحث أو التصفّح على YouTube |
suggestions.tagSuggestions[].tag |
stringالعلامة الخاصة بالكلمة الرئيسية المقترَحة للفيديو. |
suggestions.tagSuggestions[].categoryRestricts[] |
listمجموعة من فئات الفيديوهات التي تكون العلامة ذات صلة بها يمكنك استخدام هذه المعلومات لعرض اقتراحات علامات مناسبة استنادًا إلى فئة الفيديو التي يربطها القائم بالتحميل بالفيديو. تكون اقتراحات العلامات ذات صلة تلقائيًا بجميع الفئات إذا لم يتم تحديد أي قيود للكلمة الرئيسية. |
suggestions.editorSuggestions[] |
listقائمة بعمليات تعديل الفيديو التي قد تُحسِّن من جودة الفيديو أو تجربة تشغيله. القيم الصالحة لهذا السمة هي:
|
liveStreamingDetails |
objectيحتوي العنصر liveStreamingDetails على بيانات وصفية عن بث فيديو مباشر. لن يظهر العنصر في مورد video إلا إذا كان الفيديو بثًا مباشرًا قادمًا أو بثًا مباشرًا أو بثًا مباشرًا مكتملًا. |
liveStreamingDetails.actualStartTime |
datetimeالوقت الذي بدأ فيه البث فعليًا. يتم تحديد القيمة بتنسيق ISO 8601. لن تكون هذه القيمة متاحة إلا بعد بدء البث. |
liveStreamingDetails.actualEndTime |
datetimeالوقت الذي انتهى فيه البث فعليًا. يتم تحديد القيمة بتنسيق ISO 8601. لن تكون هذه القيمة متاحة إلى أن ينتهي البث. |
liveStreamingDetails.scheduledStartTime |
datetimeالوقت المُجدوَل لبدء البث. يتم تحديد القيمة بتنسيق ISO 8601. |
liveStreamingDetails.scheduledEndTime |
datetimeالوقت المُجدوَل لانتهاء البث يتم تحديد القيمة بتنسيق ISO 8601. إذا كانت القيمة فارغة أو لم تكن السمة متوفّرة، سيتم جدولة البث لمواصلته إلى أجل غير مسمى. |
liveStreamingDetails.concurrentViewers |
unsigned longعدد المشاهدين الذين يشاهدون البث حاليًا سيظهر الموقع وقيمته إذا كان البث المباشر يضمّ مشاهدين حاليين ولم يخفِ مالك البث المباشر عدد المشاهدات للفيديو. يُرجى العِلم أنّ YouTube يتوقف عن تتبُّع عدد المشاهدين المتزامنين للبث عند انتهاء البث. وبالتالي، لن يحدّد هذا السمة عدد المشاهدين الذين يشاهدون فيديو مؤرشفًا لبث مباشر انتهى. قد تختلف أعداد المشاهدين المتزامنين التي تعرِضها YouTube Data API عن أعداد المشاهدين المتزامنين التي تمت معالجتها وإزالة المحتوى غير المرغوب فيه منها والتي تتوفّر من خلال "إحصاءات YouTube". مزيد من المعلومات حول مقاييس البث المباشر في
مركز مساعدة YouTube
|
liveStreamingDetails.activeLiveChatId |
stringرقم تعريف المحادثة المباشرة النشطة حاليًا والمرفَقة بهذا الفيديو. لا يتم ملء هذا الحقل إلا إذا كان الفيديو بثًا مباشرًا حاليًا يتضمّن ميزة الدردشة المباشرة. بعد اكتمال البث، ستتم إزالة هذا الحقل وإغلاق المحادثة المباشرة. بالنسبة إلى أحداث البث المباشر الدائمة، لن يعود رقم تعريف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل سيرتبط بالفيديو الجديد الذي يتم عرضه في الصفحة الدائمة. |
localizations |
objectيحتوي العنصر localizations على ترجمات للبيانات الوصفية للفيديو. |
localizations.(key) |
objectتشير إلى لغة النص المترجَم المرتبط بقيمة المفتاح. القيمة هي سلسلة تحتوي على رمز لغة BCP-47. |
localizations.(key).title |
stringعنوان الفيديو المترجَم |
localizations.(key).description |
stringوصف الفيديو المترجَم |