Videos

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

هناك حالتان خاصتان:
  • إذا تم تحميل فيديو كفيديو خاص واسترداد مالك القناة بياناته الوصفية، تحدد قيمة السمة تاريخ تحميل الفيديو ووقته.
  • إذا تم تحميل فيديو كفيديو غير مُدرَج، تحدّد قيمة السمة أيضًا تاريخ تحميل الفيديو ووقته. في هذه الحالة، يمكن لأي شخص يعرف معرّف الفيديو الفريد استرداد بياناته الوصفية.
يتم تحديد القيمة بتنسيق ISO 8601.
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
في ما يلي قيم المفاتيح الصالحة:
  • 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 – E
  • من 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 – A
  • anatelF – F
  • 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 – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
تقييم الفيديو من مجلس رقابة الأفلام والفيديو في تايلاند

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

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

القيم الصالحة لهذا الموقع هي:
  • من catv14plus إلى 14 عامًا أو أكثر
  • من catv18plus إلى 18 عامًا وما فوق
  • catvC – C
  • 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 – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
تقييم الفيديو Consejo de Calificación السينماtográfica (تشيلي)

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

القيم الصالحة لهذه السمة هي:
  • بين 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 – E
  • من chvrsG إلى G
  • chvrsPg – PG
  • chvrsR – R
  • chvrsUnrated
contentDetails.contentRating.cicfRating string
تقييم الفيديو الصادر عن "لجنة الأفلام في بلجيكا (بلجيكا)"

في ما يلي القيم الصالحة لهذه السمة:
  • cicfE – E
  • 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 – E
  • cncT – T
  • cncUnrated
contentDetails.contentRating.csaRating string
تقييم الفيديو المقدَّم من Conseil supérieur de l?audiovisuel الصادر عن فرنسا والذي يقيّم محتوى البث.

القيم الصالحة لهذه السمة هي:
  • من 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 – A
  • cscfAl – ألبانيا
  • cscfUnrated
contentDetails.contentRating.czfilmRating string
تقييم الفيديو في جمهورية التشيك:

القيم الصالحة لهذه السمة هي:
  • بين czfilm12 و12
  • بين czfilm14 و14 عامًا
  • بين czfilm18 و18 عامًا
  • czfilmU – U
  • 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 – 13A
  • من 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 إلى مرحلة 6 من الروضة حتى الثانوي
  • eefilmL – L
  • eefilmMs12 – معيار MS-12
  • eefilmMs6 – MS-6
  • eefilmPere - بير
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
تقييم الفيديو في مصر

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

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

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

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

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

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

في ما يلي القيم الصالحة لهذه السمة:
  • من fpb10 إلى 10
  • fpb1012Pg – من 10 إلى 12 سنة
  • بين fpb13 و13
  • بين fpb16 و16
  • بين fpb18 و18 عامًا
  • من fpb79Pg إلى 7 إلى 9 سنوات
  • fpbA – A
  • 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 – E
  • من grfilmK إلى K
  • من grfilmK12 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK13 إلى مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK15 إلى مرحلة التعليم من الروضة حتى الثانوي
  • grfilmK17 – مرحلة التعليم من الروضة حتى الثانوي
  • من grfilmK18 إلى مرحلة رياض الأطفال حتى سن 18 عامًا
  • grfilmUnrated
contentDetails.contentRating.icaaRating string
تقييم "Instituto de la سينماtografí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)

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

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

القيم الصالحة لهذه السمة هي:
  • بين kijkwijzer12 و12
  • بين kijkwijzer14 و14 عامًا
  • بين kijkwijzer16 و16
  • بين kijkwijzer18 و18 عامًا
  • بين kijkwijzer6 و6
  • بين kijkwijzer9 و9
  • kijkwijzerAl – ألبانيا
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
تقييم المجلس الكوري لتقييم وسائل الإعلام (Seli물연모원원) المرتبط بالفيديو تقيّم مؤسسة KMRB الفيديوهات في كوريا الجنوبية.

القيم الصالحة لهذه السمة هي:
  • kmrb12plus – 12 세 이지 서람가
  • kmrb15plus – 15세 이지 민람가
  • kmrbAll – 전체 람가
  • kmrbR – 청엘년 연람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
تقييم الفيديو من قِبل شركة Lembaga Sensor Film الإندونيسية.

القيم الصالحة لهذه السمة هي:
  • بين lsf13 و13
  • بين lsf17 و17
  • بين lsf21 و21
  • lsfA – A
  • lsfBo – BO
  • lsfD – D
  • 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 – U
  • mccaaUnrated
contentDetails.contentRating.mccypRating string
تقييم الفيديو من مجلس الإعلام للأطفال والشباب التابع لمعهد الفيلم الدانماركي (Det Danske Filminstitut).

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

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

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

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

القيم الصالحة لهذه السمة هي:
  • بين meku12 و12
  • بين meku16 و16
  • بين meku18 و18 عامًا
  • من meku7 إلى 7 سنوات
  • mekuS – S
  • 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 – E
  • mocT – T
  • mocUnrated
  • mocX – X
contentDetails.contentRating.moctwRating string
تقييم الفيديو الصادر عن وزارة الثقافة في تايوان (sitemap化部).

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

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

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

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

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

القيم الصالحة لهذه السمة هي:
  • nfrcA – A
  • nfrcB – B
  • nfrcC – C
  • nfrcD – D
  • 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 – U
  • nkclvUnrated
contentDetails.contentRating.oflcRating string
تقييم مكتب تصنيف الأفلام والأدب (OFLC) الخاص بالفيديو (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 – A
  • resorteviolenciaB – B
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
تقييم المديرية العامة للراديو والتلفزيون والتصوير السينمائي (المكسيك) للفيديو (المكسيك).

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

القيم الصالحة لهذه السمة هي:
  • rteCh – CH
  • 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
يتم تضمين معلومات حول ملف الفيديو الذي تم تحميله إلى YouTube من خلال الكائن fileDetails، بما في ذلك درجة دقة الملف ومدته وبرنامج ترميز الصوت والفيديو ومعدلات نقل بيانات البث وغير ذلك. يمكن لمالك الفيديو فقط استرداد هذه البيانات.

لن يتم عرض الكائن 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
يتم تضمين معلومات حول مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله في العنصر processingDetails. تحدد الخصائص في العنصر حالة المعالجة الحالية وتقديرًا للوقت المتبقي حتى ينتهي 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 عن عدد المشاهدين المتزامنين الذين تمت معالجتهم وإزالة المحتوى غير المرغوب فيه، وذلك من خلال "إحصاءات YouTube". يمكنك الاطّلاع على المزيد من المعلومات حول مقاييس البث المباشر في مركز مساعدة YouTube.
liveStreamingDetails.activeLiveChatId string
معرّف المحادثة المباشرة النشطة حاليًا ومرفق بهذا الفيديو. يتم ملء هذا الحقل فقط إذا كان الفيديو عبارة عن بث مباشر يتضمّن محادثة مباشرة حاليًا. بعد انتقالات البث لإكمال هذا الحقل، ستتم إزالة المحتوى وإغلاق المحادثة المباشرة. بالنسبة إلى عمليات البث المستمرة التي لن يكون معرّف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل سيتم ربطها بالفيديو الجديد الذي يتم عرضه في الصفحة الدائمة.
localizations object
يحتوي العنصر localizations على ترجمات للبيانات الوصفية للفيديو.
localizations.(key) object
لغة النص المترجَم المرتبط بالقيمة الرئيسية والقيمة هي سلسلة تحتوي على رمز اللغة BCP-47.
localizations.(key).title string
تمثّل هذه السمة عنوان الفيديو المترجَم.
localizations.(key).description string
تمثّل هذه السمة وصف الفيديو المترجَم.