يمثّل مورد video فيديو على YouTube.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد videos:
- getRating
- تستردّ هذه الطريقة التقييمات التي منحها المستخدم المصرَّح له لقائمة من الفيديوهات المحدّدة. التجربة الآن
- list
- تعرض هذه الطريقة قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- batchGetStats
- تسترد هذه الطريقة قائمة بإحصاءات الفيديوهات التي تتطابق مع معلَمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
- insert
- تحميل فيديو إلى 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
},
"brandPartner": {
"channelId": string,
"channelHandle": 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 الصالحة باستثناء < و>. يمكنك إنشاء فصول الفيديو من خلال تضمين طوابع زمنية منسَّقة (مثلاً، 00:00) في نص الوصف. |
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تقييم الفيديو من هيئة 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تقييم الفيديو من Commission de Contrôle des Films (بلجيكا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cnaRating |
stringتقييم الفيديو من المجلس الوطني السمعي البصري (CNA) في رومانيا القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cncRating |
stringنظام التقييم في فرنسا - Commission de classification cinematographique القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.csaRating |
stringتقييم الفيديو من المجلس الأعلى للسمعيات والبصريات في فرنسا (Conseil supérieur de l'audiovisuel) الذي يقيّم المحتوى الذي يتم بثه القيم الصالحة لهذه السمة هي:
|
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) في الأرجنتين. القيم الصالحة لهذه السمة هي:
|
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تقييم الفيديو من وزارة التراث الثقافي والأنشطة والسياحة (إيطاليا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mocRating |
stringتقييم الفيديو وفقًا لوزارة الثقافة في كولومبيا (Ministerio de Cultura). في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.moctwRating |
stringتقييم الفيديو من وزارة الثقافة في تايوان (文化部). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mpaaRating |
stringتقييم الفيديو وفقًا لجمعية الفيلم الأمريكي (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حالة خصوصية الفيديو في طلب videos.insert، إذا لم تحدّد قيمة لهذه السمة، يتم ضبط حالة خصوصية الفيديو الذي تم تحميله تلقائيًا على public. قد يتم ضبط بعض عمليات التحميل تلقائيًا على private استنادًا إلى إعدادات حساب صانع المحتوى، كما هو موضّح في مركز مساعدة YouTube. لا تقتصر الفيديوهات التي يتم تحميلها من مشاريع واجهة برمجة تطبيقات لم يتم التحقق منها على وضع العرض الخاص.القيم الصالحة لهذه السمة هي:
|
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 المتعلقة بالمحتوى المخصّص للبالغينتشمل الأمثلة على محتوى ASMR الفيديوهات التي:
|
statistics |
objectيحتوي العنصر statistics على إحصاءات حول الفيديو. |
statistics.viewCount |
unsigned longتمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو. بالنسبة إلى جميع تنسيقات الفيديوهات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts)، يحتسب بالنسبة إلى جميع تنسيقات الفيديوهات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات 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 على Wikipedia تقدّم وصفًا عامًا لمحتوى الفيديو. |
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معرّف المحادثة المباشرة النشطة حاليًا والمرتبطة بهذا الفيديو. يتم ملء هذا الحقل فقط إذا كان الفيديو عبارة عن بث مباشر يتضمّن محادثة مباشرة. بعد اكتمال البث، ستتم إزالة هذا الحقل وإغلاق المحادثة المباشرة. بالنسبة إلى أحداث البث المستمرة، لن يعود معرّف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل بالفيديو الجديد الذي يتم عرضه على الصفحة المستمرة. |
brandPartner |
objectيحتوي العنصر brandPartner على تفاصيل حول العلامة التجارية الشريكة المرتبطة بالفيديو من أجل منحها إذن الوصول إلى الفيديو بمبادرة من صانع المحتوى (CI BPA). |
brandPartner.channelId |
stringمعرّف القناة الخارجي للعلامة التجارية الشريكة يجب أن يبدأ هذا الحقل بـ "UC". يجب ضبط السمة channelId أو channelHandle عند إنشاء إذن الوصول، ولكن يتم عرض السمة channelId فقط في الردّ. |
brandPartner.channelHandle |
stringالاسم المعرِّف لقناة العلامة التجارية الشريكة يجب أن يبدأ هذا الحقل بـ "@". يجب ضبط channelId أو channelHandle عند إنشاء إذن الوصول، ولكن يتم عرض channelId فقط في الردّ. |
localizations |
objectيحتوي العنصر localizations على ترجمات للبيانات الوصفية للفيديو. |
localizations.(key) |
objectلغة النص المترجَم المرتبط بقيمة المفتاح. القيمة هي سلسلة تحتوي على رمز لغة BCP-47. |
localizations.(key).title |
stringعنوان الفيديو المترجَم |
localizations.(key).description |
stringوصف الفيديو المترجَم |