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 الصالحة باستثناء < و>. ملاحظة: لكي يتم عرض عناوين URL في الوصف كروابط قابلة للنقر في واجهة مستخدم YouTube، يجب أن تستوفي القناة المتطلبات على مستوى المنصة، مثل إثبات ملكية القناة أو تفعيل الميزات المتقدّمة. يمكنك إنشاء فصول الفيديو من خلال تضمين طوابع زمنية منسَّقة (مثلاً، 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 تمثّل هذه السمة تقييم الفيديو من &quot;هيئة ضمانات الاتصالات&quot; (AGCOM) في إيطاليا. القيم الصالحة لهذه السمة هي: ‫agcomT – T agcomUnrated agcomVm14 – VM14 ‫agcomVm18 – VM18
contentDetails.contentRating.anatelRating	string تقييم الفيديو وفقًا لـ Anatel (Asociación Nacional de Televisión) للتلفزيون التشيلي. القيم الصالحة لهذه السمة هي: ‫anatelA – أ anatelF – أنثى anatelI – I anatelI10 – I-10 anatelI12 – I-12 anatelI7 – I-7 anatelR – R anatelUnrated
contentDetails.contentRating.bbfcRating	string تقييم الفيديو وفقًا للمجلس البريطاني لتصنيف الأفلام (BBFC). القيم الصالحة لهذه السمة هي: bbfc12 – 12 ‫bbfc12a – 12A ‫bbfc15 – 15 ‫bbfc18 – 18 bbfcPg – PG bbfcR18 – R18 bbfcU – U bbfcUnrated
contentDetails.contentRating.bfvcRating	string تقييم الفيديو من "مجلس الرقابة على الأفلام والفيديوهات" في تايلاند القيم الصالحة لهذه السمة هي: bfvc13 – 13 bfvc15 – 15 ‫bfvc18 – 18 ‫bfvc20 – 20 ‫bfvcB – ب bfvcE – 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 تقييم الفيديو من المجلس الأعلى للسمعيات والبصريات في فرنسا، والذي يقيّم المحتوى الذي يتم بثه القيم الصالحة لهذه السمة هي: 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) و"العناوين" (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 – BN egfilmGn – غينيا egfilmUnrated
contentDetails.contentRating.eirinRating	string تمثّل هذه السمة تقييم الفيديو وفقًا لمؤسسة Eirin (映倫). ‫Eirin هو نظام التقييم الياباني. في ما يلي القيم الصالحة لهذه السمة: ‫eirinG – G ‫eirinPg12: غير مناسب للأطفال أقل من 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 – أ 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 (Solo apta para mayores de 18 años) incaaUnrated
contentDetails.contentRating.kfcbRating	string تمثّل هذه السمة تقييم الفيديو من "مجلس تصنيف الأفلام في كينيا". القيم الصالحة لهذه السمة هي: ‫kfcb16plus – 16 kfcbG – GE ‫kfcbPg – PG ‫kfcbR – 18 kfcbUnrated
contentDetails.contentRating.kijkwijzerRating	string voor de Classificatie van Audiovisuele Media (هولندا). القيم الصالحة لهذه السمة هي: ‫kijkwijzer12 – 12 ‫kijkwijzer14 – 14 ‫kijkwijzer16 – 16 ‫kijkwijzer18 – 18 kijkwijzer6 – 6 kijkwijzer9 – 9 kijkwijzerAl – ألبانيا kijkwijzerUnrated
contentDetails.contentRating.kmrbRating	‫string تمثّل هذه السمة التقييم الذي حصل عليه الفيديو من مجلس تقييم وسائل الإعلام في كوريا (영상물등급위원회). تُقيّم لجنة إدارة وتقييم الألعاب في كوريا (KMRB) الفيديوهات في كوريا الجنوبية. في ما يلي القيم الصالحة لهذه السمة: ‫kmrb12plus: مناسب للمشاهدين بعمر 12 سنة وما فوق ‫kmrb15plus: مناسب للمشاهدين بعمر 15 عامًا أو أكثر ‫kmrbAll: 전체관람가 kmrbR – 청소년 관람불가 kmrbTeenr kmrbUnrated
contentDetails.contentRating.lsfRating	string تقييم الفيديو من مجلس الرقابة على الأفلام في إندونيسيا (Lembaga Sensor Film). القيم الصالحة لهذه السمة هي: lsf13 – 13 lsf17 – 17 ‫lsf21 – 21 ‫lsfA – أ lsfBo – بوليفيا ‫lsfD – 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 – أ mccypUnrated
contentDetails.contentRating.mcstRating	‫string نظام التقييم في فيتنام - MCST في ما يلي القيم الصالحة لهذه السمة: mcst0 – 0 mcst16plus – 16+ mcstC13 – C13 ‫mcstC16 – C16 ‫mcstC18 – C18 mcstP – P mcstUnrated mcstT13 – T13 ‫mcstT16 – T16 ‫mcstT18 – T18 ‫mcstK – كلفن
contentDetails.contentRating.mdaRating	string تقييم الفيديو من "هيئة تطوير وسائل الإعلام" (MDA) في سنغافورة، وتحديدًا من "مجلس الرقابة على الأفلام" (BFC). القيم الصالحة لهذه السمة هي: mdaG – G mdaM18 – M18 mdaNc16 – NC16 mdaPg – PG ‫mdaPg13 – PG13 ‫mdaR21 – R21 mdaUnrated
contentDetails.contentRating.medietilsynetRating	string تقييم الفيديو من Medietilsynet، وهي هيئة الإعلام النرويجية. القيم الصالحة لهذه السمة هي: medietilsynet11 – 11 ‫medietilsynet12 – 12 medietilsynet15 – 15 ‫medietilsynet18 – 18 ‫medietilsynet6 – 6 ‫medietilsynet7 – 7 medietilsynet9 – 9 ‫medietilsynetA – 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 تمثّل هذه السمة تقييم جمعية الفيلم الأمريكية (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 – PU 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 – يُنصح بوجود الأهل 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 تشير هذه القيمة إلى ما إذا كان يمكن تضمين الفيديو في موقع إلكتروني آخر. ملاحظة: حتى إذا كانت إعدادات القائم بالتحميل تسمح بالتضمين، قد يتم حظر تشغيل الفيديوهات في المشغّلات المضمّنة بسبب سياسات المنصة أو مطالبات من جهات خارجية (مثل Content ID).
status.publicStatsViewable	boolean تحدّد هذه القيمة ما إذا كانت إحصاءات الفيديو الموسّعة على صفحة المشاهدة الخاصة بالفيديو متاحة للجميع. تكون هذه الإحصاءات قابلة للعرض بشكل تلقائي، وستبقى الإحصاءات مثل عدد مشاهدات الفيديو وتقييماته مرئية بشكل علني حتى إذا تم ضبط قيمة هذه السمة على false.
status.madeForKids	boolean تشير هذه القيمة إلى ما إذا كان الفيديو مصنّفًا على أنّه موجّه إلى الأطفال، وهي تتضمّن الحالة الحالية للفيديو "محتوى مخصّص للأطفال". على سبيل المثال، يمكن تحديد الحالة استنادًا إلى قيمة السمة selfDeclaredMadeForKids. يمكنك الاطّلاع على مركز مساعدة YouTube لمزيد من المعلومات حول ضبط إعدادات الجمهور لقناتك أو فيديوهاتك أو أحداث البث المباشر.
status.selfDeclaredMadeForKids	boolean في طلب videos.insert أو videos.update، تتيح هذه السمة لمالك القناة تصنيف الفيديو على أنّه مخصّص للأطفال. في طلب videos.list، لا يتم عرض قيمة السمة إلا إذا سمح مالك القناة بطلب البيانات من واجهة برمجة التطبيقات.
status.containsSyntheticMedia	boolean في طلب videos.insert أو videos.update، تتيح هذه السمة لمالك القناة الإفصاح عن أنّ الفيديو يتضمّن محتوًى معدَّلاً أو اصطناعيًا (A/S) يبدو واقعيًا. مزيد من المعلومات حول سياسات YouTube المتعلقة بالمحتوى المخصّص للبالغين أو المحتوى الحسّاس تشمل الأمثلة على محتوى A/S الفيديوهات التي: يظهر فيه شخص حقيقي يبدو وكأنّه يقول كلامًا لم يقُله أو ينفّذ نشاطًا لم ينفّذه حقيقةً يتضمّن لقطات معدَّلة لحدث أو مكان حقيقيَّين يتضمّن مشهدًا يبدو حقيقيًا ولكنّه لم يحدث فعلاً
statistics	object يحتوي العنصر statistics على إحصاءات حول الفيديو.
statistics.viewCount	unsigned long تمثّل هذه العلامة عدد المرات التي تمت فيها مشاهدة الفيديو. اعتبارًا من 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 بعرض مجموعة صغيرة من أرقام تعريف المواضيع المنسّقة. الاطّلاع على معرّفات المواضيع المتاحة اعتبارًا من 15 فبراير 2017 المواضيع مواضيع الموسيقى /m/04rlf الموسيقى (الموضوع الرئيسي) /m/02mscn موسيقى مسيحية /m/0ggq0m موسيقى كلاسيكية /m/01lyv البلد /m/02lkt موسيقى إلكترونية /m/0glt670 موسيقى الهيب هوب /m/05rwpb موسيقى مستقلة /m/03_d0 موسيقى جاز /m/028sqc موسيقى آسيا /m/0g293 موسيقى أمريكا اللاتينية /m/064t9 موسيقى بوب /m/06cqb ريغي /m/06j6l ريذم أند بلوز /m/06by7 موسيقى روك /m/0gywn موسيقى السول مواضيع الألعاب /m/0bzvm2 ألعاب الفيديو (موضوع رئيسي) /m/025zzc لعبة حركة /m/02ntfj لعبة مغامرات وحركة /m/0b1vjn لعبة بسيطة /m/02hygl لعبة فيديو موسيقية /m/04q1x3q لعبة فيديو من فئة الألغاز /m/01sjng لعبة فيديو للسباقات /m/0403l3g لعبة فيديو من فئة تقمّص الأدوار /m/021bp2 لعبة فيديو محاكاة /m/022dc6 لعبة رياضية /m/03hf_rm لعبة فيديو استراتيجية مواضيع رياضية /m/06ntj الرياضة (موضوع رئيسي) /m/0jm_ كرة القدم الأمريكية /m/018jz بيسبول /m/018w8 كرة سلة /m/01cgz ملاكمة /m/09xp_ Cricket /m/02vx4 كرة القدم /m/037hz غولف /m/03tmr مباراة هوكي الجليد /m/01h7lh فنون قتالية مختلطة /m/0410tth رياضة سباق السيارات /m/07bs0 تنس /m/07_53 كرة طائرة مواضيع الترفيه /m/02jjt الترفيه (موضوع رئيسي) /m/09kqc طرائف /m/02vxn أفلام /m/05qjc فنون مسرحية /m/066wd مصارعة محترفة /m/0f2f9 برامج تلفزيونية مواضيع عن أسلوب الحياة /m/019_rr أسلوب الحياة (الموضوع الرئيسي) /m/032tl موضة /m/027x7n لياقة بدنية /m/02wbm طعام /m/03glg الهواية /m/068hy حيوانات أليفة /m/041xxh الجاذبية الجسدية [الجمال] /m/07c1v تكنولوجيا /m/07bxq سياحة /m/07yv9 المركبات مواضيع عن المجتمع /m/098wr المجتمع (موضوع رئيسي) /m/09s1f المؤسسات /m/0kt51 صحة /m/01h6rj عسكرية /m/05qt0 سياسة /m/06bvp دين مواضيع أخرى /m/01k8wb المعرفة
topicDetails.topicCategories[]	list قائمة بعناوين URL على 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 وصف الفيديو المترجَم