إنّ جميع الفيديوهات التي تم تحميلها باستخدام نقطة النهاية
videos.insert
من مشاريع واجهة برمجة تطبيقات لم يتم التحقق منها والتي تم إنشاؤها بعد 28 تموز (يوليو) 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 }, "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 علامة هذا المرجع. |
id |
string تشير هذه السمة إلى المعرّف الذي تستخدمه منصة YouTube لتعريف الفيديو بشكل فريد. |
snippet |
object يحتوي العنصر snippet على تفاصيل أساسية حول الفيديو، مثل عنوانه ووصفه وفئته. |
snippet.publishedAt |
datetime تشير هذه السمة إلى تاريخ نشر الفيديو ووقته. يُرجى العِلم أنّ هذا الوقت قد يختلف عن وقت تحميل الفيديو. على سبيل المثال، إذا تم تحميل فيديو كفيديو خاص ثم أصبح علنيًا في وقت لاحق، ستحدِّد هذه السمة وقت تغيير إعدادات الفيديو ليصبح علنيًا. هناك حالتان خاصتان:
|
snippet.channelId |
string المعرّف الذي تستخدمه منصة YouTube لتحديد القناة التي تمّ تحميل الفيديو إليها بشكل فريد |
snippet.title |
string تمثّل هذه السمة عنوان الفيديو. يبلغ الحد الأقصى لطول قيمة السمة 100 حرف، وقد تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و>. يجب ضبط قيمة لهذه السمة إذا استدعيت طريقة videos.update وكنت تعدِّل الجزء snippet من مورد video . |
snippet.description |
string وصف الفيديو يبلغ الحد الأقصى لطول قيمة السمة 5,000 بايت، وقد تحتوي على جميع أحرف UTF-8 الصالحة باستثناء < و>. |
snippet.thumbnails |
object خريطة للصور المصغّرة المرتبطة بالفيديو. بالنسبة لكل كائن في الخريطة، يكون المفتاح هو اسم الصورة المصغرة، والقيمة هي كائن يحتوي على معلومات أخرى حول الصورة المصغرة. |
snippet.thumbnails.(key) |
object في ما يلي قيم المفاتيح الصالحة:
|
snippet.thumbnails.(key).url |
string عنوان URL للصورة: |
snippet.thumbnails.(key).width |
unsigned integer عرض الصورة. |
snippet.thumbnails.(key).height |
unsigned integer ارتفاع الصورة. |
snippet.channelTitle |
string عنوان القناة التي ينتمي إليها الفيديو |
snippet.tags[] |
list قائمة بعلامات الكلمات الرئيسية المرتبطة بالفيديو. قد تحتوي العلامات على مسافات. يمكن أن تتألف قيمة السمة من 500 حرف كحدّ أقصى. يُرجى مراعاة القواعد التالية بشأن طريقة احتساب عدد الأحرف المسموح به:
|
snippet.categoryId |
string فئة الفيديو على YouTube المرتبطة بالفيديو عليك ضبط قيمة لهذه السمة إذا استدعيت طريقة videos.update وكنت تعدِّل الجزء snippet من مورد video . |
snippet.liveBroadcastContent |
string يشير هذا العمود إلى ما إذا كان الفيديو عبارة عن بث مباشر قادم أو نشِط. أو يتم عرض القيمة "بدون" إذا لم يكن الفيديو بثًا مباشرًا قادمًا أو نشطًا. في ما يلي القيم الصالحة لهذه السمة:
|
snippet.defaultLanguage |
string لغة النص في السمتَين snippet.title وsnippet.description لمورد video . |
snippet.localized |
object يحتوي العنصر snippet.localized إما على عنوان ووصف مترجمَين للفيديو أو عنوان باللغة التلقائية للبيانات الوصفية الخاصة بالفيديو.
localizations لإضافة العناوين المترجَمة أو تعديلها أو حذفها. |
snippet.localized.title |
string تمثّل هذه السمة عنوان الفيديو المترجَم. |
snippet.localized.description |
string تمثّل هذه السمة وصف الفيديو المترجَم. |
snippet.defaultAudioLanguage |
string تحدّد السمة default_audio_language اللغة المحكية في المقطع الصوتي التلقائي للفيديو. |
contentDetails |
object يتضمّن العنصر contentDetails معلومات عن محتوى الفيديو، بما في ذلك مدة الفيديو ومؤشرًا على ما إذا كانت مقاطع الترجمة والشرح متوفّرة للفيديو. |
contentDetails.duration |
string تشير هذه العلامة إلى مدة الفيديو. وتتطلّب قيمة السمة مدة ISO 8601. على سبيل المثال، إذا كانت مدّة الفيديو دقيقة واحدة على الأقل ومدته أقلّ من ساعة واحدة، تكون المدّة بالتنسيق PT#M#S ، حيث يشير الحرفان PT إلى أنّ القيمة تحدّد فترة زمنية، ويشير الحرفان M وS إلى المدة بالدقائق والثواني على التوالي. إنّ الأحرف # التي تسبق الحرفين M وS هما عددان صحيحان يحدّدان عدد الدقائق (أو الثواني) للفيديو. على سبيل المثال، تشير القيمة PT15M33S إلى أنّ مدّة الفيديو هي 15 دقيقة و33 ثانية.إذا كانت مدّة الفيديو ساعة واحدة على الأقل، تكون المدة بالتنسيق PT#H#M#S ، حيث تحدّد # التي تسبق الحرف H مدة الفيديو بالساعات وتكون جميع التفاصيل الأخرى مطابقة لما هو موضّح أعلاه. إذا كانت مدة الفيديو يومًا واحدًا على الأقل، يتم الفصل بين الحرفين P وT ويكون تنسيق القيمة هو P#DT#H#M#S . للاطّلاع على التفاصيل الكاملة، يُرجى الرجوع إلى مواصفات ISO 8601. |
contentDetails.dimension |
string يشير إلى ما إذا كان الفيديو متاحًا بتنسيق ثلاثي الأبعاد أو ثنائي الأبعاد. |
contentDetails.definition |
string يشير إلى ما إذا كان الفيديو متاحًا بدقة عالية ( HD ) أو بدقة عادية فقط.القيم الصالحة لهذه السمة هي:
|
contentDetails.caption |
string تشير هذه السمة إلى ما إذا كانت الترجمة متاحة للفيديو. القيم الصالحة لهذه السمة هي:
|
contentDetails.licensedContent |
boolean يشير هذا العمود إلى ما إذا كان الفيديو يمثّل محتوًى مرخَّصًا، أي أنّه تم تحميل المحتوى إلى قناة مرتبطة بشريك محتوى على YouTube وطالب به ذلك الشريك. |
contentDetails.regionRestriction |
object يحتوي الكائن regionRestriction على معلومات حول البلدان التي يمكن (أو لا يمكن) فيها عرض الفيديو. سيحتوي العنصر على السمة contentDetails.regionRestriction.allowed أو السمة contentDetails.regionRestriction.blocked . |
contentDetails.regionRestriction.allowed[] |
list قائمة برموز المناطق التي تحدّد البلدان التي يمكن مشاهدة الفيديو فيها في حال توفّر هذه السمة ولم يكن البلد مدرَجًا في قيمتها، سيتم حظر الفيديو من الظهور في ذلك البلد. إذا كانت هذه السمة متوفرة وتتضمّن قائمة فارغة، سيتم حظر الفيديو في جميع البلدان. |
contentDetails.regionRestriction.blocked[] |
list قائمة برموز المناطق التي تحدّد البلدان التي يتم فيها حظر الفيديو في حال توفّر هذه السمة ولم يكن البلد مدرَجًا في قيمتها، سيكون الفيديو متاحًا في ذلك البلد. في حال توفّر هذه السمة وقائمة فارغة، سيكون الفيديو متاحًا في جميع البلدان. |
contentDetails.contentRating |
object تحدّد هذه السمة التقييمات التي حصل عليها الفيديو وفقًا لأنظمة تقييم مختلفة. |
contentDetails.contentRating.acbRating |
string تقييم مجلس التصنيف الأسترالي (ACB) أو هيئة الاتصالات والإعلام الأسترالية (ACMA) يتم استخدام تقييمات ACMA لتصنيف البرامج التلفزيونية للأطفال. القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.agcomRating |
string تقييم الفيديو من 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 Unterricht, Kunst nd Kultur). القيم الصالحة لهذا الموقع هي:
|
contentDetails.contentRating.catvRating |
string نظام تقييم التلفزيون الكندي - نظام تصنيف التلفزيون الكندي: تقييم الفيديو الصادر عن هيئة التلفزيون والتلفزيون والاتصالات الكندية (CRTC) بالنسبة إلى أحداث البث باللغة الإنجليزية الكندية لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي. القيم الصالحة لهذا الموقع هي:
|
contentDetails.contentRating.catvfrRating |
string تقييم الفيديو من "هيئة الاتصالات السلكية واللاسلكية الكندية" (CRTC) بالنسبة إلى أحداث البث المقدَّمة باللغة الفرنسية الكندية لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي. القيم الصالحة لهذا الموقع هي:
|
contentDetails.contentRating.cbfcRating |
string تقييم المجلس المركزي لاعتماد الأفلام (CBFC - الهند) الخاص بالفيديو: القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.cccRating |
string تقييم الفيديو Consejo de Calificación السينماtográfica (تشيلي) في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.cceRating |
string تقييم الفيديو وفقًا للبيان الصادر عن Comissão de Classificação de Espect Websiteculos في البرتغال القيم الصالحة لهذه السمة هي:
|
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 تقييم الفيديو المقدَّم من 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 بدلاً من ذلك.التقييم "المركز الوطني للسينما والثقافة الفرنسية" (Center 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 سينماtografí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 |
string voor de Classificatie van Audiovisuale Media (هولندا). القيم الصالحة لهذه السمة هي:
|
contentDetails.contentRating.kmrbRating |
string تقييم المجلس الكوري لتقييم وسائل الإعلام (Seli물연모원원) المرتبط بالفيديو تقيّم مؤسسة 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 تقييم الفيديو من موقع Medietellsynet الإلكتروني، وهو هيئة الإعلام النرويجية. في ما يلي القيم الصالحة لهذه السمة:
|
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 Picture Association of America (MPAA) في ما يلي القيم الصالحة لهذه السمة:
|
contentDetails.contentRating.mpaatRating |
string تقييم جمعية Motion Picture 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) الخاص بالفيديو (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 يتم تضمين معلومات حول ملف الفيديو الذي تم تحميله إلى YouTube من خلال الكائن fileDetails ، بما في ذلك درجة دقة الملف ومدته وبرنامج ترميز الصوت والفيديو ومعدلات نقل بيانات البث وغير ذلك. يمكن لمالك الفيديو فقط استرداد هذه البيانات.لن يتم عرض الكائن 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 يتم تضمين معلومات حول مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله في العنصر processingDetails . تحدد الخصائص في العنصر حالة المعالجة الحالية وتقديرًا للوقت المتبقي حتى ينتهي 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 عن عدد المشاهدين المتزامنين الذين تمت معالجتهم وإزالة المحتوى غير المرغوب فيه، وذلك من خلال "إحصاءات YouTube". يمكنك الاطّلاع على المزيد من المعلومات حول مقاييس البث المباشر في مركز مساعدة YouTube.
|
liveStreamingDetails.activeLiveChatId |
string معرّف المحادثة المباشرة النشطة حاليًا ومرفق بهذا الفيديو. يتم ملء هذا الحقل فقط إذا كان الفيديو عبارة عن بث مباشر يتضمّن محادثة مباشرة حاليًا. بعد انتقالات البث لإكمال هذا الحقل، ستتم إزالة المحتوى وإغلاق المحادثة المباشرة. بالنسبة إلى عمليات البث المستمرة التي لن يكون معرّف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل سيتم ربطها بالفيديو الجديد الذي يتم عرضه في الصفحة الدائمة. |
localizations |
object يحتوي العنصر localizations على ترجمات للبيانات الوصفية للفيديو. |
localizations.(key) |
object لغة النص المترجَم المرتبط بالقيمة الرئيسية والقيمة هي سلسلة تحتوي على رمز اللغة BCP-47. |
localizations.(key).title |
string تمثّل هذه السمة عنوان الفيديو المترجَم. |
localizations.(key).description |
string تمثّل هذه السمة وصف الفيديو المترجَم. |