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
  • הקלטות אודיו שנכללות בתוכנית AudioSwap
notes

string

פרטים נוספים שלא ממופים ישירות לאחד משדות המטא-נתונים האחרים. האורך המקסימלי של השדה הוא 255 בייטים.
description

string

תיאור של הנכס. יכול להיות שהתיאור יוצג ב-YouTube או במערכת ניהול התוכן. האורך המקסימלי של השדה הוא 5,000 בייטים.
genre[]

string

בשדה הזה מציינים את הז'אנר שבעזרתו אפשר לסווג את הנכס. אפשר להגדיר נכסים על ידי יותר מז'אנר אחד, וב-YouTube יש סטים שונים של ז'אנרים שמשמשים לסיווג של סוגים שונים של נכסים. לדוגמה, Soaps יכול להיות ז'אנר תקף לתוכנית, אבל לא לסרט או להקלטת אודיו.

  • הצגת הנכסים
  • נכסי סרטים שמופיעים בקטגוריה סרטים ב-YouTube
  • הקלטות אודיו שנכללות בתוכנית AudioSwap
isrc

string

קוד ISRC‏ (International Standard Recording Code) של נכס של סרטון מוזיקה או של הקלטת אודיו. ערך השדה חייב להכיל בדיוק 12 תווים אלפאנומריים.
grid

string

המזהה הגלובלי של יחידת התוכן (GRID) של סרטון מוזיקה או הקלטת אודיו. השדה חייב להכיל בדיוק 18 תווים אלפאנומריים.
artist[]

string

האומן שמשויך לנכס של סרטון מוזיקה או הקלטת אודיו. השדה הזה רלוונטי רק לנכסים מהסוגים 'סרטון מוזיקה' ו'הקלטת אודיו'. חובה ביחס להקלטות אודיו שנכללות בתוכנית AudioSwap.
label

string

חברת התקליטים שהפיצה נכס של הקלטת אודיו. השדה הזה רלוונטי רק לנכסים של הקלטות אודיו, והאורך המקסימלי שלו הוא 255 בייטים.
upc

string

קוד המוצר האוניברסלי (UPC) שמשויך לנכס.
album

string

האלבום שבו נכלל נכס של הקלטת אודיו. השדה הזה רלוונטי רק לנכסים של הקלטות אודיו, והאורך המקסימלי שלו הוא 255 בייטים.
infoUrl

string

כתובת URL רשמית שמשויכת לנכס. האורך המקסימלי של השדה הוא 1,536 בייטים. אל תשלחו כתובת URL באורך 1,537 בייט. המאמצים שלכם יהיו לשווא.
iswc

string

קוד ISWC‏ (International Standard Musical Work Code) של נכס מסוג יצירה מוזיקלית. ערך השדה חייב להכיל בדיוק 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 Systems) של הנכס.
showCustomId

string

customId של נכס התוכנית שאליו משויך נכס של עונה או של פרק. התג הזה נדרש לנכסי עונה ופרק שמופיעים בקטגוריה תוכניות ב-YouTube, והוא לא תקף לסוגים אחרים של נכסים. האורך המקסימלי של השדה הוא 64 בייטים והוא יכול לכלול תווים אלפאנומריים, מקפים (-), קווים תחתונים (_), נקודות (.), סמלי 'at'‏ (@) או קווים נטויים (/).
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‏ (International Standard Audiovisual Number) של הנכס. הערך הזה משמש רק לנכסים מסוג 'פרק' ו'סרט', והוא אופציונלי בשני המקרים. הערך מכיל 26 תווים שכוללים את 24 התווים ההקסדצימאליים של ה-ISAN, וכן 2 תווי ביקורת בפורמט הבא:

  • ‫16 התווים הראשונים בערך התג מכילים תווים הקסדצימליים שמציינים את הרכיבים 'root' ו-'episode' של ה-ISAN.
  • התו ה-17 הוא תו ביקורת (אות מ-A עד Z).
  • תווים 18 עד 25 הם שמונת התווים הנותרים של ה-ISAN, שמציינים את רכיב ה'גרסה' של ה-ISAN.
  • התו ה-26 הוא תו ביקורת נוסף (A-Z).
eidr

string

מזהה ה-Entertainment Identifier Registry ‏ (EIDR) שהוקצה לנכס. הערך הזה משמש רק לנכסים מסוג 'פרק' ו'סרט', והוא אופציונלי בשני המקרים. הערך מכיל תחילית רגילה לרישום EIDR, קו נטוי קדמי אחרי התחילית, מחרוזת הקסדצימאלית באורך 20 תווים ותו ביקורת אלפאנומרי (0-9A-Z).
hfa

string

קוד השיר של Harry Fox Agency ‏ (HFA) – קוד של שישה תווים שהונפק כדי לזהות יצירה מוזיקלית באופן ייחודי. הערך הזה תקף רק לנכסים מסוג יצירה מוזיקלית.
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

הדירוג שהנכס קיבל.