Videos

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

الطُرق

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

getRating
تستردّ هذه الطريقة التقييمات التي منحها المستخدم المصرَّح له لقائمة من الفيديوهات المحدّدة. التجربة الآن
list
تعرض هذه الطريقة قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
batchGetStats
تسترد هذه الطريقة قائمة بإحصاءات الفيديوهات التي تتطابق مع معلَمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
insert
تحميل فيديو إلى YouTube وضبط بياناته الوصفية اختياريًا
تعديل
تعديل البيانات الوصفية للفيديو التجربة الآن
حذف
تحذف هذه الأداة فيديو على YouTube. التجربة الآن
rate
تتيح هذه الطريقة إضافة تقييم إيجابي أو سلبي إلى فيديو أو إزالة تقييم من فيديو. التجربة الآن
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
  },
  "brandPartner": {
    "channelId": string,
    "channelHandle": 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 الصالحة باستثناء < و>.

يمكنك إنشاء فصول الفيديو من خلال تضمين طوابع زمنية منسَّقة (مثلاً، 00:00) في نص الوصف.
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 بكسل.
  • ‫fhd: نسخة الصورة المصغّرة بدقة فائقة (1080p) يتوفّر حجم الصورة هذا لبعض الفيديوهات. يبلغ عرض هذه الصورة 1920 بكسل وارتفاعها 1080 بكسل.
  • ‫qhd: نسخة من الصورة المصغّرة بدقة Quad High Definition ‏(1440p / 2K) يتوفّر حجم الصورة هذا لبعض الفيديوهات. يبلغ عرض هذه الصورة 2560 بكسل وارتفاعها 1440 بكسل.
  • ‫uhd: نسخة من الصورة المصغّرة بدقة فائقة (4K) يتوفّر حجم الصورة هذا لبعض الفيديوهات. يبلغ عرض هذه الصورة 3840 بكسل وارتفاعها 2160 بكسل.
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 – A
  • 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 – 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 – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • ‫cbfcUA – U/A
  • ‫cbfcUA7plus – U/A
  • ‫cbfcUA13plus – U/A
  • ‫cbfcUA16plus – U/A
contentDetails.contentRating.cccRating string
تقييم الفيديو وفقًا لمجلس Consejo de Calificación 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
تقييم الفيديو من Commission de Contrôle des Films (بلجيكا).

القيم الصالحة لهذه السمة هي:
  • cicfE – E
  • cicfKntEna – KNT/ENA
  • ‫cicfKtEa – KT/EA
  • cicfUnrated
contentDetails.contentRating.cnaRating string
تقييم الفيديو من المجلس الوطني السمعي البصري (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
تقييم الفيديو من المجلس الأعلى للسمعيات والبصريات في فرنسا (Conseil supérieur de l'audiovisuel) الذي يقيّم المحتوى الذي يتم بثه

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

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

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

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

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

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

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

القيم الصالحة لهذه السمة هي:
  • ‫eirinG – G
  • eirinPg12 – PG-12
  • eirinR15plus – R15+‎
  • 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 – 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-12PG
  • 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 – E
  • ‫grfilmK – K
  • 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) في الأرجنتين.

القيم الصالحة لهذه السمة هي:
  • ‫incaaAtp: ATP (Apta para todo publico)
  • ‫incaaC – X (للكبار فقط، يُسمح بعرضها بشروط)
  • incaaSam13 – 13 (Solo apta para mayores de 13 años)
  • incaaSam16 – 16 (Solo apta para mayores de 16 años)
  • incaaSam18 – 18 (مناسب للبالغين من العمر 18 عامًا أو أكثر فقط)
  • incaaUnrated
contentDetails.contentRating.kfcbRating string
تقييم الفيديو من "مجلس تصنيف الأفلام في كينيا"

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

القيم الصالحة لهذه السمة هي:
  • kijkwijzer12 – 12
  • kijkwijzer14 – 14
  • kijkwijzer16 – 16
  • ‫kijkwijzer18 – 18
  • kijkwijzer6 – 6
  • kijkwijzer9 – 9
  • kijkwijzerAl – ألبانيا
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
يشير إلى تقييم الفيديو الصادر عن "مجلس تقييم الوسائط في كوريا" (영상물등급위원회). يقيّم مجلس KMRB الفيديوهات في كوريا الجنوبية.

القيم الصالحة لهذه السمة هي:
  • ‫kmrb12plus: مناسب للمشاهدين بعمر 12 عامًا أو أكثر
  • ‫kmrb15plus: مناسب للمشاهدين بعمر 15 عامًا أو أكثر
  • kmrbAll – 전체관람가
  • ‫kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
تقييم الفيديو من مجلس الرقابة على الأفلام في إندونيسيا (Lembaga Sensor Film).

في ما يلي القيم الصالحة لهذه السمة:
  • lsf13 – 13
  • ‫lsf17 – 17
  • lsf21 – 21
  • ‫lsfA – A
  • lsfBo – بوليفيا
  • lsfD – D
  • 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 – K
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 – A
  • medietilsynetUnrated
contentDetails.contentRating.mekuRating string
تقييم الفيديو من المعهد الوطني السمعي البصري في فنلندا (Kansallinen Audiovisuaalinen Instituutti).

القيم الصالحة لهذه السمة هي:
  • meku12 – 12
  • meku16 – 16
  • ‫meku18 – 18
  • ‫meku7 – 7
  • mekuS – S
  • mekuUnrated
contentDetails.contentRating.mibacRating string
تقييم الفيديو من وزارة التراث الثقافي والأنشطة والسياحة (إيطاليا).

القيم الصالحة لهذه السمة هي:
  • 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
تقييم الفيديو وفقًا لجمعية الفيلم الأمريكي (MPAA).

القيم الصالحة لهذه السمة هي:
  • ‫mpaaG – G
  • mpaaNc17 – NC-17
  • mpaaPg – PG
  • ‫mpaaPg13: PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
تقييم جمعية الفيلم الأمريكي (MPAA) للمقاطع الدعائية للأفلام والمعاينات

القيم الصالحة لهذه السمة هي:
  • ‫mpaatGb – GB (الشريط الأخضر - معتمَد لجميع الجماهير)
  • ‫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 – A
  • ‫nfrcB – ب
  • nfrcC – C
  • nfrcD – D
  • nfrcUnrated
  • nfrcX – X
contentDetails.contentRating.nfvcbRating string
تقييم الفيديو من المجلس الوطني للرقابة على الأفلام والفيديو في نيجيريا.

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

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

القيم الصالحة لهذه السمة هي:
  • ‫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 – A
  • ‫resorteviolenciaB – ب
  • resorteviolenciaC – C
  • resorteviolenciaD – D
  • resorteviolenciaE – E
  • resorteviolenciaUnrated
contentDetails.contentRating.rtcRating string
تقييم الفيديو الصادر عن المديرية العامة للإذاعة والتلفزيون والسينما (المكسيك).

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

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

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

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

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

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

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

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

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

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

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

في ما يلي القيم الصالحة لهذه السمة:
  • claim
  • copyright
  • duplicate
  • inappropriate
  • legal
  • length
  • termsOfUse
  • trademark
  • uploaderAccountClosed
  • uploaderAccountSuspended
status.privacyStatus string
حالة خصوصية الفيديو في طلب videos.insert، إذا لم تحدّد قيمة لهذه السمة، يتم ضبط حالة خصوصية الفيديو الذي تم تحميله تلقائيًا على public. قد يتم ضبط بعض عمليات التحميل تلقائيًا على private استنادًا إلى إعدادات حساب صانع المحتوى، كما هو موضّح في مركز مساعدة YouTube. لا تقتصر الفيديوهات التي يتم تحميلها من مشاريع واجهة برمجة تطبيقات لم يتم التحقق منها على وضع العرض الخاص.

القيم الصالحة لهذه السمة هي:
  • private
  • public
  • unlisted
status.publishAt datetime
تاريخ ووقت نشر الفيديو المحدّدَين ويمكن ضبطه فقط إذا كانت حالة خصوصية الفيديو "خاص". يتم تحديد القيمة بتنسيق ISO 8601. يُرجى ملاحظة النقطتَين الإضافيتَين التاليتَين حول سلوك هذه السمة:
  • إذا ضبطت قيمة هذه السمة عند استدعاء الطريقة videos.update، يجب أيضًا ضبط قيمة السمة status.privacyStatus على private حتى إذا كان الفيديو خاصًا.
  • لا يمكن ضبط هذه السمة إلا إذا كانت حالة خصوصية الفيديو هي 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 المتعلقة بالمحتوى المخصّص للبالغين

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

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

بالنسبة إلى جميع تنسيقات الفيديوهات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts)، يحتسب viewCount المشاهدات عند بدء تشغيل الفيديو (بما في ذلك التشغيل التلقائي، وتمرير المؤشر فوق الفيديو، والنقر لتشغيله).

بالنسبة إلى جميع تنسيقات الفيديوهات (الفيديوهات الطويلة وأحداث البث المباشر وفيديوهات Shorts)، يتضمّن مقياس viewCount المشاهدات الجماعية عندما يشاهد عدة أشخاص المحتوى معًا على شاشة تلفزيون.

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 على Wikipedia تقدّم وصفًا عامًا لمحتوى الفيديو.
recordingDetails object
يتضمّن العنصر recordingDetails معلومات حول الموقع الجغرافي والتاريخ والعنوان الذي تم فيه تسجيل الفيديو.
recordingDetails.locationDescription string
تم إيقاف هذه السمة نهائيًا اعتبارًا من 1 يونيو 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من التفاصيل.

تمثّل هذه السمة الوصف النصي للموقع الجغرافي الذي تم فيه تسجيل الفيديو.
recordingDetails.location object
تم إيقاف هذه السمة نهائيًا. وتمّ إيقاف جميع سماته الفرعية (خط العرض وخط الطول والارتفاع).

تمثّل هذه السمة معلومات الموقع الجغرافي المرتبطة بالفيديو. تحدّد قيم المواقع الفرعية الموقع الجغرافي الذي يريد مالك الفيديو ربطه بالفيديو. يمكن تعديل القيمة والبحث عنها في الفيديوهات العلنية، وقد يتم عرضها للمستخدمين في الفيديوهات العلنية.
recordingDetails.location.latitude double
تم إيقاف هذه السمة نهائيًا اعتبارًا من 1 يونيو 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من التفاصيل.

خط العرض بالدرجات
recordingDetails.location.longitude double
تم إيقاف هذه السمة نهائيًا اعتبارًا من 1 يونيو 2017. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من التفاصيل.

خط الطول بالدرجات
recordingDetails.location.altitude double
تم إيقاف هذه السمة نهائيًا اعتبارًا من 9 يوليو 2018. يُرجى الاطّلاع على الإشعار عن الإيقاف النهائي لمزيد من التفاصيل.

الارتفاع فوق السطح الإهليلجي المرجعي، بالأمتار
recordingDetails.recordingDate datetime
تاريخ ووقت تسجيل الفيديو يتم تحديد القيمة بتنسيق ISO 8601 ‏(YYYY-MM-DDThh:mm:ss.sssZ).
fileDetails object
يتضمّن العنصر fileDetails معلومات حول ملف الفيديو الذي تم تحميله إلى YouTube، بما في ذلك درجة دقة الملف ومدته وبرامج ترميز الصوت والفيديو ومعدلات نقل البيانات في البث وغير ذلك. ويمكن لمالك الفيديو فقط استرداد هذه البيانات.

لن يتم عرض العنصر fileDetails إلا إذا كانت قيمة السمة processingDetails.fileAvailability هي available.
fileDetails.fileName string
اسم الملف الذي تم تحميله يظهر هذا الحقل سواء تم تحميل ملف فيديو أو نوع آخر من الملفات.
fileDetails.fileSize unsigned long
حجم الملف الذي تم تحميله بالبايت يظهر هذا الحقل سواء تم تحميل ملف فيديو أو نوع آخر من الملفات.
fileDetails.fileType string
نوع الملف الذي تم تحميله كما رصده محرّك معالجة الفيديوهات في YouTube في الوقت الحالي، يعالج YouTube ملفات الفيديو فقط، ولكن هذا الحقل يظهر سواء تم تحميل ملف فيديو أو نوع آخر من الملفات.

القيم الصالحة لهذه السمة هي:
  • ‫archive: الملف هو ملف أرشيف، مثل أرشيف ‎ .zip.
  • audio: الملف هو نوع ملف صوتي معروف، مثل ملف ‎ .mp3.
  • document: الملف عبارة عن مستند أو ملف نصي، مثل مستند MS Word.
  • image: الملف هو ملف صورة، مثل صورة ‎ .jpeg.
  • ‫other: الملف هو نوع ملف آخر غير الفيديو.
  • project – الملف هو ملف مشروع فيديو، مثل مشروع Microsoft Windows Movie Maker، ولا يحتوي على بيانات فيديو فعلية.
  • ‫video: الملف هو نوع ملف فيديو معروف، مثل ملف ‎ .mp4.
fileDetails.container string
تنسيق حاوية ملف الفيديو الذي تم تحميله
fileDetails.videoStreams[] list
قائمة بملفات الفيديو المضمّنة في ملف الفيديو الذي تم تحميله. يحتوي كل عنصر في القائمة على بيانات وصفية تفصيلية حول بث فيديو.
fileDetails.videoStreams[].widthPixels unsigned integer
عرض محتوى الفيديو المرمّز بالبكسل يمكنك احتساب نسبة العرض إلى الارتفاع لترميز الفيديو على النحو التالي: width_pixels / height_pixels.
fileDetails.videoStreams[].heightPixels unsigned integer
ارتفاع محتوى الفيديو المرمّز بالبكسل
fileDetails.videoStreams[].frameRateFps double
عدد اللقطات في الثانية في الفيديو
fileDetails.videoStreams[].aspectRatio double
نسبة العرض إلى الارتفاع لمحتوى الفيديو، والتي تحدّد نسبة العرض إلى الارتفاع التي يجب عرض الفيديو بها.
fileDetails.videoStreams[].codec string
برنامج ترميز الفيديو الذي يستخدمه البث
fileDetails.videoStreams[].bitrateBps unsigned long
معدّل نقل البيانات في الفيديو، بوحدة البت في الثانية
fileDetails.videoStreams[].rotation string
المقدار الذي يحتاجه YouTube لتدوير محتوى المصدر الأصلي من أجل عرض الفيديو بشكل صحيح.

القيم الصالحة لهذه السمة هي:
  • ‫clockwise: يجب تدوير الفيديو بزاوية 90 درجة في اتجاه عقارب الساعة.
  • counterClockwise: يجب تدوير الفيديو بمقدار 90 درجة عكس اتجاه عقارب الساعة.
  • ‫none: لا يحتاج الفيديو إلى تدوير.
  • ‫other: يجب تدوير الفيديو بطريقة أخرى غير بسيطة.
  • ‫upsideDown: يجب تدوير الفيديو رأسًا على عقب.
fileDetails.videoStreams[].vendor string
قيمة تحدّد بشكل فريد مورّد فيديو عادةً ما تكون القيمة رمزًا للمورّد مكوّنًا من أربعة أحرف.
fileDetails.audioStreams[] list
قائمة بالبث الصوتي المضمَّن في ملف الفيديو الذي تم تحميله يحتوي كل عنصر في القائمة على بيانات وصفية تفصيلية حول بث صوتي.
fileDetails.audioStreams[].channelCount unsigned integer
عدد القنوات الصوتية التي يتضمّنها البث
fileDetails.audioStreams[].codec string
برنامج ترميز الصوت الذي يستخدمه البث
fileDetails.audioStreams[].bitrateBps unsigned long
معدل نقل البيانات في البث الصوتي، بوحدة البت في الثانية
fileDetails.audioStreams[].vendor string
قيمة تحدّد بشكل فريد مورّد فيديو عادةً ما تكون القيمة رمزًا للمورّد مكوّنًا من أربعة أحرف.
fileDetails.durationMs unsigned long
طول الفيديو الذي تم تحميله بالمللي ثانية
fileDetails.bitrateBps unsigned long
معدل نقل البيانات المجمّع (الفيديو والصوت) لملف الفيديو الذي تم تحميله، ويتم قياسه بوحدة البت في الثانية.
fileDetails.creationTime string
تاريخ ووقت إنشاء ملف الفيديو الذي تم تحميله يتم تحديد القيمة بتنسيق ISO 8601. في الوقت الحالي، تتوفّر تنسيقات ISO 8601 التالية:
  • التاريخ فقط: YYYY-MM-DD
  • الوقت البسيط: YYYY-MM-DDTHH:MM:SS
  • الوقت مع المنطقة الزمنية: YYYY-MM-DDTHH:MM:SS+HH:MM
processingDetails object
يتضمّن العنصر processingDetails معلومات حول مستوى تقدّم YouTube في معالجة ملف الفيديو الذي تم تحميله. تحدّد السمات في العنصر حالة المعالجة الحالية وتقديرًا للوقت المتبقي حتى ينتهي YouTube من معالجة الفيديو. يشير هذا الجزء أيضًا إلى ما إذا كانت أنواع مختلفة من البيانات أو المحتوى، مثل تفاصيل الملف أو الصور المصغّرة، متاحة للفيديو.

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

القيم الصالحة لهذه السمة هي:
  • ‫failed: تعذّرت معالجة الفيديو. يُرجى الاطّلاع على 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
معرّف المحادثة المباشرة النشطة حاليًا والمرتبطة بهذا الفيديو. يتم ملء هذا الحقل فقط إذا كان الفيديو عبارة عن بث مباشر يتضمّن محادثة مباشرة. بعد اكتمال البث، ستتم إزالة هذا الحقل وإغلاق المحادثة المباشرة. بالنسبة إلى أحداث البث المستمرة، لن يعود معرّف المحادثة المباشرة مرتبطًا بهذا الفيديو، بل بالفيديو الجديد الذي يتم عرضه على الصفحة المستمرة.
brandPartner object
يحتوي العنصر brandPartner على تفاصيل حول العلامة التجارية الشريكة المرتبطة بالفيديو من أجل منحها إذن الوصول إلى الفيديو بمبادرة من صانع المحتوى (CI BPA).
brandPartner.channelId string
معرّف القناة الخارجي للعلامة التجارية الشريكة يجب أن يبدأ هذا الحقل بـ "UC". يجب ضبط السمة channelId أو channelHandle عند إنشاء إذن الوصول، ولكن يتم عرض السمة channelId فقط في الردّ.
brandPartner.channelHandle string
الاسم المعرِّف لقناة العلامة التجارية الشريكة يجب أن يبدأ هذا الحقل بـ "@". يجب ضبط channelId أو channelHandle عند إنشاء إذن الوصول، ولكن يتم عرض channelId فقط في الردّ.
localizations object
يحتوي العنصر localizations على ترجمات للبيانات الوصفية للفيديو.
localizations.(key) object
لغة النص المترجَم المرتبط بقيمة المفتاح. القيمة هي سلسلة تحتوي على رمز لغة BCP-47.
localizations.(key).title string
عنوان الفيديو المترجَم
localizations.(key).description string
وصف الفيديو المترجَم