videos.insert
في مشاريع واجهة برمجة التطبيقات التي لم يتم التحقق منها والتي تم إنشاؤها بعد 28 يوليو 2020، على وضع العرض الخاص. لإزالة هذا القيد، يجب أن يخضع كل مشروع لواجهة برمجة تطبيقات لعملية تدقيق للتحقّق من الامتثال لبنود الخدمة. يُرجى الاطّلاع على سجلّ مراجعات واجهة برمجة التطبيقات لمزيد من التفاصيل.
يمثّل المورد video فيديو على YouTube.
الطُرق
تتيح واجهة برمجة التطبيقات الطرق التالية لموارد videos:
- getRating
- يسترد هذا الطلب التقييمات التي قدّمها المستخدم المعتمَد لقائمة من الفيديوهات المحدّدة. التجربة الآن
- list
- تعرض هذه الطريقة قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- batchGetStats
- تعرض هذه الطريقة قائمة بإحصاءات الفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- إدراج
- تحميل فيديو إلى YouTube وتحديد البيانات الوصفية للفيديو بشكل اختياري
- تعديل
- تعدّل هذه الطريقة البيانات الوصفية لفيديو. التجربة الآن
- حذف
- لحذف فيديو على YouTube التجربة الآن
- rate
- إضافة تقييم إعجاب أو عدم إعجاب إلى فيديو أو إزالة تقييم من فيديو التجربة الآن
- 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تحدّد هذه السمة ما إذا كان الفيديو عبارة عن بث مباشر قادم أو نشط. تكون القيمة القيم الصالحة لهذه السمة هي:
|
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تمثّل هذه السمة تقييم الفيديو من "هيئة ضمانات الاتصالات" (AGCOM) في إيطاليا. تشمل القيم الصالحة لهذه السمة ما يلي:
|
contentDetails.contentRating.anatelRating |
stringتمثّل هذه السمة تقييم Anatel (الرابطة الوطنية للتلفزيون) للبرامج التلفزيونية في تشيلي. القيم الصالحة لهذه السمة هي:
|
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) و"الألقاب" (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 (映倫) الياباني. القيم الصالحة لهذه السمة هي:
|
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أسباب توضّح سبب حصول الفيديو على تقييم مجلس الأفلام والفيديوهات (جنوب أفريقيا). |
contentDetails.contentRating.fskRating |
stringتمثّل هذه السمة تقييم الفيديو وفقًا لهيئة Freiwillige Selbstkontrolle der Filmwirtschaft (FSK) في ألمانيا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.grfilmRating |
stringتمثّل هذه السمة تقييم الفيديو في اليونان. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.icaaRating |
stringتمثّل هذه السمة تقييم الفيديو وفقًا لمعهد السينما والفنون السمعية البصرية (ICAA) في إسبانيا. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.ifcoRating |
stringتمثّل هذه السمة تقييم الفيديو وفقًا لمكتب تصنيف الأفلام الأيرلندية (IFCO - Ireland). يمكنك الاطّلاع على مزيد من المعلومات على الموقع الإلكتروني IFCO. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.ilfilmRating |
stringتمثّل هذه السمة تقييم الفيديو في إسرائيل. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.incaaRating |
stringتمثّل هذه السمة تقييم INCAA (المعهد الوطني للسينما والفنون السمعية البصرية في الأرجنتين) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kfcbRating |
stringتمثّل هذه السمة تقييم الفيديو من "مجلس تصنيف الأفلام في كينيا". القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kijkwijzerRating |
stringvoor de Classificatie van Audiovisuele Media (هولندا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kmrbRating |
stringتمثّل هذه السمة تقييم مجلس تصنيف الوسائط في كوريا (영상물등급위원회) للفيديو. يقيّم هذا المجلس الفيديوهات في كوريا الجنوبية. تشمل القيم الصالحة لهذه السمة ما يلي:
|
contentDetails.contentRating.lsfRating |
stringتمثّل هذه السمة تقييم الفيديو من "هيئة الرقابة على الأفلام" في إندونيسيا. القيم الصالحة لهذه السمة هي:
|
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تمثّل هذه السمة تقييم الفيديو من وزارة التراث والأنشطة الثقافية والسياحة (إيطاليا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mocRating |
stringتمثّل هذه السمة تقييم وزارة الثقافة (كولومبيا) للفيديو. في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.moctwRating |
stringتمثّل هذه السمة تقييم الفيديو من وزارة الثقافة في تايوان (文化部). في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.mpaaRating |
stringتمثّل هذه السمة تقييم Motion Picture Association of America (MPAA) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mpaatRating |
stringتمثّل هذه السمة تصنيف جمعية الفيلم الأمريكية للمقاطع الدعائية للأفلام ومعاينتها. القيم الصالحة لهذه السمة هي:
|
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،
تتيح هذه السمة لمالك القناة الإفصاح عن أنّ الفيديو يتضمّن محتوًى واقعيًا معدَّلاً أو اصطناعيًا (م/أ). مزيد من المعلومات حول سياسات YouTube المتعلقة بالمحتوى المخصّص للبالغين أو المحتوى الحساستشمل الأمثلة على محتوى الاعتداء الجنسي والاستغلال الجنسي الفيديوهات التي:
|
statistics |
objectيحتوي العنصر statistics على إحصاءات حول الفيديو. |
statistics.viewCount |
unsigned longتمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو. اعتبارًا من 31 مارس 2025، سيتم احتساب عدد مرّات بدء تشغيل فيديوهات Shorts أو إعادة تشغيلها ضمن viewCount بدون اشتراط حد أدنى لوقت المشاهدة. |
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تمثّل هذه السمة وصف الفيديو المترجَم. |