Metadata

تمثّل هذه السمة البيانات الوصفية لمادة عرض. لا تكون بعض حقول البيانات الوصفية صالحة إلا لأنواع معيّنة من مواد العرض.

تمثيل JSON 
{
  "customId": string,
  "title": string,
  "notes": string,
  "description": string,
  "genre": [
    string
  ],
  "isrc": string,
  "grid": string,
  "artist": [
    string
  ],
  "label": string,
  "upc": string,
  "album": string,
  "infoUrl": string,
  "iswc": string,
  "category": string,
  "copyrightDate": {
    object (Date)
  },
  "startYear": integer,
  "endYear": integer,
  "episodesAreUntitled": boolean,
  "keyword": [
    string
  ],
  "tmsId": string,
  "showCustomId": string,
  "showTitle": string,
  "seasonNumber": string,
  "episodeNumber": string,
  "writer": [
    string
  ],
  "actor": [
    string
  ],
  "director": [
    string
  ],
  "producer": [
    string
  ],
  "releaseDate": {
    object (Date)
  },
  "spokenLanguage": string,
  "subtitledLanguage": [
    string
  ],
  "isan": string,
  "eidr": string,
  "hfa": string,
  "ratings": [
    {
      object (Rating)
    }
  ],
  "broadcaster": [
    string
  ],
  "totalEpisodesExpected": integer,
  "contentType": string,
  "originalReleaseMedium": string
}
الحقول
customId

string

قيمة فريدة تستخدمها أنت، موفّر البيانات الوصفية، لتحديد مادة عرض. قد تكون القيمة عبارة عن معرّف فريد أنشأته لمادة العرض أو معرّف عادي، مثل رمز ISRC. يبلغ الحد الأقصى لطول القيمة 64 بايت ويمكن أن تحتوي على أحرف أبجدية رقمية أو واصلات (-) أو شرطات سفلية (_) أو نقاط (.) أو علامات "في" (@) أو شرطات مائلة للأمام (/).
title

string

تمثّل هذه السمة عنوان مادة العرض أو اسمها. يبلغ الحد الأقصى لطول القيمة 255 بايت. هذه القيمة مطلوبة لمواد العرض المدرَجة أدناه واختيارية لجميع مواد العرض الأخرى:

  • عرض مواد العرض
  • مواد عرض الحلقات المرتبطة ببرنامج تلفزيوني
  • مواد عرض الأفلام التي تظهر في فئة الأفلام على YouTube
  • التسجيلات الصوتية المضمّنة في برنامج "تغيير الصوت"
notes

string

معلومات إضافية لا يمكن ربطها مباشرةً بأي من حقول البيانات الوصفية الأخرى يبلغ الحد الأقصى لطول هذا الحقل 255 بايت.
description

string

تمثّل هذه السمة وصفًا للأصل. قد يظهر الوصف على YouTube أو في "نظام إدارة المحتوى". يبلغ الحد الأقصى لطول هذا الحقل 5000 بايت.
genre[]

string

يحدّد هذا الحقل نوعًا يمكن استخدامه لتصنيف مادة عرض. يمكن تصنيف مواد العرض في أكثر من نوع واحد، ويستخدم YouTube مجموعات مختلفة من الأنواع لتصنيف أنواع مختلفة من مواد العرض. على سبيل المثال، قد يكون Soaps نوعًا صالحًا لبرنامج تلفزيوني ولكن ليس لفيلم أو تسجيل صوتي.

  • عرض مواد العرض
  • مواد عرض الأفلام التي تظهر في فئة الأفلام على YouTube
  • التسجيلات الصوتية المضمّنة في برنامج "تغيير الصوت"
isrc

string

تمثّل هذه السمة رمز تسجيل المعايير الدولية (ISRC) لمادة عرض فيديو موسيقي أو تسجيل صوتي. لا يمكن أن تتضمن قيمة الحقل أكثر من 12 حرفًا أبجديًا رقميًا.
grid

string

تمثّل هذه السمة المعرّف العالمي للإصدار (GRID) الخاص بفيديو موسيقي أو تسجيل صوتي. لا يمكن أن تتضمن قيمة هذا الحقل أكثر من 18 حرفًا أبجديًا رقميًا.
artist[]

string

الفنّان المرتبط بمادة عرض فيديو موسيقي أو تسجيل صوتي هذا الحقل صالح فقط لمواد عرض الفيديو الموسيقي والتسجيلات الصوتية. هذه العلامة مطلوبة للتسجيلات الصوتية المضمّنة في برنامج "تغيير الصوت".
label

string

تمثّل هذه السمة شركة الإنتاج التي أصدرت مادة عرض التسجيل الصوتي. هذا الحقل صالح فقط لمواد عرض التسجيلات الصوتية ويبلغ الحد الأقصى لطوله 255 بايت.
upc

string

الرمز العالمي للمنتج (UPC) المرتبط بمادة العرض
album

string

الألبوم الذي تتضمّنه مادة عرض التسجيل الصوتي هذا الحقل صالح فقط لمواد عرض التسجيلات الصوتية ويبلغ الحد الأقصى لطوله 255 بايت.
infoUrl

string

تمثّل هذه السمة عنوان URL رسميًا مرتبطًا بمادة العرض. ويبلغ الحد الأقصى لطول هذا الحقل 1536 بايت. يُرجى عدم إرسال عنوان URL يبلغ حجمه 1537 بايت. ستكون جهودك بلا جدوى.
iswc

string

تمثّل هذه السمة الرمز المعياري الدولي للأعمال الموسيقية (ISWC) الخاص بمادة عرض مقطوعة موسيقية. يجب أن تتألف قيمة الحقل من 11 حرفًا بتنسيق حرف (T) متبوع بـ 10 أرقام.
category

string

فئة مادة العرض هذه.
copyrightDate

object (Date)

تمثّل هذه السمة تاريخ تحديد حقوق الطبع والنشر لمادة العرض هذه. *
startYear

integer (uint32 format)

تمثّل هذه السمة السنة الأولى التي تم فيها بث برنامج تلفزيوني. هذه القيمة مطلوبة ويتم استخدامها فقط لعرض مواد العرض.
endYear

integer (uint32 format)

تمثّل هذه السمة آخر سنة تم فيها بث برنامج تلفزيوني. تُستخدَم هذه القيمة فقط لعرض مواد العرض، وهي اختيارية. لا تحدّد قيمة إذا كان لا يزال يتم إنشاء حلقات جديدة من البرنامج.
episodesAreUntitled

boolean

تشير هذه القيمة إلى أنّ الحلقات المرتبطة بمادة عرض معيّنة أو بمادة عرض موسم معيّن ليس لها عنوان. يتضمّن البرنامج (أو الموسم) الذي ليس له عنوان حلقات يتم تحديدها من خلال رقم الحلقة أو تاريخها. إذا تم ضبط هذا الحقل على true، سيحسّن YouTube العنوان المعروض للحلقات المرتبطة.
keyword[]

string

قائمة تضمّ ما يصل إلى 100 كلمة رئيسية مرتبطة بمادة عرض خاصة ببرنامج تلفزيوني هذا الحقل مطلوب ويُستخدم فقط لعرض مواد العرض.
tmsId

string

معرّف TMS (نظام Tribune Media) لمادة العرض
showCustomId

string

تمثّل هذه السمة customId مادة عرض البرنامج التي يتم إقران مادة عرض الموسم أو الحلقة بها. هذه السمة مطلوبة لأصول المواسم والحلقات التي تظهر في فئة البرامج التلفزيونية على YouTube، وهي غير صالحة لأنواع الأصول الأخرى. يبلغ الحد الأقصى لطول هذا الحقل 64 بايت ويمكن أن يحتوي على أحرف أبجدية رقمية أو واصلات (-) أو شرطات سفلية (_) أو نقاط (.) أو رموز @ (@) أو خطوط مائلة للأمام (/).
showTitle

string

اسم العرض الذي يتم إقران مادة عرض الحلقة به. ملاحظة: تُستخدم هذه العلامة فقط للحلقات غير المرتبطة بمواد العرض التابعة للعرض، وتتيح لتلك المواد عرض عنوان العرض في قسم البيانات الوصفية لمادة العرض في نظام إدارة المحتوى. يبلغ الحد الأقصى لطول هذا الحقل 120 بايت.
seasonNumber

string

رقم الموسم الذي يحدّد مادة عرض الموسم، أو رقم الموسم المرتبط بمادة عرض الحلقة يبلغ الحد الأقصى لطول هذا الحقل 5 بايت.
episodeNumber

string

رقم الحلقة المرتبط بمادة عرض الحلقة هذا الحقل مطلوب ويُستخدم فقط لمواد عرض الحلقات المرتبطة بمواد عرض البرامج التلفزيونية. يبلغ الحدّ الأقصى لطولها 5 بايت.
writer[]

string

قائمة تحدّد الكتّاب المرتبطين بمادة العرض يمكنك تحديد ما يصل إلى 50 كاتبًا لمادة عرض.
actor[]

string

قائمة تحدّد الجهات الفاعلة المرتبطة بمادة العرض يمكنك تحديد ما يصل إلى 50 ممثلاً لمادة عرض.
director[]

string

قائمة تحدّد المخرجين المرتبطين بمادة العرض يمكنك تحديد ما يصل إلى 50 مخرجًا لمادة عرض.
producer[]

string

قائمة تحدّد منتجي مادة العرض يمكنك تحديد ما يصل إلى 50 منتجًا لمادة عرض.
releaseDate

object (Date)

تمثّل هذه السمة تاريخ إصدار مادة العرض بشكلٍ علني. بالنسبة إلى مواد عرض المواسم، تحدّد هذه القيمة أول تاريخ تم فيه بث الموسم. تجدر الإشارة إلى أن التواريخ السابقة للعام 1902 غير معتمدة. هذه القيمة صالحة لمواد عرض الحلقات والمواسم والأفلام والفيديوهات الموسيقية والتسجيلات الصوتية. هذا الحقل مطلوب لمواد العرض المدرَجة أدناه، واختياري في الحالات الأخرى:

  • مواد عرض الحلقات المرتبطة ببرنامج تلفزيوني
  • مواد عرض الأفلام التي تظهر في فئة الأفلام على YouTube
spokenLanguage

string

اللغة الأساسية المحكية في الفيديو. يمكن أن تكون القيمة رمز لغة مؤلفًا من حرفين بتنسيق ISO 639-1‏. لا تُستخدم هذه القيمة إلا مع مواد عرض الحلقات والأفلام، ولا تكون صالحة لأنواع مواد العرض الأخرى.
subtitledLanguage[]

string

قائمة باللغات التي يتوفر لها مسار ترجمة وشرح منفصل أو ترجمة وشرح مضمّنة تشكّل جزءًا من الفيديو. يجب أن تكون كل قيمة في القائمة رمز لغة مؤلفًا من حرفَين بتنسيق ISO 639-1. لا تُستخدم هذه القيمة إلا مع مواد عرض الحلقات والأفلام، ولا تكون صالحة لأنواع مواد العرض الأخرى.
isan

string

تمثّل هذه السمة رقم ISAN (الرقم المعياري الدولي للمواد السمعية البصرية) الخاص بمادة العرض. يتم استخدام هذه القيمة فقط مع مواد عرض الحلقات والأفلام، وهي اختيارية في كلتا الحالتين. تتضمن القيمة 26 حرفًا، بحيث تتألف من 24 حرفًا سداسيًا عشريًا لرقم ISAN إضافة إلى رمزي تدقيق، وذلك بالتنسيق التالي:

  • تشتمل الأحرف الستة عشر الأولى في قيمة العلامة على أحرف سداسية عشرية تحدد "الجذر" ومكونات "الحلقة" لمعرّف ISAN.
  • الحرف السابع عشر هو حرف التحقّق (حرف من A إلى Z).
  • تشكل الأحرف من 18 إلى 25 الأحرف الثمانية المتبقية من ISAN، والتي تحدد المكون "إصدار" من ISAN.
  • يمثل الحرف السادس والعشرون رمز تدقيق آخر (من A إلى Z).
eidr

string

معرّف Entertainment Identifier Registry ‏ (EIDR) الذي تم تعيينه لمادة عرض يتم استخدام هذه القيمة فقط مع مواد عرض الحلقات والأفلام، وهي اختيارية في كلتا الحالتين. تشتمل القيمة على بادئة قياسية لسجلّ EIDR، متبوعةً بشرطة مائلة للأمام وسلسلة سداسية عشرية مؤلّفة من 20 حرفًا، إضافةّ إلى رمز تدقيق أبجدي رقمي ‎(0-9A-Z)‎.
hfa

string

رمز الأغنية الخاصّ بمادة العرض والصادر عن وكالة Harry Fox Agency‏ (HFA) والمؤلف من 6 أحرف لتعريف المقطوعة الموسيقية بشكل فريد لا تنطبق هذه القيمة إلا على مواد عرض المقطوعات الموسيقية.
ratings[]

object (Rating)

قائمة بالتقييمات التي تلقّتها مادة العرض يجب أن يكون التقييم صالحًا بموجب نظام التقييم المحدّد.
broadcaster[]

string

تحدّد هذه السمة الشبكة أو القناة التي بثّت البرنامج أو الموسم في الأصل. يجب تضمين هذا الحقل لمادة عرض فقط إذا كان المذيع المرتبط بمادة العرض مختلفًا عن الشريك الذي يحمّل مادة العرض إلى YouTube. يُرجى العِلم أنّ البرنامج قد يتضمّن عدة جهات بث، مثلاً قد يتم تبديل الشبكات بين المواسم.
totalEpisodesExpected

integer (uint32 format)

تحدّد هذه السمة إجمالي عدد الحلقات الكاملة في الموسم. تُستخدَم هذه القيمة فقط لمواد عرض المواسم.
contentType

string

تمثّل هذه السمة نوع محتوى الفيديو الذي تمثله مادة العرض. هذا الحقل صالح فقط لمواد عرض الأفلام والحلقات، وهو مطلوب لأنواع مواد العرض التالية:

  • مواد عرض الحلقات المرتبطة ببرنامج تلفزيوني
  • مواد عرض الأفلام التي تظهر في فئة الأفلام على YouTube

القيم المقبولة هي:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

تشير هذه السمة إلى الطريقة التي أُتيحت من خلالها للمستخدمين فرصة مشاهدة مادة عرض الفيديو لأول مرة. تُستخدَم هذه القيمة فقط مع مواد عرض الحلقات والأفلام. هذا الحقل مطلوب لمواد العرض التالية، وهو اختياري في الحالات الأخرى:

  • مواد عرض الحلقات المرتبطة ببرنامج تلفزيوني
  • مواد عرض الأفلام التي تظهر في فئة الأفلام على YouTube

القيم المقبولة هي:

  • basic_tv
  • direct_to_video
  • film
  • premium_tv
  • promotional
  • terrestrial_tv
  • web

التاريخ

يحدّد هذا المرجع تاريخًا، ويتم تمثيله كأجزائه المكوّنة (السنة والشهر واليوم).

تمثيل JSON 
{
  "year": integer,
  "month": integer,
  "day": integer
}
الحقول
year

integer (uint32 format)

تمثّل هذه السمة سنة التاريخ في التقويم الغريغوري. يُفترض أن يكون التاريخ ميلاديًا
month

integer (uint32 format)

شهر التاريخ يجب أن تكون القيمة عددًا صحيحًا بين 1 و12.
day

integer (uint32 format)

يوم التاريخ يجب أن تكون القيمة عددًا صحيحًا بين 1 و31. يُرجى العِلم أنّ بعض مجموعات اليوم والشهر غير صالحة.

التقييم

يحتوي هذا العنصر على تقييم حسب الفئة العمرية لمادة عرض.

تمثيل JSON 
{
  "ratingSystem": string,
  "rating": string
}
الحقول
ratingSystem

string

تمثّل هذه السمة نظام التقييم المرتبط بالتقييم.

القيم المقبولة هي:

  • acb
  • age_gate_16
  • bbfc
  • cbfc
  • chvrs
  • djctq
  • eirin
  • esrb
  • fmoc
  • fsk
  • icaa
  • kmrb
  • lyrics
  • mpaa
  • oflc
  • russia
  • v_chip
  • youtube
  • youtubeuk
rating

string

تمثّل هذه السمة التقييم الذي حصلت عليه مادة العرض.