Videos

إنّ جميع الفيديوهات التي يتم تحميلها عبر نقطة نهاية 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
تاريخ ووقت نشر الفيديو وقد يختلف هذا الوقت عن وقت تحميل الفيديو. على سبيل المثال، إذا تم تحميل فيديو كفيديو خاص ثم جعله علنيًا في وقت لاحق، ستحدِّد هذه السمة وقت ضبط الفيديو على "علني".

هناك حالتان خاصتان:
  • إذا تم تحميل فيديو كفيديو خاص، وتم استرداد البيانات الوصفية للفيديو من قِبل مالك القناة، تحدد قيمة السمة تاريخ تحميل الفيديو ووقته.
  • إذا تم تحميل الفيديو كفيديو غير مدرج، تحدد قيمة السمة أيضًا تاريخ تحميل الفيديو ووقته. في هذه الحالة، يمكن لأي شخص يعرف المعرّف الفريد للفيديو استرداد بياناته الوصفية.
يتم تحديد القيمة بتنسيق ISO 8601.
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
القيم الأساسية الصالحة هي:
  • default – الصورة المصغّرة التلقائية الصورة المصغّرة الافتراضية للفيديو - أو مورد يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث - هي عرض 120 بكسل وطول 90 بكسل. الصورة المصغّرة الافتراضية للقناة هي بعرض 88 بكسل وطول 88 بكسل.
  • medium – نسخة أعلى دقة من الصورة المصغّرة. بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وطول 180 بكسل. وبالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وطول 240 بكسل.
  • high – نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو مورد يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وطولها 360 بكسل. وبالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وطول 800 بكسل.
  • standard – نسخة بدرجة دقة أعلى من الصورة المصغّرة بدرجة دقة أعلى من الصورة المصغّرة بدقة high. تتوفر هذه الصورة لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. هذه الصورة بعرض 640 بكسل وطول 480 بكسل.
  • maxres – النسخة الأعلى دقة من الصورة المصغّرة يتوفر حجم الصورة هذا لبعض الفيديوهات وموارد أخرى تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. هذه الصورة بعرض 1280 بكسل وطول 720 بكسل.
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 حرف كحدّ أقصى. يُرجى مراعاة القواعد التالية بشأن طريقة حساب عدد الأحرف المسموح به:
  • تكون قيمة الخاصية عبارة عن قائمة، ويتم احتساب الفواصل بين العناصر في القائمة ضمن الحدّ الأقصى.
  • وفي حال احتوت العلامة على مسافة، سيتعامل خادم واجهة برمجة التطبيقات مع قيمة العلامة كما لو كانت ملتفة بين علامتَي اقتباس، ويتم احتساب علامات الاقتباس ضمن عدد الأحرف المسموح به. لذلك، لأغراض تحديد عدد الأحرف المسموح به، تحتوي العلامة Foo-Baz على سبعة أحرف، بينما تحتوي العلامة Foo-Baz على تسعة أحرف.
snippet.categoryId string
فئة الفيديو على YouTube المرتبطة بالفيديو يجب ضبط قيمة لهذه السمة إذا استدعيت طريقة videos.update وكنت تعدِّل الجزء snippet من مورد video.
snippet.liveBroadcastContent string
يشير إلى ما إذا كان الفيديو هو بث مباشر قادم/نشط. أو تكون القيمة "لا شيء" إذا لم يكن الفيديو بثًا مباشرًا قادمًا أو نشطًا.

القيم الصالحة لهذه السمة هي:
  • live
  • none
  • upcoming
snippet.defaultLanguage string
لغة النص في السمتَين snippet.title وsnippet.description للموردين في video.
snippet.localized object
يحتوي الكائن snippet.localized على عنوان ووصف مترجمَين للفيديو أو عنوان اللغة التلقائية للبيانات الوصفية للفيديو.
  • يتم عرض نص مترجَم في مقتطف المورد إذا استخدم الطلب videos.list المعلَمة hl لتحديد لغة يجب عرض النص المترجَم لها وكان النص المترجَم متاحًا بتلك اللغة.
  • يتم عرض البيانات الوصفية للغة التلقائية إذا لم يتم تحديد قيمة المعلَمة hl أو تحديد قيمة، لكنّ البيانات الوصفية المترجَمة غير متاحة للغة المحددة.
تحتوي السمة على قيمة للقراءة فقط. استخدِم الكائن 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) أو بدقة عادية.

في ما يلي القيم الصالحة لهذه السمة:
  • hd
  • sd
contentDetails.caption string
يشير إلى ما إذا كانت الترجمة متاحة للفيديو.

القيم الصالحة لهذه السمة هي:
  • false
  • true
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 لتصنيف البرامج التلفزيونية للأطفال.

القيم الصالحة لهذه السمة هي:
  • acbC – البرامج التي تم تصنيفها على أنّها C من قِبل هيئة الاتصالات والإعلام الأسترالية. هذه البرامج مخصصة للأطفال (بخلاف الأطفال في مرحلة ما قبل المدرسة) الذين تقل أعمارهم عن 14 عامًا.
  • acbE – هـ
  • من acbG إلى G
  • acbM - مليون
  • acbMa15plus – MA15+
  • acbP – البرامج التي تم تصنيفها على أنّها P من قِبل هيئة الاتصالات والإعلام الأسترالية. هذه البرامج مخصّصة للأطفال في مرحلة ما قبل المدرسة.
  • acbPg – PG
  • من acbR18plus إلى 18 عامًا وما فوق
  • acbUnrated
contentDetails.contentRating.agcomRating string
تقييم الفيديو الصادر عن Autorità في إيطاليا لكل le Garanzie nelle Comunicazioni (AGCOM).

القيم الصالحة لهذه السمة هي:
  • من agcomT إلى T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
تقييم الفيديو بعنوان Anatel (Asociación Nacional de Televisión) للتلفزيون التشيلي.

القيم الصالحة لهذا الموقع هي:
  • anatelA – أ
  • anatelF - فهرنهايت
  • من anatelI إلى I
  • anatelI10 – I-10
  • anatelI12 – I-12
  • anatelI7 – I-7
  • من anatelR إلى R
  • anatelUnrated
contentDetails.contentRating.bbfcRating string
تقييم المجلس البريطاني لتصنيف الأفلام (BBFC) التابع للفيديو

القيم الصالحة لهذه السمة هي:
  • من bbfc12 إلى 12
  • من bbfc12a إلى 12 أمبير
  • من bbfc15 إلى 15
  • من bbfc18 إلى 18 عامًا
  • bbfcPg – PG
  • من bbfcR18 إلى 18 راند جنوب أفريقيا
  • bbfcU – ش
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
تقييم الفيديو من "مجلس مراقبة الأفلام والفيديو" في تايلاند.

القيم الصالحة لهذه السمة هي:
  • من bfvc13 إلى 13
  • من bfvc15 إلى 15
  • من bfvc18 إلى 18 عامًا
  • من bfvc20 إلى 20
  • bfvcB - B
  • bfvcE – هـ
  • من bfvcG إلى G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
تقييم الفيديو من "المجلس النمساوي لتصنيف الوسائط" (Bundesministerium für Unter Richt, Kunst und Kultur).

القيم الصالحة لهذه السمة هي:
  • bmukk10 – 10+
  • من bmukk12 إلى 12 عامًا وما فوق
  • من bmukk14 إلى 14 عامًا وما فوق
  • من bmukk16 إلى 16 عامًا وما فوق
  • من bmukk6 إلى 6 سنوات أو أكثر
  • من bmukk8 إلى 8 أعوام أو أكثر
  • bmukkAa – غير محدود
  • bmukkUnrated
contentDetails.contentRating.catvRating string
نظام تقييم للتلفزيون الكندي - نظام تصنيف البرامج التلفزيونية الكندي لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي.

القيم الصالحة لهذا الموقع هي:
  • من catv14plus إلى 14 عامًا وما فوق
  • من catv18plus إلى 18 عامًا وما فوق
  • catvC - ج
  • catvC8 – C8
  • من catvG إلى G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
تمثّل هذه السمة تقييم الفيديو من "هيئة التلفزيون الإذاعية والاتصالات الكندية" (CRTC) بالنسبة إلى أحداث البث المباشر باللغة الفرنسية الكندية. لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني لمجلس معايير البث الكندي.

القيم الصالحة لهذا الموقع هي:
  • من catvfr13plus إلى 13 عامًا وما فوق
  • من catvfr16plus إلى 16 عامًا وما فوق
  • من catvfr18plus إلى 18 عامًا وما فوق
  • من catvfr8plus إلى 8 أعوام أو أكثر
  • من catvfrG إلى G
  • catvfrUnrated
contentDetails.contentRating.cbfcRating string
تقييم الفيديو من المجلس المركزي لاعتماد الأفلام (CBFC - الهند).

القيم الصالحة لهذه السمة هي:
  • cbfcA – أ
  • cbfcS – جنوب
  • cbfcU – ش
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
تقييم الفيديو بعنوان Consejo de Calificación Sentográfica (تشيلي).

القيم الصالحة لهذه السمة هي:
  • من ccc14 إلى 14 عامًا وما فوق
  • من ccc18 إلى 18 عامًا وما فوق
  • ccc18s – 18 عامًا وما فوق - conenido pornográfico
  • ccc18v – 18 عامًا وما فوق - conenido excesivamente متصفّحo
  • ccc6 – 6 سنوات أو أكثر - Inconveniente para menores de 7 años
  • cccTe - حساب المهام
  • cccUnrated
contentDetails.contentRating.cceRating string
تقييم الفيديو من Comissão de Classificação de Espect 'culos في البرتغال.

القيم الصالحة لهذه السمة هي:
  • من cceM12 إلى 12
  • من cceM14 إلى 14 عامًا
  • من cceM16 إلى 16 عامًا
  • من cceM18 إلى 18 عامًا
  • من cceM4 إلى 4
  • من cceM6 إلى 6 أشهر
  • cceUnrated
contentDetails.contentRating.chfilmRating string
تقييم الفيديو في سويسرا

القيم الصالحة لهذه السمة هي:
  • من chfilm0 إلى 0
  • من chfilm12 إلى 12
  • من chfilm16 إلى 16 عامًا
  • من chfilm18 إلى 18 عامًا
  • من chfilm6 إلى 6 أشهر
  • chfilmUnrated
contentDetails.contentRating.chvrsRating string
تقييم نظام تقييم الفيديو المنزلي الكندي (CHVRS) للفيديو.

القيم الصالحة لهذه السمة هي:
  • من chvrs14a إلى 14 أمبير
  • بين chvrs18a و18 أمبير
  • chvrsE – هـ
  • من chvrsG إلى G
  • chvrsPg – PG
  • من chvrsR إلى R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
تقييم الفيديو من "لجنة الأفلام في بلجيكا".

في ما يلي القيم الصالحة لهذه السمة:
  • cicfE – هـ
  • cicfKntEna – KNT/ENA
  • cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
تقييم الفيديو من CONSILIUL NATIONAL AL AUDIOVIZUALULUI (CNA) في رومانيا

القيم الصالحة لهذه السمة هي:
  • من cna12 إلى 12
  • من cna15 إلى 15
  • من cna18 إلى 18 عامًا
  • من cna18plus إلى 18 عامًا وما فوق
  • cnaAp – نقطة الوصول
  • cnaUnrated
contentDetails.contentRating.cncRating string
نظام التقييم في فرنسا - لجنة التصنيف السينمائي

القيم الصالحة لهذه السمة هي:
  • من cnc10 إلى 10
  • من cnc12 إلى 12
  • من cnc16 إلى 16 عامًا
  • من cnc18 إلى 18 عامًا
  • cncE – هـ
  • من cncT إلى T
  • cncUnrated
contentDetails.contentRating.csaRating string
إنّ تقييم الفيديو الصادر عن "المجلس الأعلى لهيئة الصوت والفيديو" في فرنسا والذي يقيّم محتوى البث.

القيم الصالحة لهذه السمة هي:
  • من csa10 إلى 10
  • من csa12 إلى 12
  • من csa16 إلى 16 عامًا
  • من csa18 إلى 18 عامًا
  • csaInterdiction – الحظر
  • من csaT إلى T
  • csaUnrated
contentDetails.contentRating.cscfRating string
تقييم الفيديو الصادر عن "لجنة مراقبة الأفلام في لوكسمبورغ" (CSCF)

القيم الصالحة لهذه السمة هي:
  • من cscf12 إلى 12
  • من cscf16 إلى 16 عامًا
  • من cscf18 إلى 18 عامًا
  • من cscf6 إلى 6 أشهر
  • من cscf9 إلى 9
  • cscfA – أ
  • cscfAl - ألاباما
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
تقييم الفيديو في جمهورية التشيك.

القيم الصالحة لهذه السمة هي:
  • من czfilm12 إلى 12
  • من czfilm14 إلى 14 عامًا
  • من czfilm18 إلى 18 عامًا
  • czfilmU – ش
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
إنّ تقييم Departamento de Justiça, Classificação, Qualificação e Títulos (DJCQT - البرازيل) الخاص بالفيديو.

القيم الصالحة لهذا الموقع هي:
  • من djctq10 إلى 10
  • من djctq12 إلى 12
  • من djctq14 إلى 14 عامًا
  • من djctq16 إلى 16 عامًا
  • من djctq18 إلى 18 عامًا
  • من djctqL إلى L
  • djctqUnrated
contentDetails.contentRating.djctqRatingReasons[] list
الأسباب التي توضّح سبب حصول الفيديو على تقييم DJCQT (البرازيل)
contentDetails.contentRating.ecbmctRating string
نظام التقييم في تركيا - مجلس التقييم والتصنيف التابع لوزارة الثقافة والسياحة

القيم الصالحة لهذا الموقع هي:
  • من ecbmct13a إلى 13 أمبير
  • من ecbmct13plus إلى 13 عامًا وما فوق
  • من ecbmct15a إلى 15 أمبير
  • من ecbmct15plus إلى 15 عامًا وما فوق
  • من ecbmct18plus إلى 18 عامًا وما فوق
  • ecbmct7a – 7A
  • من ecbmct7plus إلى 7 سنوات أو أكثر
  • من ecbmctG إلى G
  • ecbmctUnrated
  • ecbmct6a – 6A
  • من ecbmct6plus إلى 6 سنوات أو أكثر
  • ecbmct10a – 10 أمبير
  • ecbmct10plus – 10+
  • من ecbmct16plus إلى 16 عامًا وما فوق
contentDetails.contentRating.eefilmRating string
تقييم الفيديو في إستونيا.

القيم الصالحة لهذه السمة هي:
  • من eefilmK12 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من eefilmK14 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من eefilmK16 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من eefilmK6 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من eefilmL إلى L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere - بير
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
تقييم الفيديو في مصر.

القيم الصالحة لهذه السمة هي:
  • من egfilm18 إلى 18 عامًا
  • من egfilmBn إلى BN
  • egfilmGn – غينيا
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
تقييم Eirin للفيديو (映倫) Eirin هو نظام التقييم الياباني.

القيم الصالحة لهذه السمة هي:
  • من eirinG إلى G
  • من eirinPg12 إلى 12 عامًا
  • من eirinR15plus إلى 15 عامًا وما فوق
  • من eirinR18plus إلى 18 عامًا وما فوق
  • eirinUnrated
contentDetails.contentRating.fcbmRating string
تقييم الفيديو من مجلس مراقبة الأفلام الماليزي.

القيم الصالحة لهذه السمة هي:
  • من fcbm13 إلى 13
  • من fcbm16 إلى 16 عامًا
  • من fcbm18 إلى 18 عامًا
  • من fcbm18pa إلى 18 شهرًا
  • من fcbm18pl إلى 18 زلوتي
  • من fcbm18sg إلى 18 دولار سنغافوري
  • من fcbm18sx إلى 18 ثانية
  • من fcbmP12 إلى P12
  • من fcbmP13 إلى P13
  • من fcbmPg13 إلى 13 عامًا
  • fcbmU – ش
  • fcbmUnrated
contentDetails.contentRating.fcoRating string
تقييم الفيديو من مكتب الأفلام والصحيفة والمقالات في هونغ كونغ.

القيم الصالحة لهذه السمة هي:
  • من fcoI إلى I
  • fcoIi – الثاني
  • fcoIia – IIA
  • من fcoIib إلى IIB
  • fcoIii – 3
  • fcoUnrated
contentDetails.contentRating.fmocRating string
تم إيقاف هذا الموقع نهائيًا اعتبارًا من 2 تشرين الثاني (نوفمبر) 2015. استخدِم السمة contentDetails.contentRating.cncRating بدلاً من ذلك.

التقييم الوطني للفيديو هو Centre National du cinéma et de l'image animé (وزارة الثقافة الفرنسية) (وزارة الثقافة الفرنسية).

القيم الصالحة لهذه السمة هي:
  • من fmoc10 إلى 10
  • من fmoc12 إلى 12
  • من fmoc16 إلى 16 عامًا
  • من fmoc18 إلى 18 عامًا
  • fmocE – هـ
  • fmocU – ش
  • fmocUnrated
contentDetails.contentRating.fpbRating string
تقييم الفيديو من "مجلس الأفلام والمنشورات" في جنوب أفريقيا

القيم الصالحة لهذه السمة هي:
  • من fpb10 إلى 10
  • fpb1012Pg – 10-12PG
  • من fpb13 إلى 13
  • من fpb16 إلى 16 عامًا
  • من fpb18 إلى 18 عامًا
  • fpb79Pg – 7-9PG
  • fpbA – أ
  • fpbPg – PG
  • fpbUnrated
  • من fpbX18 إلى X18
  • من fpbXx إلى XX
contentDetails.contentRating.fpbRatingReasons[] list
الأسباب التي توضّح سبب حصول الفيديو على تقييم FPB (في جنوب أفريقيا)
contentDetails.contentRating.fskRating string
تقييم الفيديو بعنوان Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - ألمانيا) للفيديو.

القيم الصالحة لهذه السمة هي:
  • fsk0 – FSK 0
  • fsk12 – FSK 12
  • fsk16 – FSK 16
  • fsk18 – FSK 18
  • fsk6 – FSK 6
  • fskUnrated
contentDetails.contentRating.grfilmRating string
تقييم الفيديو في اليونان

في ما يلي القيم الصالحة لهذه السمة:
  • grfilmE – هـ
  • من grfilmK إلى كلفن
  • من grfilmK12 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK13 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK15 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK17 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK18 إلى مرحلة التعليم من الروضة حتى الثانوي
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
تقييم Instituto de la Cinematografía y de las Artes Audiovisuales (ICAA - إسبانيا) للفيديو.

القيم الصالحة لهذه السمة هي:
  • من icaa12 إلى 12
  • من icaa13 إلى 13
  • من icaa16 إلى 16 عامًا
  • من icaa18 إلى 18 عامًا
  • من icaa7 إلى 7 سنوات
  • icaaApta - APTA
  • icaaUnrated
  • من icaaX إلى X
contentDetails.contentRating.ifcoRating string
تقييم الفيديو وفقًا لمكتب تصنيف الأفلام الأيرلندية (IFCO - أيرلندا). يمكنك الاطّلاع على موقع IFCO الإلكتروني للحصول على المزيد من المعلومات.

القيم الصالحة لهذه السمة هي:
  • من ifco12 إلى 12
  • من ifco12a إلى 12 أمبير
  • من ifco15 إلى 15
  • من ifco15a إلى 15 أمبير
  • من ifco16 إلى 16 عامًا
  • من ifco18 إلى 18 عامًا
  • من ifcoG إلى G
  • ifcoPg – PG
  • ifcoUnrated
contentDetails.contentRating.ilfilmRating string
تقييم الفيديو في إسرائيل.

القيم الصالحة لهذه السمة هي:
  • من ilfilm12 إلى 12
  • من ilfilm16 إلى 16 عامًا
  • من ilfilm18 إلى 18 عامًا
  • ilfilmAa – AA
  • ilfilmUnrated
contentDetails.contentRating.incaaRating string
تقييم المعهد الوطني للمقاييس (INCAA) (Instituto Nacional de Cine y Artes Audiovisuales - Argentina) للفيديو

في ما يلي القيم الصالحة لهذه السمة:
  • incaaAtp – ATP (Apta para todo publico)
  • incaaC – X (Solo apta para myores de 18 años, de exhibición condicionada)
  • incaaSam13 – 13 (Solo apta para myores de 13 años)
  • incaaSam16 – 16 (Solo apta para myores de 16 años)
  • incaaSam18 – 18 (Solo apta para myores de 18 años)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
تقييم الفيديو من مجلس تصنيف الأفلام في كينيا.

القيم الصالحة لهذه السمة هي:
  • من kfcb16plus إلى 16 عامًا
  • kfcbG – جورجيا
  • kfcbPg – PG
  • من kfcbR إلى 18 عامًا
  • kfcbUnrated
contentDetails.contentRating.kijkwijzerRating string
voor de Classificatie van Audiovisuele Media (هولندا).

القيم الصالحة لهذه السمة هي:
  • من kijkwijzer12 إلى 12
  • من kijkwijzer14 إلى 14 عامًا
  • من kijkwijzer16 إلى 16 عامًا
  • من kijkwijzer18 إلى 18 عامًا
  • من kijkwijzer6 إلى 6 أشهر
  • من kijkwijzer9 إلى 9
  • kijkwijzerAl - ألاباما
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
تقييم الفيديو وفقًا لمجلس تقييم الوسائط الكوري (إقامة세물기 민위원) الخاص بالفيديو. يقيّم نظام KMRB الفيديوهات في كوريا الجنوبية.

القيم الصالحة لهذه السمة هي:
  • kmrb12plus – 12 세 이상 세람가
  • kmrb15plus – 15 세 이세 세람가
  • kmrbAll – 전체 람가
  • kmrbR - 청소년 가 불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
تقييم الفيديو من فيلم Lembaga Sensor Film في إندونيسيا

القيم الصالحة لهذه السمة هي:
  • من lsf13 إلى 13
  • من lsf17 إلى 17 عامًا
  • من lsf21 إلى 21
  • lsfA – أ
  • lsfBo - بوليفيا
  • من lsfD إلى يوم
  • من lsfR إلى R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
تقييم الفيديو من مجلس التصنيف العمري للأفلام في مالطا.

القيم الصالحة لهذه السمة هي:
  • من mccaa12 إلى 12
  • من mccaa12a إلى 12 أمبير
  • mccaa14 – 14 - تمت إزالة هذا التصنيف من هيكل التصنيف الجديد الذي تم تقديمه في عام 2013.
  • من mccaa15 إلى 15
  • mccaa16 – 16 - تمت إزالة هذا التصنيف من هيكل التصنيف الجديد الذي تم تقديمه في عام 2013.
  • من mccaa18 إلى 18 عامًا
  • mccaaPg – PG
  • mccaaU – ش
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
تقييم الفيديو من مجلس الوسائط للأطفال والشباب التابع لمعهد الأفلام الدانماركي (Det Danske Filminstitut) Media for Young People.

القيم الصالحة لهذه السمة هي:
  • من mccyp11 إلى 11
  • من mccyp15 إلى 15
  • من mccyp7 إلى 7 سنوات
  • mccypA – أ
  • mccypUnrated
contentDetails.contentRating.mcstRating string
نظام تقييم الفيديو في فيتنام - MCST

القيم الصالحة لهذه السمة هي:
  • من mcst0 إلى 0
  • من mcst16plus إلى 16 عامًا وما فوق
  • من mcstC13 إلى C13
  • من mcstC16 إلى C16
  • من mcstC18 إلى C18
  • mcstP - ع
  • mcstUnrated
  • mcstT13 – T13
  • mcstT16 – T16
  • من mcstT18 إلى T18
  • من mcstK إلى كلفن
contentDetails.contentRating.mdaRating string
تقييم الفيديو من "هيئة تطوير الوسائط" (MDA) في سنغافورة، وعلى وجه التحديد، "مجلس مراقبة الأفلام" (BFC).

القيم الصالحة لهذه السمة هي:
  • من mdaG إلى G
  • من mdaM18 إلى M18
  • من mdaNc16 إلى 16 عامًا
  • mdaPg – PG
  • من mdaPg13 إلى 13 عامًا
  • من mdaR21 إلى 21
  • mdaUnrated
contentDetails.contentRating.medietilsynetRating string
تقييم الفيديو من Medietilsynet، هيئة الإعلام النرويجية.

القيم الصالحة لهذه السمة هي:
  • من medietilsynet11 إلى 11
  • من medietilsynet12 إلى 12
  • من medietilsynet15 إلى 15
  • من medietilsynet18 إلى 18 عامًا
  • من medietilsynet6 إلى 6 أشهر
  • من medietilsynet7 إلى 7 سنوات
  • من medietilsynet9 إلى 9
  • medietilsynetA – أ
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
تقييم الفيديو من معهد Kansallinen Audiovisuaalinen (المعهد الوطني للصوت المرئي) في فنلندا).

القيم الصالحة لهذه السمة هي:
  • من meku12 إلى 12
  • من meku16 إلى 16 عامًا
  • من meku18 إلى 18 عامًا
  • من meku7 إلى 7 سنوات
  • mekuS – جنوب
  • mekuUnrated
contentDetails.contentRating.mibacRating string
تقييم الفيديو الصادر عن Ministero dei Beni e delle Attività Culturei e del Turismo (إيطاليا).

القيم الصالحة لهذه السمة هي:
  • mibacT
  • mibacUnrated
  • mibacVap
  • mibacVm6
  • mibacVm12
  • mibacVm14
  • mibacVm18
contentDetails.contentRating.mocRating string
تقييم Ministerio de Cultura (كولومبيا) للفيديو.

القيم الصالحة لهذه السمة هي:
  • من moc12 إلى 12
  • من moc15 إلى 15
  • من moc18 إلى 18 عامًا
  • من moc7 إلى 7 سنوات
  • mocBanned - محظور
  • mocE – هـ
  • من mocT إلى T
  • mocUnrated
  • من mocX إلى X
contentDetails.contentRating.moctwRating string
تقييم الفيديو من وزارة الثقافة في تايوان (sitemap化部).

القيم الصالحة لهذه السمة هي:
  • من moctwG إلى G
  • moctwP - ع
  • moctwPg – PG
  • من moctwR إلى R
  • moctwR12 – أحمر-12
  • من moctwR15 إلى 15 راند جنوب أفريقيا
  • moctwUnrated
contentDetails.contentRating.mpaaRating string
تقييم رابطة Motion Tech Association of America (MPAA) للفيديو.

القيم الصالحة لهذه السمة هي:
  • من mpaaG إلى G
  • من mpaaNc17 إلى 17 عامًا
  • mpaaPg – PG
  • mpaaPg13 – PG-13
  • من mpaaR إلى R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
تقييم Motion Tech Association of America للمقاطع الدعائية للأفلام ومعاينة الأفلام.

القيم الصالحة لهذه السمة هي:
  • mpaatGb – غيغابايت (نطاق أخضر - معتمد لجميع شرائح الجمهور)
  • mpaatRb – RB (سوار أحمر - يُنصح به للأعمار 17 عامًا وما فوق)
contentDetails.contentRating.mtrcbRating string
تقييم الفيديو من "مجلس تقييم الأفلام والبرامج التلفزيونية" و"مجلس تصنيف الأفلام" (الفلبين)

القيم الصالحة لهذه السمة هي:
  • من mtrcbG إلى G
  • mtrcbPg – PG
  • mtrcbR13 – أحمر-13
  • من mtrcbR16 إلى 16 راند جنوب أفريقيا
  • من mtrcbR18 إلى 18 عامًا
  • mtrcbUnrated
  • من mtrcbX إلى X
contentDetails.contentRating.nbcRating string
تقييم الفيديو من المكتب الوطني للتصنيف في جزر المالديف

في ما يلي القيم الصالحة لهذه السمة:
  • من nbc12plus إلى 12 عامًا وما فوق
  • من nbc15plus إلى 15 عامًا وما فوق
  • من nbc18plus إلى 18 عامًا وما فوق
  • من nbc18plusr إلى 18 سنة وما فوق
  • من nbcG إلى G
  • nbcPg – PG
  • nbcPu – بوليفيانو (PU)
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
تقييم الفيديو من المركز الوطني للأفلام البلغاري.

القيم الصالحة لهذه السمة هي:
  • nfrcA – أ
  • nfrcB - B
  • nfrcC - ج
  • من nfrcD إلى يوم
  • nfrcUnrated
  • من nfrcX إلى X
contentDetails.contentRating.nfvcbRating string
تقييم الفيديو من المجلس الوطني لرقابة الأفلام والفيديوهات في نيجيريا.

القيم الصالحة لهذه السمة هي:
  • من nfvcb12 إلى 12
  • من nfvcb12a إلى 12 أمبير
  • من nfvcb15 إلى 15
  • من nfvcb18 إلى 18 عامًا
  • من nfvcbG إلى G
  • nfvcbPg – PG
  • nfvcbRe – RE
  • nfvcbUnrated
contentDetails.contentRating.nkclvRating string
تقييم الفيديو من المركز الوطني للأفلام في لاتفيا (Nacionálais Kino centrs).

القيم الصالحة لهذه السمة هي:
  • من nkclv12plus إلى 12 عامًا وما فوق
  • من nkclv18plus إلى 18 عامًا وما فوق
  • من nkclv7plus إلى 7 سنوات أو أكثر
  • nkclvU – ش
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
تقييم مكتب الأفلام والأدب الخاص بالفيديو (OFLC - نيوزيلندا)

القيم الصالحة لهذه السمة هي:
  • من oflcG إلى G
  • oflcM - مليون
  • oflcPg – PG
  • من oflcR13 إلى 13 راند جنوب أفريقيا
  • من oflcR15 إلى 15 راند جنوب أفريقيا
  • من oflcR16 إلى 16 راند جنوب أفريقيا
  • من oflcR18 إلى 18 راند جنوب أفريقيا
  • oflcRp13 – RP13
  • oflcRp16 – RP16
  • oflcUnrated
contentDetails.contentRating.pefilmRating string
تقييم الفيديو في بيرو.

القيم الصالحة لهذه السمة هي:
  • من pefilm14 إلى 14 عامًا
  • من pefilm18 إلى 18 عامًا
  • pefilmPg – PG
  • pefilmPt – البرتغالية
  • pefilmUnrated
contentDetails.contentRating.resorteviolenciaRating string
تقييم الفيديو في فنزويلا.

القيم الصالحة لهذه السمة هي:
  • resorteviolenciaA – أ
  • resorteviolenciaB - B
  • resorteviolenciaC - ج
  • من resorteviolenciaD إلى يوم
  • resorteviolenciaE – هـ
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
تقييم المديرية العامة للراديو والتلفزيون والتصوير السينمائي (المكسيك) الخاص بالفيديو.

القيم الصالحة لهذه السمة هي:
  • rtcA – أ
  • rtcAa – AA
  • rtcB - B
  • من rtcB15 إلى B15
  • rtcC - ج
  • من rtcD إلى يوم
  • rtcUnrated
contentDetails.contentRating.rteRating string
تقييم الفيديو من Raidió Teilifís Éireann في أيرلندا.

في ما يلي القيم الصالحة لهذه السمة:
  • rteCh – سويسرا
  • rteGa – إحصاءات Google
  • rteMa – MA
  • rtePs – PS
  • rteUnrated
contentDetails.contentRating.russiaRating string
تقييم الفيديو الوطني في السجل الوطني للأفلام في الاتحاد الروسي (MKRF - روسيا).

القيم الصالحة لهذه السمة هي:
  • russia0 – 0+
  • من russia12 إلى 12 عامًا وما فوق
  • من russia16 إلى 16 عامًا وما فوق
  • من russia18 إلى 18 عامًا وما فوق
  • من russia6 إلى 6 سنوات أو أكثر
  • russiaUnrated
contentDetails.contentRating.skfilmRating string
تقييم الفيديو في سلوفاكيا.

القيم الصالحة لهذه السمة هي:
  • من skfilmG إلى G
  • skfilmP2 – P2
  • من skfilmP5 إلى P5
  • من skfilmP8 إلى P8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
تقييم الفيديو في آيسلندا.

القيم الصالحة لهذه السمة هي:
  • من smais12 إلى 12
  • من smais14 إلى 14 عامًا
  • من smais16 إلى 16 عامًا
  • من smais18 إلى 18 عامًا
  • من smais7 إلى 7 سنوات
  • من smaisL إلى L
  • smaisUnrated
contentDetails.contentRating.smsaRating string
تقييم الفيديو من Statens medieräd (المجلس الوطني السويدي للوسائط).

القيم الصالحة لهذه السمة هي:
  • من smsa11 إلى 11
  • من smsa15 إلى 15
  • من smsa7 إلى 7 سنوات
  • smsaA – جميع الأعمار
  • smsaUnrated
contentDetails.contentRating.tvpgRating string
تقييم إرشادات الرقابة الأبوية (TVPG) الخاص بالفيديو.

في ما يلي القيم الصالحة لهذه السمة:
  • tvpgG – TV-G
  • tvpgMa – TV-MA
  • tvpgPg – TV-PG
  • tvpgUnrated
  • tvpgY – TV-Y
  • tvpgY7 – TV-Y7
  • tvpgY7Fv – TV-Y7-FV
  • pg14 – TV-14
contentDetails.contentRating.ytRating string
تقييم تستخدمه منصة YouTube لتحديد المحتوى المحظور على فئات عمرية معيّنة.

القيم الصالحة لهذه السمة هي:
  • ytAgeRestricted
contentDetails.projection string
تحدّد هذه السمة تنسيق عرض الفيديو.

القيم الصالحة لهذه السمة هي:
  • 360
  • rectangular
contentDetails.hasCustomThumbnail boolean
يشير إلى ما إذا كان القائم بتحميل الفيديو قد قدّم صورة مصغّرة مخصّصة للفيديو. لا تظهر هذه الخاصية إلا للقائم بتحميل الفيديو.
status object
يحتوي الكائن status على معلومات حول حالات تحميل الفيديو ومعالجتها وخصوصيته.
status.uploadStatus string
حالة الفيديو الذي تم تحميله.

القيم الصالحة لهذه السمة هي:
  • deleted
  • failed
  • processed
  • rejected
  • uploaded
status.failureReason string
توضّح هذه القيمة سبب تعذّر تحميل الفيديو. لا تتوفّر هذه السمة إلا إذا كانت السمة uploadStatus تشير إلى تعذّر عملية التحميل.

القيم الصالحة لهذا الموقع الإلكتروني هي:
  • codec
  • conversion
  • emptyFile
  • invalidFile
  • tooSmall
  • uploadAborted
status.rejectionReason string
توضّح هذه القيمة سبب رفض منصة YouTube لفيديو تم تحميله. لا تتوفّر هذه السمة إلا إذا كانت السمة uploadStatus تشير إلى رفض التحميل.

القيم الصالحة لهذا الموقع هي:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
حالة خصوصية الفيديو

القيم الصالحة لهذه السمة هي:
  • private
  • public
  • unlisted
status.publishAt datetime
التاريخ والوقت اللذان تمت جدولة الفيديو فيهما لنشره ولا يمكن ضبطها إلا إذا كانت حالة خصوصية الفيديو خاصة. يتم تحديد القيمة بتنسيق ISO 8601. يُرجى الاطّلاع على النقطتين الإضافيتين التاليتين بشأن سلوك هذا الموقع:
  • في حال ضبط قيمة هذه السمة عند استدعاء طريقة videos.update، يجب أيضًا ضبط قيمة السمة status.privacyStatus على private حتى إذا كان الفيديو خاصًا.
  • إذا كان طلبك يحدد موعدًا لنشر فيديو في وقت سابق، سيتمّ نشر الفيديو على الفور. بناءً على ذلك، إنّ تأثير ضبط السمة status.publishAt على تاريخ ووقت سابقَين هو نفسه تأثير تغيير السمة privacyStatus الخاصة بالفيديو من private إلى public.
status.license string
ترخيص الفيديو.

القيم الصالحة لهذه السمة هي:
  • creativeCommon
  • youtube
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> تتضمّن مشغّلاً لتشغيل الفيديو
  • إذا كان طلب البيانات من واجهة برمجة التطبيقات لاسترداد المورد يحدِّد قيمة للمَعلمتَين maxHeight و/أو maxWidth، يتم تعديل حجم المشغّل المضمَّن لاستيفاء متطلبات maxHeight و/أو maxWidth.
  • إذا كانت نسبة العرض إلى الارتفاع للفيديو غير معروفة، يكون التنسيق التلقائي للمشغّل المضمَّن هو 4:3.
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 ملفات الفيديو فقط، غير أن هذا الحقل يظهر سواء تم تحميل ملف فيديو أو نوع آخر من الملفات.

القيم الصالحة لهذه السمة هي:
  • archive – الملف هو ملف أرشيف، مثل أرشيف بالامتداد .zip.
  • audio – الملف هو نوع ملف صوتي معروف، مثل ملف mp3.
  • document – الملف هو مستند أو ملف نصي، مثل مستند MS Word.
  • image – الملف عبارة عن ملف صورة، مثل صورة بتنسيق jpeg.
  • other – الملف هو نوع ملف آخر من غير الفيديوهات.
  • project – الملف عبارة عن ملف مشروع فيديو، مثل مشروع Microsoft Windows Movie Maker، ولا يحتوي على بيانات فيديو فعلية.
  • video – الملف هو نوع ملف فيديو معروف، مثل ملف mp4.
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 لتدوير محتوى المصدر الأصلي من أجل عرض الفيديو بشكل صحيح.

في ما يلي القيم الصالحة لهذه السمة:
  • clockwise – يجب تدوير الفيديو بمقدار 90 درجة في اتجاه عقارب الساعة.
  • counterClockwise – يجب تدوير الفيديو بمقدار 90 درجة عكس اتجاه عقارب الساعة.
  • none – ليس من الضروري تدوير الفيديو.
  • other – يجب تعديل الفيديو بطريقة أخرى غير تافهة.
  • upsideDown – يجب تدوير الفيديو بشكل مقلوب.
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 التالية:
  • التاريخ فقط: YYYY-MM-DD
  • الوقت الأصلي: YYYY-MM-DDTHH:MM:SS
  • الوقت بتوقيت المنطقة الزمنية: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
يتضمّن الكائن processingDetails معلومات حول مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله. تحدّد الخصائص في العنصر حالة المعالجة الحالية وتقديرًا للوقت المتبقي على انتهاء YouTube من معالجة الفيديو. يشير هذا الجزء أيضًا إلى ما إذا كانت أنواع مختلفة من البيانات أو المحتوى متاحة للفيديو، مثل تفاصيل الملف أو الصور المصغّرة.

تم تصميم الكائن processingProgress لاستطلاع الرأي، وبالتالي يمكن للفيديو الذي تم تحميله تتبّع مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله. لا يمكن استرداد هذه البيانات إلا من قِبل مالك الفيديو.
processingDetails.processingStatus string
حالة معالجة الفيديو تشير هذه القيمة إلى ما إذا تمكّن YouTube من معالجة الفيديو أو إلى ما إذا كان الفيديو لا يزال قيد المعالجة.

القيم الصالحة لهذه السمة هي:
  • failed – تعذّرت معالجة الفيديو. يُرجى الاطّلاع على سبب تعذُّر معالجة البيانات.
  • processing – تتم حاليًا معالجة الفيديو. الاطّلاع على "مستوى تقدّم المعالجة"
  • succeeded – تمت معالجة الفيديو بنجاح.
  • terminated – لم تعُد معالجة المعلومات متاحة.
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.

القيم الصالحة لهذه السمة هي:
  • other – تعذّرت معالجة بعض المكوّنات الأخرى.
  • streamingFailed – تعذّر إرسال الفيديو إلى منشئي البث.
  • transcodeFailed – تعذّر تحويل ترميز المحتوى.
  • uploadFailed – تعذّر تسليم الملف.
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.

القيم الصالحة لهذه السمة هي:
  • archiveFile – ملف أرشيف (مثل أرشيف ZIP).
  • audioFile – يحتوي الملف على ملف صوتي فقط (مثل ملف MP3).
  • docFile – مستند أو ملف نصي (مثل مستند MS Word).
  • imageFile – ملف صورة (مثل صورة JPEG).
  • notAVideoFile: ملف آخر غير ملفات الفيديو
  • projectFile – ملف مشروع فيلم (مثل Microsoft Windows Movie Maker).
suggestions.processingWarnings[] list
قائمة بالأسباب التي قد تجعل منصة YouTube تواجه صعوبة في تحويل ترميز الفيديو الذي تم تحميله أو التي قد تؤدي إلى حدوث خطأ في تحويل الترميز. يتم إنشاء هذه التحذيرات قبل أن يعالج YouTube ملف الفيديو الذي تم تحميله فعليًا. بالإضافة إلى ذلك، تحدّد الأنظمة المشاكل التي لا تشير بالضرورة إلى تعذُّر معالجة الفيديو، ولكنها قد تؤدي إلى مشاكل، مثل مشاكل في المزامنة أو عناصر الفيديو أو عدم توفّر المقطع الصوتي.

القيم الصالحة لهذه السمة هي:
  • hasEditlist – قوائم التعديل غير متاحة حاليًا.
  • inconsistentResolution – درجة الدقة المتعارضة للحاويات ومجموعة البث
  • problematicAudioCodec – تم استخدام برنامج ترميز الصوت المعروف أنه يتسبب في حدوث مشاكل.
  • problematicVideoCodec – تم استخدام برنامج ترميز الفيديو المعروف أنه يتسبب في حدوث مشاكل.
  • unknownAudioCodec – برنامج ترميز صوت غير معروف، لذا من المرجّح أن يتعذّر تحويل الترميز.
  • unknownContainer – تنسيق الملف غير معروف، ومن المحتمل أن يتعذّر تحويل الترميز.
  • unknownVideoCodec – برنامج ترميز فيديو غير معروف، لذا من المرجّح أن يتعذّر تحويل ترميز الفيديو.
suggestions.processingHints[] list
قائمة اقتراحات قد تساهم في تحسين قدرة YouTube على معالجة الفيديو.

القيم الصالحة لهذه السمة هي:
  • nonStreamableMov – ملف MP4 غير قابل للبث، ما سيؤدي إلى إبطاء المعالجة.
  • sendBestQualityVideo – من المحتمل أنّه يتوفّر نسخة من الفيديو بجودة أعلى.
suggestions.tagSuggestions[] list
قائمة بعلامات الكلمات الرئيسية التي يمكن إضافتها إلى البيانات الوصفية للفيديو من أجل زيادة احتمال عثور المستخدمين على الفيديو الخاص بك عند البحث عن الفيديو أو تصفّحه على YouTube.
suggestions.tagSuggestions[].tag string
تشير هذه السمة إلى علامة الكلمة الرئيسية المقترَحة للفيديو.
suggestions.tagSuggestions[].categoryRestricts[] list
مجموعة من فئات الفيديو ذات الصلة بالعلامة. ويمكنك استخدام هذه المعلومات لعرض الاقتراحات المناسبة للعلامات استنادًا إلى فئة الفيديو التي يربطها القائم بتحميل الفيديو بالفيديو. بشكلٍ تلقائي، تكون اقتراحات العلامات ملائمة لجميع الفئات في حال عدم وجود قيود محدّدة للكلمة الرئيسية.
suggestions.editorSuggestions[] list
قائمة بعمليات تعديل الفيديو التي قد تؤدي إلى تحسين جودة الفيديو أو تجربة تشغيل الفيديو الذي تم تحميله.

القيم الصالحة لهذه السمة هي:
  • audioQuietAudioSwap: يبدو المقطع الصوتي صامتًا ويمكن استبداله بمقطع صوتي بجودة أفضل.
  • videoAutoLevels – مستويات سطوع الصورة تبدو غير مفعّلة ويمكن تصحيحها.
  • videoCrop – يمكن اقتصاص الهوامش (اللامعة) التي تم رصدها حول الصورة.
  • videoStabilize – يبدو الفيديو غير مستقر ويمكن تثبيت دقته.
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
وصف الفيديو المترجَم