Videos

سيتم حظر إمكانية مشاهدة جميع الفيديوهات التي تم تحميلها من خلال نقطة نهاية videos.insert من مشاريع واجهة برمجة التطبيقات التي لم يتم التحقّق منها والتي تم إنشاؤها بعد 28 تموز (يوليو) 2 2020، إلا في وضع المشاهدة الخاصة. لرفع هذا القيد، يجب أن يخضع كل مشروع لواجهة برمجة التطبيقات لمراجعة للتحقّق من الامتثال لبنود الخدمة. يُرجى الاطّلاع على سجلّ النُسخ السابقة لواجهة برمجة التطبيقات للحصول على مزيد من التفاصيل.

يمثّل مرجع video فيديو على YouTube.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية لموارد videos:

getRating
استرداد التقييمات التي منحها المستخدم المفوّض لقائمة فيديوهات محدّدة. التجربة الآن
list
يعرض قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
إدراج
تحمّل فيديو إلى YouTube وتضبط البيانات الوصفية الخاصة به بشكل اختياري.
تعديل
تعديل البيانات الوصفية للفيديو التجربة الآن
حذف
حذف فيديو على YouTube التجربة الآن
السعر
إضافة تقييم "أعجبني" أو "لم يعجبني" إلى فيديو أو إزالة تقييم من فيديو التجربة الآن
reportAbuse
الإبلاغ عن فيديو يتضمّن محتوًى مسيئًا التجربة الآن

تمثيل الموارد

تعرض بنية JSON التالية تنسيق مورد videos:

{
  "kind": "youtube#video",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "tags": [
      string
    ],
    "categoryId": string,
    "liveBroadcastContent": string,
    "defaultLanguage": string,
    "localized": {
      "title": string,
      "description": string
    },
    "defaultAudioLanguage": string
  },
  "contentDetails": {
    "duration": string,
    "dimension": string,
    "definition": string,
    "caption": string,
    "licensedContent": boolean,
    "regionRestriction": {
      "allowed": [
        string
      ],
      "blocked": [
        string
      ]
    },
    "contentRating": {
      "acbRating": string,
      "agcomRating": string,
      "anatelRating": string,
      "bbfcRating": string,
      "bfvcRating": string,
      "bmukkRating": string,
      "catvRating": string,
      "catvfrRating": string,
      "cbfcRating": string,
      "cccRating": string,
      "cceRating": string,
      "chfilmRating": string,
      "chvrsRating": string,
      "cicfRating": string,
      "cnaRating": string,
      "cncRating": string,
      "csaRating": string,
      "cscfRating": string,
      "czfilmRating": string,
      "djctqRating": string,
      "djctqRatingReasons": [,
        string
      ],
      "ecbmctRating": string,
      "eefilmRating": string,
      "egfilmRating": string,
      "eirinRating": string,
      "fcbmRating": string,
      "fcoRating": string,
      "fmocRating": string,
      "fpbRating": string,
      "fpbRatingReasons": [,
        string
      ],
      "fskRating": string,
      "grfilmRating": string,
      "icaaRating": string,
      "ifcoRating": string,
      "ilfilmRating": string,
      "incaaRating": string,
      "kfcbRating": string,
      "kijkwijzerRating": string,
      "kmrbRating": string,
      "lsfRating": string,
      "mccaaRating": string,
      "mccypRating": string,
      "mcstRating": string,
      "mdaRating": string,
      "medietilsynetRating": string,
      "mekuRating": string,
      "mibacRating": string,
      "mocRating": string,
      "moctwRating": string,
      "mpaaRating": string,
      "mpaatRating": string,
      "mtrcbRating": string,
      "nbcRating": string,
      "nbcplRating": string,
      "nfrcRating": string,
      "nfvcbRating": string,
      "nkclvRating": string,
      "oflcRating": string,
      "pefilmRating": string,
      "rcnofRating": string,
      "resorteviolenciaRating": string,
      "rtcRating": string,
      "rteRating": string,
      "russiaRating": string,
      "skfilmRating": string,
      "smaisRating": string,
      "smsaRating": string,
      "tvpgRating": string,
      "ytRating": string
    },
    "projection": string,
    "hasCustomThumbnail": boolean
  },
  "status": {
    "uploadStatus": string,
    "failureReason": string,
    "rejectionReason": string,
    "privacyStatus": string,
    "publishAt": datetime,
    "license": string,
    "embeddable": boolean,
    "publicStatsViewable": boolean,
    "madeForKids": boolean,
    "selfDeclaredMadeForKids": boolean,
    "containsSyntheticMedia": boolean
  },
  "statistics": {
    "viewCount": string,
    "likeCount": string,
    "dislikeCount": string,
    "favoriteCount": string,
    "commentCount": string
  },
  "paidProductPlacementDetails": {
    "hasPaidProductPlacement": boolean
  },
  "player": {
    "embedHtml": string,
    "embedHeight": long,
    "embedWidth": long
  },
  "topicDetails": {
    "topicIds": [
      string
    ],
    "relevantTopicIds": [
      string
    ],
    "topicCategories": [
      string
    ]
  },
  "recordingDetails": {
    "recordingDate": datetime
  },
  "fileDetails": {
    "fileName": string,
    "fileSize": unsigned long,
    "fileType": string,
    "container": string,
    "videoStreams": [
      {
        "widthPixels": unsigned integer,
        "heightPixels": unsigned integer,
        "frameRateFps": double,
        "aspectRatio": double,
        "codec": string,
        "bitrateBps": unsigned long,
        "rotation": string,
        "vendor": string
      }
    ],
    "audioStreams": [
      {
        "channelCount": unsigned integer,
        "codec": string,
        "bitrateBps": unsigned long,
        "vendor": string
      }
    ],
    "durationMs": unsigned long,
    "bitrateBps": unsigned long,
    "creationTime": string
  },
  "processingDetails": {
    "processingStatus": string,
    "processingProgress": {
      "partsTotal": unsigned long,
      "partsProcessed": unsigned long,
      "timeLeftMs": unsigned long
    },
    "processingFailureReason": string,
    "fileDetailsAvailability": string,
    "processingIssuesAvailability": string,
    "tagSuggestionsAvailability": string,
    "editorSuggestionsAvailability": string,
    "thumbnailsAvailability": string
  },
  "suggestions": {
    "processingErrors": [
      string
    ],
    "processingWarnings": [
      string
    ],
    "processingHints": [
      string
    ],
    "tagSuggestions": [
      {
        "tag": string,
        "categoryRestricts": [
          string
        ]
      }
    ],
    "editorSuggestions": [
      string
    ]
  },
  "liveStreamingDetails": {
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "concurrentViewers": unsigned long,
    "activeLiveChatId": string
  },
  "localizations": {
    (key): {
      "title": string,
      "description": string
    }
  }
}

أماكن إقامة

يحدِّد الجدول التالي السمات التي تظهر في هذا المرجع:

أماكن إقامة
kind string
تحدد هذه السمة نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#video.
etag etag
رقم تعريف Etag لهذا المورد.
id string
المعرّف الذي تستخدمه منصة YouTube لتحديد الفيديو بشكل فريد
snippet object
يحتوي العنصر snippet على تفاصيل أساسية عن الفيديو، مثل عنوانه ووصفه وفئتَه.
snippet.publishedAt datetime
تاريخ نشر الفيديو ووقته يُرجى العِلم أنّ هذه الفترة قد تختلف عن وقت تحميل الفيديو. على سبيل المثال، إذا تم تحميل فيديو كفيديو خاص ثم تم نشره علنًا في وقت لاحق، سيحدّد هذا السمة وقت نشر الفيديو علنًا.

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

في ما يلي القيم الصالحة لهذه السمة:
  • 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 – M
  • من acbMa15plus إلى MA15+
  • acbP – البرامج التي حازت على تصنيف P من قِبل هيئة الاتصالات والإعلام الأسترالية. هذه البرامج مخصّصة للأطفال في مرحلة الروضة.
  • acbPg – PG
  • acbR18plus – R18+
  • acbUnrated
contentDetails.contentRating.agcomRating string
تقييم الفيديو من الموقع الإلكتروني Autorità per 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 – 12A
  • bbfc15 – 15
  • bbfc18 – 18
  • bbfcPg – PG
  • bbfcR18 – R18
  • bbfcU – U
  • bbfcUnrated
contentDetails.contentRating.bfvcRating string
التقييم الذي منحه مجلس رقابة الأفلام والفيديوهات في تايلاند للفيديو.

القيم الصالحة لهذه السمة هي:
  • من bfvc13 إلى 13
  • bfvc15 – 15
  • bfvc18 – 18
  • bfvc20 – 20
  • bfvcB – ب
  • bfvcE – شرق
  • bfvcG – G
  • bfvcUnrated
contentDetails.contentRating.bmukkRating string
يشير هذا الحقل إلى تقييم الفيديو من مجلس تصنيف الوسائط النمساوي (Bundesministerium für Unterricht, Kunst und 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 – غ
  • 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 – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – U/A
  • cbfcUA7plus – U/A
  • cbfcUA13plus – U/A
  • cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
يشير هذا الحقل إلى تقييم Consejo de Calificación Cinematográfica (تشيلي) للفيديو.

في ما يلي القيم الصالحة لهذا الحقل:
  • من ccc14 إلى 14 عامًا وما فوق
  • ccc18 – 18+
  • ccc18s – 18+ - contenido pornográfico
  • ccc18v – 18+ - contenido exceivamente عَنِيف
  • ccc6 – 6+ - Inconveniente para menores de 7 años
  • cccTe – Todo espectador
  • 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 – 14A
  • من 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 – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
نظام التقييم في فرنسا - Commission de classification cinematographique

في ما يلي القيم الصالحة لهذه السمة:
  • cnc10 – 10
  • cnc12 – 12
  • من cnc16 إلى 16
  • من cnc18 إلى 18
  • cncE – E
  • 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 – 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 – لتر
  • 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 – الروضة إلى الصف السادس
  • eefilmL – لتر
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – بيريه
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
التقييم الذي حصل عليه الفيديو في مصر.

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

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

في ما يلي القيم الصالحة لهذا الحقل:
  • fcbm13 – 13
  • من fcbm16 إلى 16
  • fcbm18 – 18
  • fcbm18pa – 18PA
  • fcbm18pl – 18PL
  • fcbm18sg – 18SG
  • 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 بدلاً من ذلك.

تشير هذه السمة إلى تقييم الفيديو من قِبل المركز الوطني للسينما والصورة المتحركة (وزارة الثقافة الفرنسية).

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

القيم الصالحة لهذه السمة هي:
  • fpb10 – 10
  • fpb1012Pg – من 10 إلى 12 جرامًا
  • fpb13 – 13
  • fpb16 – 16
  • من fpb18 إلى 18
  • fpb79Pg – من 7 إلى 9PG
  • 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 – شرق
  • grfilmK – K
  • grfilmK12 – مرحلة التعليم من الروضة حتى الثانوي
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – ‫K-17
  • من 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 – 12A
  • 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 - الأرجنتين) للفيديو.

القيم الصالحة لهذه السمة هي:
  • 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 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 – A
  • lsfBo – BO
  • lsfD – د
  • lsfR – R
  • lsfSu – SU
  • lsfUnrated
contentDetails.contentRating.mccaaRating string
يشير هذا الحقل إلى تقييم الفيديو من "مجلس تصنيف الأفلام حسب الفئة العمرية" في مالطا.

في ما يلي القيم الصالحة لهذا الحقل:
  • mccaa12 – 12
  • mccaa12a – 12A
  • 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 – كلفن
contentDetails.contentRating.mdaRating string
يشير هذا الحقل إلى تقييم الفيديو من هيئة تطوير الوسائط (MDA) في سنغافورة، وتحديدًا من مجلس فحص الأفلام (BFC).

في ما يلي القيم الصالحة لهذا الحقل:
  • mdaG – G
  • mdaM18 – M18
  • mdaNc16 – NC16
  • mdaPg – PG
  • من mdaPg13 إلى PG13
  • من 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 Instituutti) في فنلندا.

القيم الصالحة لهذه السمة هي:
  • meku12 – 12
  • meku16 – 16
  • meku18 – 18
  • meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
تقييم الفيديو من وزارة Beni e delle Attività Culturali 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
تقييم الفيديو من وزارة الثقافة التايوانية (文化部).

في ما يلي القيم الصالحة لهذا السمة:
  • moctwG – G
  • moctwP – P
  • moctwPg – PG
  • moctwR – R
  • من moctwR12 إلى الروضة حتى 12
  • moctwR15 – R-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
التقييم الذي تمنحه جمعية الفيلم الأمريكي (MPAA) للمقاطع الدعائية للأفلام ومعاينات الأفلام.

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

القيم الصالحة لهذه السمة هي:
  • mtrcbG – G
  • mtrcbPg – PG
  • mtrcbR13 – R-13
  • mtrcbR16 – R-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 – وحدة المعالجة
  • nbcUnrated
contentDetails.contentRating.nfrcRating string
التقييم الذي منحه مركز الأفلام الوطني البلغاري للفيديو.

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

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

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

في ما يلي القيم الصالحة لهذه السمة:
  • oflcG – غ
  • oflcM – M
  • oflcPg – PG
  • من oflcR13 إلى 13 ثانية
  • oflcR15 – R15
  • oflcR16 – R16
  • بين 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 – بايت
  • resorteviolenciaC – C
  • resorteviolenciaD – د
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
التقييم الذي تمنحه "المديرية العامة للإذاعة والتلفزيون والسينما" (المكسيك) للفيديو.

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

القيم الصالحة لهذه السمة هي:
  • rteCh – سويسرا
  • rteGa – "إحصاءات Google"
  • rteMa – ماساتشوستس
  • 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 – الأداة 8
  • skfilmUnrated
contentDetails.contentRating.smaisRating string
يشير ذلك إلى تقييم الفيديو في آيسلندا.

في ما يلي القيم الصالحة لهذه السمة:
  • smais12 – 12
  • smais14 – 14
  • من smais16 إلى 16
  • smais18 – 18
  • smais7 – 7
  • smaisL – لتر
  • 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، لا يتم عرض قيمة السمة إلا إذا فوّض مالك القناة طلب البيانات من واجهة برمجة التطبيقات.
status.containsSyntheticMedia boolean
في طلب videos.insert أو videos.update، تسمح هذه السمة لصاحب القناة بالإفصاح عن أنّ الفيديو يتضمّن محتوًى معدّلاً أو اصطناعيًا (A/S) يبدو واقعيًا. اطّلِع على مزيد من المعلومات حول سياسات YouTube المتعلّقة بمحتوى A/S.

في ما يلي أمثلة على المحتوى الذي يتضمن إعلانات أثناء عرض الفيديو:
  • أن يظهر فيه شخص حقيقي يبدو وكأنّه يقول كلامًا لم يقله أو ينفّذ نشاطًا لم ينفّذه حقيقةً
  • يتضمّن لقطات معدَّلة لحدث أو مكان حقيقيَّين
  • يتضمّن مشهدًا يبدو حقيقيًا ولكنّه لم يحدث فعلاً
statistics object
يحتوي عنصر statistics على إحصاءات عن الفيديو.
statistics.viewCount unsigned long
تمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو.
statistics.likeCount unsigned long
يشير ذلك إلى عدد المستخدمين الذين أبدوا إعجابهم بالفيديو.
statistics.dislikeCount unsigned long
ملاحظة: تم تغيير إعدادات خصوصية السمة statistics.dislikeCount لتصبح خاصة اعتبارًا من 13 كانون الأول (ديسمبر) 2021. وهذا يعني أنّه لا يتم تضمين الموقع في استجابة واجهة برمجة التطبيقات إلا إذا تم مصادقة طلب واجهة برمجة التطبيقات من قِبل مالك الفيديو. يمكنك الاطّلاع على سجلّ النُسخ السابقة للحصول على مزيد من المعلومات.

عدد المستخدمين الذين أشاروا إلى عدم إعجابهم بالفيديو
statistics.favoriteCount unsigned long
ملاحظة: تم إيقاف هذه السمة نهائيًا. وسيتم إيقاف هذه الميزة نهائيًا اعتبارًا من 28 آب (أغسطس) 2015. يتم الآن ضبط قيمة السمة دائمًا على 0.
statistics.commentCount unsigned long
عدد التعليقات على الفيديو
paidProductPlacementDetails object
يحتوي العنصر paidProductPlacementDetails على معلومات عن موضع الإعلان المدفوع للمنتجات في الفيديو.
paidProductPlacementDetails.hasPaidProductPlacement boolean
اضبط القيمة على true إذا كان المحتوى يستخدم موضع إعلان مدفوعًا للمنتجات. وتكون القيمة التلقائية هي false.
player object
يحتوي العنصر player على معلومات يمكنك استخدامها لتشغيل الفيديو في مشغّل مضمّن.
player.embedHtml string
العلامة <iframe> التي تضمّن مشغّلاً لتشغيل الفيديو
  • إذا كان طلب واجهة برمجة التطبيقات لاسترداد المورد يحدّد قيمة للمَعلمتَين 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 على ويكيبيديا توفّر وصفًا دقيقًا لمحتوى الفيديو.
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 – تعذّرت معالجة الفيديو. راجِع ProcessingFailureReason.
  • processing – جارٍ معالجة الفيديو. اطّلِع على ProcessingProgress.
  • 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
وصف الفيديو المترجَم