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. این مقدار حداکثر ۶۴ بایت طول دارد و می‌تواند شامل کاراکترهای الفبایی-عددی، خط فاصله ( - )، زیرخط ( _ )، نقطه ( . )، نمادهای "at" ( @ ) یا اسلش ( / ) باشد.

title

string

عنوان یا نام دارایی. این مقدار حداکثر ۲۵۵ بایت طول دارد. این مقدار برای دارایی‌های فهرست‌شده در زیر الزامی و برای سایر دارایی‌ها اختیاری است:

  • نمایش دارایی‌ها
  • دارایی‌های قسمتی که به یک نمایش مرتبط هستند
  • فایل‌های فیلمی که در دسته‌بندی فیلم‌های یوتیوب نمایش داده می‌شوند
  • ضبط صدا در برنامه AudioSwap گنجانده شده است
notes

string

اطلاعات اضافی که مستقیماً به یکی از فیلدهای فراداده دیگر نگاشت نمی‌شود. این فیلد حداکثر ۲۵۵ بایت طول دارد.

description

string

شرحی از دارایی. این شرح ممکن است در یوتیوب یا در CMS نمایش داده شود. حداکثر طول این فیلد ۵۰۰۰ بایت است.

genre[]

string

این فیلد ژانری را مشخص می‌کند که می‌تواند برای دسته‌بندی یک محتوا استفاده شود. محتواها ممکن است در بیش از یک ژانر دسته‌بندی شوند و یوتیوب از مجموعه‌های مختلفی از ژانرها برای دسته‌بندی انواع مختلف محتوا استفاده می‌کند. برای مثال، Soaps ممکن است ژانر معتبری برای یک نمایش باشد اما برای یک فیلم یا ضبط صدا مناسب نباشد.

  • نمایش دارایی‌ها
  • فایل‌های فیلمی که در دسته‌بندی فیلم‌های یوتیوب نمایش داده می‌شوند
  • ضبط صدا در برنامه AudioSwap گنجانده شده است
isrc

string

ISRC (کد استاندارد بین‌المللی ضبط) یک فایل موسیقی ویدیو یا ضبط صدا. مقدار این فیلد باید دقیقاً شامل ۱۲ کاراکتر الفبایی-عددی باشد.

grid

string

GRID (شناسه انتشار جهانی) یک موزیک ویدیو یا ضبط صدا. مقدار این فیلد باید دقیقاً شامل ۱۸ کاراکتر الفبایی-عددی باشد.

artist[]

string

هنرمندی که با یک موزیک ویدیو یا فایل ضبط صدا مرتبط است. این فیلد فقط برای موزیک ویدیو و فایل ضبط صدا معتبر است. برای فایل‌های ضبط صدای موجود در برنامه AudioSwap الزامی است.

label

string

ناشری که یک اثر ضبط صدا را منتشر کرده است. این فیلد فقط برای آثار ضبط صدا معتبر است و حداکثر طول آن ۲۵۵ بایت است.

upc

string

UPC (کد جهانی محصول) مرتبط با دارایی.

album

string

آلبومی که یک فایل صوتی در آن قرار دارد. این فیلد فقط برای فایل‌های صوتی معتبر است و حداکثر طول آن ۲۵۵ بایت است.

infoUrl

string

یک URL رسمی مرتبط با دارایی. حداکثر طول این فیلد ۱۵۳۶ بایت است. لطفاً URL با طول ۱۵۳۷ بایت ارسال نکنید. تلاش‌های شما بی‌فایده خواهد بود.

iswc

string

ISWC (کد استاندارد بین‌المللی آثار موسیقی) برای یک اثر آهنگسازی. مقدار این فیلد باید دقیقاً شامل ۱۱ کاراکتر در قالب یک حرف (T) و به دنبال آن ۱۰ رقم باشد.

category

string

دسته بندی این دارایی.

copyrightDate

object ( Date )

تاریخ ایجاد حق نشر برای این اثر. *

startYear

integer ( uint32 format)

اولین سالی که یک برنامه تلویزیونی پخش شد. این مقدار برای دارایی‌های برنامه الزامی است و فقط برای آنها استفاده می‌شود.

endYear

integer ( uint32 format)

آخرین سالی که یک برنامه تلویزیونی پخش شده است. این مقدار فقط برای دارایی‌های برنامه تلویزیونی استفاده می‌شود که برای آنها اختیاری است. اگر قسمت‌های جدید برنامه تلویزیونی هنوز در حال ساخت هستند، مقداری مشخص نکنید.

episodesAreUntitled

boolean

این مقدار نشان می‌دهد که قسمت‌های مرتبط با یک محتوای نمایشی خاص یا یک محتوای فصلی خاص، بدون عنوان هستند. یک نمایش (یا فصل) بدون عنوان دارای قسمت‌هایی است که با شماره یا تاریخ قسمتشان مشخص می‌شوند. اگر این فیلد روی true تنظیم شود، یوتیوب عنوان نمایش داده شده برای قسمت‌های مرتبط را بهینه می‌کند.

keyword[]

string

فهرستی از حداکثر ۱۰۰ کلمه کلیدی مرتبط با یک محتوای نمایشی. این فیلد برای محتوای نمایشی الزامی است و فقط برای آن استفاده می‌شود.

tmsId

string

شناسه TMS (Tribune Media Systems) برای دارایی.

showCustomId

string

شناسه customId محتوای نمایشی که یک محتوای فصل یا قسمت به آن مرتبط است. این شناسه برای محتوای فصل و قسمتی که در دسته‌بندی نمایش‌ها در یوتیوب نمایش داده می‌شوند، الزامی است و برای سایر انواع محتوا معتبر نیست. این فیلد حداکثر ۶۴ بایت طول دارد و می‌تواند شامل کاراکترهای الفبایی-عددی، خط فاصله ( - )، زیرخط ( _ )، نقطه ( . )، نمادهای "at" ( @ ) یا اسلش ( / ) باشد.

showTitle

string

نام نمایشی که یک محتوای اپیزود با آن مرتبط است. توجه: این برچسب فقط برای اپیزودهایی استفاده می‌شود و معتبر است که با محتوای نمایش مرتبط نیستند و به آن محتواها اجازه می‌دهد تا همچنان عنوان نمایش را در بخش فراداده‌ی محتوا در CMS نمایش دهند. حداکثر طول این فیلد ۱۲۰ بایت است.

seasonNumber

string

شماره فصلی که یک ویژگی فصلی را مشخص می‌کند، یا شماره فصلی که با یک ویژگی اپیزود مرتبط است. این فیلد حداکثر ۵ بایت طول دارد.

episodeNumber

string

شماره اپیزود مرتبط با یک محتوای اپیزود. این فیلد فقط برای محتوای اپیزودهایی که به محتوای نمایش لینک شده‌اند، استفاده می‌شود و الزامی است. حداکثر طول آن ۵ بایت است.

writer[]

string

فهرستی که نویسندگان مرتبط با دارایی را مشخص می‌کند. می‌توانید تا ۵۰ نویسنده برای یک دارایی مشخص کنید.

actor[]

string

فهرستی که بازیگران مرتبط با دارایی را مشخص می‌کند. می‌توانید تا ۵۰ بازیگر را برای یک دارایی مشخص کنید.

director[]

string

فهرستی که مدیران مرتبط با دارایی را مشخص می‌کند. می‌توانید تا ۵۰ مدیر برای یک دارایی مشخص کنید.

producer[]

string

فهرستی که تولیدکنندگان دارایی را مشخص می‌کند. می‌توانید تا ۵۰ تولیدکننده برای یک دارایی مشخص کنید.

releaseDate

object ( Date )

تاریخی که یک محتوا به صورت عمومی منتشر شده است. برای محتواهای فصلی، این مقدار اولین تاریخی را که آن فصل پخش شده است مشخص می‌کند. تاریخ‌های قبل از سال ۱۹۰۲ پشتیبانی نمی‌شوند. این مقدار برای محتواهای قسمت، فصل، فیلم، موزیک ویدیو و ضبط صدا معتبر است. این مقدار برای محتواهای ذکر شده در زیر الزامی و در غیر این صورت اختیاری است:

  • دارایی‌های قسمتی که به یک نمایش مرتبط هستند
  • فایل‌های فیلمی که در دسته‌بندی فیلم‌های یوتیوب نمایش داده می‌شوند
spokenLanguage

string

زبان گفتاری اصلی ویدیو. مقدار می‌تواند هر کد زبان دو حرفی ISO 639-1 باشد. این مقدار فقط برای فایل‌های قسمت و فیلم استفاده می‌شود و برای انواع دیگر فایل‌ها معتبر نیست.

subtitledLanguage[]

string

فهرستی از زبان‌هایی که ویدیو برای آنها یا زیرنویس جداگانه دارد یا زیرنویس‌های داخلی که بخشی از ویدیو هستند. هر مقدار در لیست باید یک کد زبان دو حرفی ISO 639-1 باشد. این مقدار فقط برای فایل‌های قسمت و فیلم استفاده می‌شود و برای انواع دیگر فایل‌ها معتبر نیست.

isan

string

ISAN (شماره استاندارد بین‌المللی سمعی و بصری) برای دارایی. این مقدار فقط برای دارایی‌های قسمت و فیلم استفاده می‌شود و در هر دو مورد اختیاری است. این مقدار شامل ۲۶ کاراکتر است که شامل ۲۴ کاراکتر هگزادسیمال ISAN و همچنین دو کاراکتر کنترلی به فرمت زیر است:

  • ۱۶ کاراکتر اول در مقدار برچسب حاوی کاراکترهای هگزادسیمال هستند که اجزای «ریشه» و «قسمت» ISAN را مشخص می‌کنند.
  • هفدهمین کاراکتر، یک کاراکتر کنترلی (حرفی از AZ) است.
  • کاراکترهای ۱۸ تا ۲۵ هشت کاراکتر باقی‌مانده‌ی ISAN هستند که مؤلفه‌ی «نسخه» ISAN را مشخص می‌کنند.
  • بیست و ششمین کاراکتر، یک کاراکتر بررسی دیگر (AZ) است.
eidr

string

رجیستری شناسه سرگرمی (EIDR) که به یک دارایی اختصاص داده شده است. این مقدار فقط برای دارایی‌های قسمت و فیلم استفاده می‌شود و در هر دو مورد اختیاری است. این مقدار شامل یک پیشوند استاندارد برای رجیستری EIDR است که به دنبال آن یک اسلش، یک رشته هگزادسیمال 20 کاراکتری و یک کاراکتر کنترلی الفبایی-عددی (0-9A-Z) می‌آید.

hfa

string

کد آهنگ شش کاراکتری آژانس هری فاکس (HFA) که برای شناسایی منحصر به فرد یک قطعه موسیقی صادر شده است. این مقدار فقط برای فایل‌های آهنگ معتبر است.

ratings[]

object ( Rating )

فهرستی از رتبه‌بندی‌هایی که یک دارایی دریافت کرده است. این رتبه‌بندی باید تحت سیستم رتبه‌بندی مشخص‌شده معتبر باشد.

broadcaster[]

string

شبکه یا کانالی را که در ابتدا یک نمایش یا فصلی از یک نمایش را پخش کرده است، مشخص می‌کند. این فیلد فقط باید برای یک محتوا در نظر گرفته شود اگر پخش‌کننده مرتبط با آن محتوا با شریکی که آن را در یوتیوب آپلود می‌کند متفاوت باشد. توجه داشته باشید که یک نمایش ممکن است چندین پخش‌کننده داشته باشد؛ برای مثال، یک نمایش ممکن است بین فصل‌ها شبکه‌ها را تغییر دهد.

totalEpisodesExpected

integer ( uint32 format)

تعداد کل قسمت‌های کامل در فصل را مشخص می‌کند. این مقدار فقط برای فایل‌های فصل استفاده می‌شود.

contentType

string

نوع محتوای ویدیویی که فایل ویدیویی نشان می‌دهد. این فیلد فقط برای فایل‌های فیلم و قسمت معتبر است و برای انواع زیر از این فایل‌ها الزامی است:

  • دارایی‌های قسمتی که به یک نمایش مرتبط هستند
  • فایل‌های فیلمی که در دسته‌بندی فیلم‌های یوتیوب نمایش داده می‌شوند

مقادیر قابل قبول عبارتند از:

  • clip
  • feature_film
  • full_episode
  • short
originalReleaseMedium

string

روشی که افراد برای اولین بار فرصت دیدن یک فایل ویدیویی را پیدا کردند. این مقدار فقط برای فایل‌های قسمت‌ها و فیلم‌ها استفاده می‌شود. برای فایل‌های زیر الزامی و در غیر این صورت اختیاری است:

  • دارایی‌های قسمتی که به یک نمایش مرتبط هستند
  • فایل‌های فیلمی که در دسته‌بندی فیلم‌های یوتیوب نمایش داده می‌شوند

مقادیر قابل قبول عبارتند از:

  • 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

رتبه‌ای که دارایی دریافت کرده است.