Videos

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

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

الطُرق

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

getRating
يستردّ هذا الطلب التقييمات التي قدّمها المستخدم المعتمَد لقائمة من الفيديوهات المحدّدة. التجربة الآن
list
تعرض هذه الطريقة قائمة بالفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
batchGetStats
تعرض هذه الطريقة قائمة بإحصاءات الفيديوهات التي تتطابق مع مَعلمات طلب البيانات من واجهة برمجة التطبيقات. التجربة الآن
إدراج
تحميل فيديو إلى 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
تمثّل هذه السمة تقييم الفيديو من "هيئة ضمانات الاتصالات" (AGCOM) في إيطاليا.

تشمل القيم الصالحة لهذه السمة ما يلي:
  • agcomT – T
  • agcomUnrated
  • agcomVm14 – VM14
  • agcomVm18 – VM18
contentDetails.contentRating.anatelRating string
تمثّل هذه السمة تقييم Anatel (الرابطة الوطنية للتلفزيون) للبرامج التلفزيونية في تشيلي.

القيم الصالحة لهذه السمة هي:
  • anatelA – A
  • anatelF – F
  • 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
تمثّل هذه السمة تقييم &quot;المجلس المركزي لاعتماد الأفلام&quot; (CBFC) في الهند للفيديو.

القيم الصالحة لهذه السمة هي:
  • cbfcA – A
  • cbfcS – S
  • cbfcU – U
  • cbfcUnrated
  • cbfcUA – غير متوفر
  • cbfcUA7plus – غير متوفر
  • cbfcUA13plus – غير متوفر
  • cbfcUA16plus – غير متوفر
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 – AP
  • cnaUnrated
contentDetails.contentRating.cncRating string
نظام التقييم في فرنسا - Commission de classification cinematographique

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

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

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

في ما يلي القيم الصالحة لهذه السمة:
  • czfilm12 – 12
  • czfilm14 – 14
  • czfilm18 – 18
  • czfilmU – U
  • czfilmUnrated
contentDetails.contentRating.djctqRating string
تمثّل هذه السمة تقييم الفيديو وفقًا لتصنيف "دائرة العدل والتصنيف والتأهيل والألقاب" (DJCQT) في البرازيل.

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

القيم الصالحة لهذه السمة هي:
  • ecbmct13a – 13 أمبير
  • ecbmct13plus – 13 عامًا فأكثر
  • ecbmct15a – 15 أمبير
  • ecbmct15plus – 15 عامًا فأكثر
  • ecbmct18plus – 18 عامًا فأكثر
  • ecbmct7a – 7 أمبير
  • 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 – L
  • eefilmMs12 – MS-12
  • eefilmMs6 – MS-6
  • eefilmPere – Pere
  • eefilmUnrated
contentDetails.contentRating.egfilmRating string
تمثّل هذه السمة تقييم الفيديو في مصر.

القيم الصالحة لهذه السمة هي:
  • egfilm18 – 18
  • egfilmBn – BN
  • egfilmGn – GN
  • egfilmUnrated
contentDetails.contentRating.eirinRating string
تمثّل هذه السمة تقييم الفيديو وفقًا لمؤسسة "إيرين" (映倫). 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 – أنا
  • 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
تمثّل هذه السمة تقييم الفيديو وفقًا لمعهد السينما والفنون السمعية البصرية (ICAA) في إسبانيا.

القيم الصالحة لهذه السمة هي:
  • icaa12 – 12
  • icaa13 – 13
  • icaa16 – 16
  • icaa18 – 18
  • icaa7 – 7
  • icaaApta – APTA
  • icaaUnrated
  • icaaX – X
contentDetails.contentRating.ifcoRating string
تشير هذه السمة إلى تقييم الفيديو وفقًا لمكتب تصنيف الأفلام الأيرلندية (IFCO - Ireland). يمكنك الاطّلاع على مزيد من المعلومات على الموقع الإلكتروني 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 (محتوى غير مناسب لمن هم دون الـ 18 عامًا، ويُعرض بشروط)
  • 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 – AL
  • kijkwijzerUnrated
contentDetails.contentRating.kmrbRating string
تمثّل هذه السمة تقييم الفيديو وفقًا لمجلس تقييم الوسائط الكوري (영상물등급위원회). تُقيّم لجنة إدارة وتقييم الألعاب والفيديوهات في كوريا (KMRB) الفيديوهات في كوريا الجنوبية.

في ما يلي القيم الصالحة لهذه السمة:
  • kmrb12plus – 12세 이상 관람가
  • kmrb15plus – 15세 이상 관람가
  • kmrbAll – 전체관람가
  • kmrbR – 청소년 관람불가
  • kmrbTeenr
  • kmrbUnrated
contentDetails.contentRating.lsfRating string
تمثّل هذه السمة التقييم الذي حصل عليه الفيديو من "هيئة الرقابة على الأفلام" في إندونيسيا.

القيم الصالحة لهذه السمة هي:
  • lsf13 – 13
  • lsf17 – 17
  • lsf21 – 21
  • lsfA – A
  • lsfBo – BO
  • 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
تمثّل هذه السمة تقييم وزارة الثقافة (كولومبيا) للفيديو.

في ما يلي القيم الصالحة لهذه السمة:
  • 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 – PG-13
  • mpaaR – R
  • mpaaUnrated
contentDetails.contentRating.mpaatRating string
تمثّل هذه السمة تصنيف جمعية الفيلم الأمريكية للمقاطع الدعائية للأفلام ومعاينتها.

القيم الصالحة لهذه السمة هي:
  • mpaatGb – GB (النطاق الأخضر - مناسب لجميع الفئات العمرية)
  • mpaatRb – RB (Red Band - يُنصح به لمن هم في عمر 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 – PT
  • 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
تعرض هذه السمة حالة خصوصية الفيديو.

في ما يلي القيم الصالحة لهذه السمة:
  • 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 المتعلقة بالمحتوى المخصّص للبالغين أو المحتوى الحساس

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

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

اعتبارًا من 24 أغسطس 2026، سيتم تعديل 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 بعرض مجموعة صغيرة من أرقام تعريف المواضيع المنسّقة.

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 عن أعداد المشاهدين المتزامنين المعالَجة والمفلترة من الرسائل غير المرغوب فيها والمتاحة من خلال &quot;إحصاءات YouTube&quot;. يمكنك الاطّلاع على مزيد من المعلومات حول مقاييس البث المباشر في مركز مساعدة 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
تمثّل هذه السمة وصف الفيديو المترجَم.