سيتم حظر إمكانية مشاهدة جميع الفيديوهات التي تم تحميلها من خلال نقطة نهاية
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 تقييم الفيديو من نظام CONSILIUL NATIONAL AL AUDIOVIZUALULUI (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 |
string voor 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
المتعلّقة بمحتوى A/S.في ما يلي أمثلة على المحتوى الذي يتضمن إعلانات أثناء عرض الفيديو:
|
statistics |
object يحتوي عنصر statistics على إحصاءات عن الفيديو. |
statistics.viewCount |
unsigned long تمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو. |
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 وصف الفيديو المترجَم |