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 – الإصدار 15 من Android والإصدارات الأحدث
  • 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 – أنا
  • 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 – E
  • 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 – G
  • catvPg – PG
  • catvUnrated
contentDetails.contentRating.catvfrRating string
تقييم الفيديو من "لجنة الإذاعة والتلفزيون والاتصالات الكندية" (CRTC) للبث باللغة الفرنسية في كندا لمزيد من المعلومات، يُرجى الاطّلاع على الموقع الإلكتروني للمجلس الكندي لمعايير البث.

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

في ما يلي القيم الصالحة لهذه السمة:
  • cbfcA – أ
  • cbfcS – 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 excesivamente violento
  • 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 – 18A
  • 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
التقييم الذي منحه المجلس الوطني للوسائط السمعية المرئية (CNA) في رومانيا للفيديو.

القيم الصالحة لهذه السمة هي:
  • cna12 – 12
  • cna15 – 15
  • cna18 – 18
  • cna18plus – 18+
  • cnaAp – نقطة الوصول
  • 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 – K-14
  • eefilmK16 – K-16
  • 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 – G
  • 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 – أنا
  • fcoIi – II
  • fcoIia – IIA
  • fcoIib – IIB
  • fcoIii – III
  • fcoUnrated
contentDetails.contentRating.fmocRating string
تم إيقاف هذه السمة نهائيًا اعتبارًا من 2 تشرين الثاني (نوفمبر) 2015. استخدِم السمة contentDetails.contentRating.cncRating بدلاً من ذلك.

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

القيم الصالحة لهذه السمة هي:
  • 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-9PG
  • fpbA – أ
  • fpbPg – PG
  • fpbUnrated
  • fpbX18 – X18
  • fpbXx – XX
contentDetails.contentRating.fpbRatingReasons[] list
الأسباب التي تفسّر سبب حصول الفيديو على تقييم FPB (جنوب أفريقيا)
contentDetails.contentRating.fskRating string
التقييم الذي تمنحه هيئة Freiwillige Selbstkontrolle der Filmwirtschaft (FSK - ألمانيا) للفيديو.

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

في ما يلي القيم الصالحة لهذه السمة:
  • grfilmE – E
  • grfilmK – كلفن
  • grfilmK12 – التعليم ما قبل الجامعي
  • grfilmK13 – K-13
  • grfilmK15 – K-15
  • grfilmK17 – ‫K-17
  • grfilmK18 – K-18
  • 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 – أ
  • lsfBo – بوركينا فاسو
  • 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 – أ
  • 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 – R21
  • 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 – R-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 – 12A
  • 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 – G
  • oflcM – M
  • oflcPg – PG
  • oflcR13 – R13
  • oflcR15 – R15
  • oflcR16 – R16
  • oflcR18 – R18
  • 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 المتعلّقة بالمحتوى الذي يتضمن محتوى جنسيًا أو عنيفًا.

في ما يلي أمثلة على المحتوى الذي يتضمن إعلانات أثناء عرض الفيديو:
  • يظهر فيه شخص حقيقي يبدو وكأنّه يقول كلامًا لم يقله أو ينفّذ نشاطًا لم ينفّذه حقيقةً
  • يتضمّن لقطات معدَّلة لحدث أو مكان حقيقيَّين
  • يتضمّن مشهدًا يبدو حقيقيًا ولكنّه لم يحدث فعلاً
statistics object
يحتوي عنصر statistics على إحصاءات عن الفيديو.
statistics.viewCount unsigned long

تمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو.

اعتبارًا من 31 مارس 2025، سيعرض مقياس viewCount عدد مرّات بدء تشغيل فيديو Shorts أو إعادة تشغيله، بدون فرض حدّ أدنى لوقت المشاهدة.

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 في عرض مجموعة صغيرة من معرّفات المواضيع المنظَّمة.

المواضيع
مواضيع الموسيقى
/m/04rlf الموسيقى (الموضوع الرئيسي)
/m/02mscn موسيقى مسيحية
/m/0ggq0m موسيقى كلاسيكية
/m/01lyv البلد
/m/02lkt موسيقى إلكترونية
/m/0glt670 موسيقى الهيب هوب
/m/05rwpb موسيقى مستقلة
/m/03_d0 موسيقى جاز
/m/028sqc موسيقى آسيوية
/m/0g293 موسيقى أمريكا اللاتينية
/m/064t9 موسيقى بوب
/m/06cqb ريغي
/m/06j6l ريذم أند بلوز
/m/06by7 موسيقى روك
/m/0gywn موسيقى السول
مواضيع الألعاب
/m/0bzvm2 ألعاب الفيديو (الموضوع الرئيسي)
/m/025zzc لعبة حركة
/m/02ntfj لعبة مغامرات وحركة
/m/0b1vjn لعبة بسيطة
/m/02hygl لعبة فيديو موسيقية
/m/04q1x3q لعبة فيديو من فئة الألغاز
/m/01sjng لعبة فيديو حول السباقات
/m/0403l3g لعبة فيديو من فئة تقمّص الأدوار
/m/021bp2 لعبة فيديو تحاكي الواقع
/m/022dc6 لعبة رياضية
/m/03hf_rm لعبة فيديو استراتيجية
مواضيع الرياضة
/m/06ntj الرياضة (الموضوع الرئيسي)
/m/0jm_ كرة القدم الأمريكية
/m/018jz بيسبول
/m/018w8 كرة سلة
/m/01cgz ملاكمة
/m/09xp_ كريكيت
/m/02vx4 كرة قدم
/m/037hz غولف
/m/03tmr مباراة هوكي الجليد
/m/01h7lh فنون قتالية مختلطة
/m/0410tth رياضة سباق السيارات
/m/07bs0 تنس
/m/07_53 كرة طائرة
مواضيع الترفيه
/m/02jjt الترفيه (الموضوع الرئيسي)
/m/09kqc طرائف
/m/02vxn أفلام
/m/05qjc فنون مسرحية
/m/066wd مصارعة المحترفين
/m/0f2f9 برامج تلفزيونية
مواضيع نمط الحياة
/m/019_rr أسلوب الحياة (الموضوع الرئيسي)
/m/032tl الموضة
/m/027x7n لياقة بدنية
/m/02wbm طعام
/m/03glg الهواية
/m/068hy حيوانات أليفة
/m/041xxh الجاذبية الجسدية [جمال]
/m/07c1v تكنولوجيا
/m/07bxq سياحة
/m/07yv9 مركبات
مواضيع المجتمع
/m/098wr المجتمع (الموضوع الرئيسي)
/m/09s1f النشاط التجاري
/m/0kt51 صحة
/m/01h6rj عسكرية
/m/05qt0 السياسة
/m/06bvp دين
مواضيع أخرى
/m/01k8wb قاعدة المعرفة
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
وصف الفيديو المترجَم