إنّ جميع الفيديوهات التي يتم تحميلها عبر نقطة نهاية
videos.insert
من مشاريع واجهات برمجة تطبيقات لم يتم إثبات ملكيتها والتي تم إنشاؤها بعد 28 تموز (يوليو) 2020 ستقتصر على وضع العرض
الخاص. لإزالة هذه القيود، يجب أن يخضع كل مشروع لواجهة برمجة التطبيقات لعملية تدقيق للتحقّق من امتثاله لبنود الخدمة. يُرجى الاطّلاع على سجلّ مراجعات واجهة برمجة التطبيقات لمزيد من التفاصيل.
يمثّل المورد video
فيديو على YouTube.
الطُرق
تتيح واجهة برمجة التطبيقات استخدام الطرق التالية لموارد videos
:
- getRating
- استرداد التقييمات التي منحها المستخدم المفوَّض لقائمة فيديوهات محدّدة التجربة الآن
- list
- عرض قائمة بالفيديوهات التي تطابق مَعلمات طلب واجهة برمجة التطبيقات. التجربة الآن
- إدراج
- تحميل فيديو إلى YouTube وضبط البيانات الوصفية للفيديو اختياريًا
- تعديل
- تعديل البيانات الوصفية للفيديو التجربة الآن
- حذف
- حذف فيديو على YouTube التجربة الآن
- السعر
- يمكنك إضافة تقييم إبداء الإعجاب أو عدم الإعجاب بفيديو أو إزالة تقييم من فيديو. التجربة الآن
- الإبلاغ عن إساءة الاستخدام
- الإبلاغ عن فيديو يشتمل على محتوى مسيء. التجربة الآن
تمثيل الموارد
تعرض بنية 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 }, "statistics": { "viewCount": string, "likeCount": string, "dislikeCount": string, "favoriteCount": string, "commentCount": string }, "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 تمثّل هذه السمة وصف الفيديو. يبلغ الحد الأقصى لطول قيمة السمة 5000 بايت، وقد تحتوي على جميع أحرف 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 تقييم الفيديو الصادر عن Autorità في إيطاليا لكل 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 Unter Richt, Kunst und Kultur). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.catvRating |
string نظام تقييم للتلفزيون الكندي - نظام تصنيف البرامج التلفزيونية الكندي لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي. القيم الصالحة لهذا الموقع هي:
|
contentDetails.contentRating.catvfrRating |
string تمثّل هذه السمة تقييم الفيديو من "هيئة التلفزيون الإذاعية والاتصالات الكندية" (CRTC) بالنسبة إلى أحداث البث المباشر باللغة الفرنسية الكندية. لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي. القيم الصالحة لهذا الموقع هي:
|
contentDetails.contentRating.cbfcRating |
string تقييم الفيديو من المجلس المركزي لاعتماد الأفلام (CBFC - الهند). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cccRating |
string تقييم الفيديو بعنوان Consejo de Calificación Sentográ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 نظام التقييم في فرنسا - لجنة التصنيف السينمائي القيم الصالحة لهذه السمة هي:
|
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 بدلاً من ذلك.التقييم الوطني للفيديو هو Centre National du cinéma et de l'image animé (وزارة الثقافة الفرنسية) (وزارة الثقافة الفرنسية). القيم الصالحة لهذه السمة هي:
|
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 - Argentina) للفيديو في ما يلي القيم الصالحة لهذه السمة:
|
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) Media for Young People. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mcstRating |
string نظام تقييم الفيديو في فيتنام - MCST القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mdaRating |
string تقييم الفيديو من "هيئة تطوير الوسائط" (MDA) في سنغافورة، وعلى وجه التحديد، "مجلس مراقبة الأفلام" (BFC). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.medietilsynetRating |
string تقييم الفيديو من Medietilsynet، هيئة الإعلام النرويجية. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mekuRating |
string تقييم الفيديو من معهد Kansallinen Audiovisuaalinen (المعهد الوطني للصوت المرئي) في فنلندا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mibacRating |
string تقييم الفيديو الصادر عن Ministero dei Beni e delle Attività Culturei e del Turismo (إيطاليا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mocRating |
string تقييم Ministerio de Cultura (كولومبيا) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.moctwRating |
string تقييم الفيديو من وزارة الثقافة في تايوان (sitemap化部). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mpaaRating |
string تقييم رابطة Motion Tech Association of America (MPAA) للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.mpaatRating |
string تقييم Motion Tech Association of America للمقاطع الدعائية للأفلام ومعاينة الأفلام. القيم الصالحة لهذه السمة هي:
|
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 ، لا يتم عرض قيمة السمة إلا إذا سمح مالك القناة بطلب البيانات من واجهة برمجة التطبيقات. |
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 تشير هذه السمة إلى عدد التعليقات على الفيديو. |
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 رقم تعريف المحادثة المباشرة النشطة حاليًا والمرفق بهذا الفيديو يتم ملء هذا الحقل فقط إذا كان الفيديو عبارة عن بث مباشر يتضمّن محادثة مباشرة في الوقت الحالي. بعد انتقال البث لإكمال هذا الحقل، ستتم إزالة البث وإيقاف المحادثة المباشرة. بالنسبة إلى عمليات البث المستمرة، لن يكون معرّف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل سيتم ربطه بالفيديو الجديد الذي يتم عرضه في الصفحة الدائمة. |
localizations |
object يحتوي الكائن localizations على ترجمات للبيانات الوصفية للفيديو. |
localizations.(key) |
object لغة النص المترجَم المرتبط بالقيمة الرئيسية القيمة هي سلسلة تحتوي على رمز اللغة BCP-47. |
localizations.(key).title |
string عنوان الفيديو المترجَم |
localizations.(key).description |
string وصف الفيديو المترجَم |