דף זה תורגם על ידי Cloud Translation API.

מאפייני תגי עיצוב של תוכן בתוכניות טלוויזיה

בקטע הזה מפורטים המאפיינים של תגי העיצוב של התוכן עבור סוגי הישויות TVSeries,‏ TVEpisode ו-TVSeason.

אפשר לספק את TVSeason כישות מלאה. פרטים נוספים זמינים בקטע יחסי TVSeries,‏ TVSeason ו-TVEpisode.

טבלת מפרט

TVSeries

נכס	הסוג הנדרש	תיאור
`@context`	טקסט	חובה – תמיד מוגדר ל-`["http://schema.org", {"@language": "xx"}]` כאשר 'xx' מייצג את שפת המחרוזות בפיד. לכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השדה @language לקוד השפה המתאים בפורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות יהיו בספרדית גם אם שפת הכתוביות או הדיבוב היא אנגלית.
`@type`	טקסט	חובה – תמיד מוגדר ל-`TVSeries`.
`@id`	כתובת URL	חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc. `@id` חייב לעמוד בדרישות הבאות: ייחודיים ברמת הקטלוג המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל. כמזהה משאב אחיד (URI) הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון. מכיוון שהשדה `url` של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה `url` של הישות בתור `@id`. פרטים נוספים זמינים בקטע מזהה.
`url`	כתובת URL	חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google. `url` חייבת לעמוד בדרישות הבאות: השדה `url` חייב להיות ייחודי ברמת המערכת השדה `url` חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. קישור העומק של ההפעלה מופיע במקום זאת במאפיין `urlTemplate` של האובייקט היעד.
`name`	טקסט	חובה – שם התוכנית. משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה מספר אזורים ושפות. שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
`titleEIDR`	טקסט	מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, הערך של titleEIDR עבור סדרת הטלוויזיה שנקראת 'משחקי הכס' הוא '10.5240/C1B5-3BA1-8991-A571-8472-W'.
`potentialAction`	WatchAction	חובה אם רלוונטי – אובייקט של רכיב עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand‏ (VoD), צריך לציין את המאפיין הזה. אובייקט ה-Action markup צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. הישות המשויכת `BroadcastService` מספקת במקום זאת את הקישור המעמיק של הערוץ. `TVSeries` יכול להיות זמין גם ב-VoD וגם ב-LiveTV. שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. ראו את הדוגמה מספר אזורים ושפות.
`sameAs`	כתובת URL	מומלץ מאוד למה? כתובת URL לדף אינטרנט של עזרה שיכול לזהות את התוכנית. לדוגמה, דף התוכנית בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין `url`.
`inLanguage`	טקסט	שפת המקור של הסדרה בפורמט BCP 47.
`genre`	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	טקסט	מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך של מילות מפתח. לדוגמה, ["feature, biography"] יכול להיות מערך של מילות מפתח לתיאור התוכן.
`releasedEvent`	`PublicationEvent`,‏ `FeaturedEvent` או `ExclusiveEvent`	מומלץ מאוד למה? - הקוד `PublicationEvent` משמש לציון תאריך הפרסום המקורי (הגלובלי או המקומי) של תוכן על ידי בעל התוכן הדיגיטלי, למשל תאריך הפרסום המקורי של סרט בבתי הקולנוע. בנוסף, אפשר להשתמש בקוד `FeaturedEvent` כדי לציין שהשירות שלכם משוווק את התוכן הזה כתוכן מקורי, כתוכן מוצג, כתוכן מיוחד וכו'. `ExclusiveEvent` מציין שלשירות יש זכויות הפצה בלעדיות, ויש לכלול את המיקום והתאריך. פרטים ודוגמאות מופיעים בקטע הדוגמאות.
`releasedEvent.@type`	טקסט	חובה – חשוב להגדיר את המאפיין הזה תמיד לאחת מהאפשרויות הבאות: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	מדינה	חובה – האזורים שמשויכים לאירוע הזה. באירוע מסוג `PublicationEvent`, זהו האזור שבו התוכן פורסם. באירועים מסוג `FeaturedEvent` ו-`ExclusiveEvent`, זהו האזור שבו התוכן מוצג או זמין באופן בלעדי. צריך להשתמש בקודים של מדינות לפי תקן ISO 3166. כדי לציין את כל העולם, מגדירים את הערך `EARTH`.
`releasedEvent.startDate`	תאריך או DateTime	מומלץ – חובה עבור `ExclusiveEvent` – תאריך ההתחלה של פרסום הישות. בפריט `PublicationEvent`, התאריך הזה מציין את תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לאקרנים בפעם הראשונה. בפריט `ExclusiveEvent` ו-`FeaturedEvent`, התאריך הזה מייצג את תאריך ההתחלה שבו הישות היא בלעדית או מוצגת.
`releasedEvent.endDate`	תאריך או DateTime	מומלץ – נדרש עבור `ExclusiveEvent` – השדה הזה רלוונטי רק לסוגי `ExclusiveEvent` ו-`FeaturedEvent`. ב-`ExclusiveEvent`, השדה הזה מייצג את התאריך שבו יפוג התוקף של הזכויות על התוכן. ב-`FeaturedEvent`, השדה הזה מייצג את התאריך האחרון שבו הספק הציג את הישות. אם התוכן הוא בלעדי או מוצג לתמיד, צריך להגדיר את `endDate` ל-20 שנה מהתאריך הנוכחי.
`releasedEvent.publishedBy`	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמתם את הישות הזו.
`description`	טקסט	מומלץ מאוד למה? תקציר של התוכנית. עדיף לשלוח סיכומי עלילה במקום סיכומים עובדתיים. מגבלת תווים של 300. משתמשים במערך כדי לסמן את התיאור בכמה שפות. ראו את הדוגמה מספר אזורים ושפות.
`actor`	Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של שחקני הסדרה. כאן מפורטות הנחיות ליצירת מודלים.
`director`	אדם	מומלץ מאוד למה? הבמאים של התוכנית.
`producer`	ארגון או אדם	מומלץ מאוד למה? המפיקים של התוכנית.
`image`	ImageObject	חובה ל-Google TV – התמונות שקשורות לסדרת הטלוויזיה. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-`image` זמינים במאמר מאפייני תמונה.
`trailer.description`	טקסט	התיאור של הטריילר. ראו את הדוגמה טריילר.
`trailer.inLanguage`	טקסט	השפה של הטריילר בפורמט BCP 47.
`trailer.url`	כתובת URL	כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים הרלוונטיים.
`trailer.regionsAllowed`	מקום	האזורים שבהם מותר להציג את המדיה. אם לא צוין אזור, ההנחה היא שהמודעה מותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
`identifier`	PropertyValue	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה.
`popularityScore`	PopularityScoreSpecification	מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0.
`popularityScore.@type`	טקסט	הערך תמיד מוגדר ל-`PopularityScoreSpecification`.
`popularityScore.value`	מספר	ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר.
`popularityScore.eligibleRegion`	מדינה	האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-`EARTH`. כברירת מחדל, הנכס הזה מוגדר ל-`EARTH`. `Note:` הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
`review`	ביקורות	בדיקת הדירוגים של סדרת הטלוויזיה
`review.reviewRating`	דירוג	חובה אם `review` מסופק השדה הזה משמש לציון הדירוג שסופק בביקורת.
`contentRating`	טקסט או דירוג	חובה לתוכן למבוגרים בלבד, מומלץ מאוד במקרים אחרים – סיווג התוכן הכולל. אם סיווג התוכן מצוין כמחרוזת טקסט, אפשר להשתמש בשתי וריאציות: סוכנות הדירוג הוסיפה את השם שלה לפני הדירוג עם רווח באמצע. לדוגמה, סיווג TV-MA מהסוכנות TVPG בארה"ב צריך להיות מתואר כ-TVPG TV-MA. רשימת הסוכנויות הערך 'RATING NOT KNOWN' (ללא קשר לאותיות רישיות) כדי לציין שאתם לא יודעים מהו דירוג התוכן.
`contentRating.author`	ארגון	חובה אם `contentRating` משתמש ב-`Rating` – שם סוכנות הדירוג. בדף סוכנויות סיווג תוכן מופיעה רשימה של סוכנויות סיווג תוכן מקובלות
`contentRating.ratingValue`	טקסט	חובה אם `contentRating` משתמש ב-`Rating` – הערך של הדירוג.
`contentRating.advisoryCode`	טקסט	קוד האזהרה של התוכן. הערכים הקבילים הם D,‏ FV,‏ L,‏ S ו-V. D = דו-שיח, FV = אלימות פנטזיה, L = שפה, S = תוכן מיני, V = אלימות.

TVEpisode

נכס	הסוג הנדרש	תיאור
`@context`	טקסט	חובה – תמיד מוגדר ל-`["http://schema.org", {"@language": "xx"}]` כאשר 'xx' מייצג את שפת המחרוזות בפיד. לכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השדה @language לקוד השפה המתאים בפורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות יהיו בספרדית גם אם שפת הכתוביות או הדיבוב היא אנגלית.
`@type`	טקסט	חובה – תמיד מוגדר ל-`TVEpisode`.
`@id`	כתובת URL	חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc. `@id` חייב לעמוד בדרישות הבאות: ייחודיים ברמת הקטלוג המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל. כמזהה משאב אחיד (URI) הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון. מכיוון שהשדה `url` של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה `url` של הישות בתור `@id`. פרטים נוספים זמינים בקטע מזהה.
`url`	כתובת URL	חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google. `url` חייבת לעמוד בדרישות הבאות: השדה `url` חייב להיות ייחודי ברמת המערכת השדה `url` חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. קישור העומק של ההפעלה מופיע במקום זאת במאפיין `urlTemplate` של האובייקט היעד.
`name`	טקסט	חובה – שם הפרק. משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה ייצוג בכמה שפות. שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
`titleEIDR`	טקסט	מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, הערך של titleEIDR לפרק הראשון בעונה הראשונה של סדרת הטלוויזיה 'משחקי הכס' הוא '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'.
`editEIDR`	טקסט	מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג גרסה ספציפית של עריכה או מהדורה של סרט או תוכנית טלוויזיה. לדוגמה, בפרק הראשון של העונה הראשונה של סדרת הטלוויזיה 'משחקי הכס', שמספר ה-TitleEIDR שלו הוא '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X', יש גרסה אחת, למשל '10.5240/FB97-C847-2969-D0AB-ECD1-C'. המאפיין `titleEIDR` נדרש כשמוסיפים את editEIDR.
`inLanguage`	טקסט	שפת המקור של הסדרה בפורמט BCP 47.
`episodeNumber`	Integer	חובה – המספר שמציין את המיקום של הפרק הזה בסדר הפרקים בעונה. `episodeNumber` צריך להתחיל מחדש בכל עונה, כלומר הפרק הראשון בכל עונה צריך להיות 1.
`partOfSeason`	TVSeason	חובה – העונה של תוכנית הטלוויזיה שאליה שייך הפרק הזה. גם אם ל-`TVEpisode` אין `TVSeason` תואם, עדיין צריך לספק את המאפיינים `partOfSeason.@id` ו-`partOfSeason.seasonNumber`. פתרון עקיף הוא: לוקחים את `partofSeries.@id` (לדוגמה, http://www.example.com/my_favorite_tv_show) ומצרפים שדה placeholder של שאילתה (לדוגמה, ?season1) כדי ליצור `partOfSeason.@id` ייחודי (לדוגמה, http://www.example.com/my_favorite_tv_show?season1). מגדירים את `partOfSeason.seasonNumber` לערך 1.
`partOfSeason.@type`	טקסט	חובה – תמיד מוגדר ל-`TVSeason`.
`partOfSeason.@id`	כתובת URL	חובה – ה-`@id` של ה-`TVSeason` שהפרק הזה הוא חלק ממנו.
`partOfSeason.seasonNumber`	Integer	חובה – המספר שמציין את המיקום של העונה הזו בסדר העונות של סדרת הטלוויזיה.
`partOfSeries`	TVSeries	חובה – סדרת הטלוויזיה שאליה שייך הפרק.
`partOfSeries.@type`	טקסט	חובה – תמיד מוגדר ל-`TVSeries`.
`partOfSeries.@id`	כתובת URL	חובה – ה-`@id` של ה-`TVSeries` שהפרק הזה הוא חלק ממנו.
`partOfSeries.name`	טקסט	חובה – שם סדרת הטלוויזיה.
`partOfSeries.sameAs`	טקסט	כתובת URL לדף אינטרנט של עזרה שיכול לזהות את התוכנית. לדוגמה, דף התוכנית בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין `url`.
`potentialAction`	WatchAction	חובה אם רלוונטי – אובייקט של רכיב עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand‏ (VoD), צריך לציין את המאפיין הזה. אובייקט ה-Action markup צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. הישות המשויכת `BroadcastService` מספקת במקום זאת את הקישור המעמיק של הערוץ. `TVEpisode` יכול להיות זמין גם ב-VoD וגם ב-LiveTV. שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. ראו את הדוגמה מספר אזורים ושפות.
`sameAs`	מומלץ מאוד למה? כתובת URL	כתובת URL לדף אינטרנט עם מידע שיכול לזהות את הפרק. לדוגמה, דף הפרק בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין `url`.
`duration`	משך הזמן	משך הזמן של הפרק בפורמט ISO 8601. יש להשתמש בפורמט: "PT00H00M".
`releasedEvent`	`PublicationEvent`,‏ `FeaturedEvent` או `ExclusiveEvent`	מומלץ מאוד למה? - הקוד `PublicationEvent` משמש לציון תאריך הפרסום המקורי (הגלובלי או המקומי) של תוכן על ידי בעל התוכן הדיגיטלי, למשל תאריך הפרסום המקורי של סרט בבתי הקולנוע. בנוסף, אפשר להשתמש בקוד `FeaturedEvent` כדי לציין שהשירות שלכם משווקת את התוכן הזה כתוכן מקורי, כתוכן מוצג, כתוכן מיוחד וכו'. `ExclusiveEvent` מציין שלשירות יש זכויות הפצה בלעדיות, ויש לכלול את המיקום והתאריך. פרטים נוספים ודוגמאות מופיעים בקטע הדוגמאות.
`releasedEvent.@type`	טקסט	חובה – חשוב תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	מדינה	חובה – האזורים שמשויכים לאירוע הזה. באירוע מסוג `PublicationEvent`, זהו האזור שבו התוכן פורסם. באירועים מסוג `FeaturedEvent` ו-`ExclusiveEvent`, זהו האזור שבו התוכן מוצג או זמין באופן בלעדי. צריך להשתמש בקודים של מדינות לפי תקן ISO 3166. כדי לציין את כל העולם, מגדירים את הערך `EARTH`.
`releasedEvent.startDate`	תאריך או DateTime	מומלץ – חובה עבור `ExclusiveEvent` – תאריך ההתחלה של פרסום הישות. בפריט `PublicationEvent`, התאריך הזה מציין את תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לאקרנים בפעם הראשונה. בפריט `ExclusiveEvent` ו-`FeaturedEvent`, התאריך הזה מייצג את תאריך ההתחלה שבו הישות היא בלעדית או מוצגת.
`releasedEvent.endDate`	תאריך או DateTime	מומלץ – נדרש עבור `ExclusiveEvent` – השדה הזה רלוונטי רק לסוגי `ExclusiveEvent` ו-`FeaturedEvent`. ב-`ExclusiveEvent`, השדה הזה מייצג את התאריך שבו יפוג התוקף של הזכויות על התוכן. ב-`FeaturedEvent`, השדה הזה מייצג את התאריך האחרון שבו הספק הציג את הישות. אם התוכן הוא בלעדי או מוצג לתמיד, צריך להגדיר את `endDate` ל-20 שנה מהתאריך הנוכחי.
`releasedEvent.publishedBy`	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמתם את הישות הזו.
`description`	טקסט	מומלץ מאוד למה? סיכום של הפרק. עדיף לשלוח סיכומי עלילה במקום סיכומים עובדתיים. מגבלת תווים של 300. משתמשים במערך כדי לסמן את התיאור בכמה שפות. ראו את הדוגמה ייצוג בכמה שפות.
`genre`	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	טקסט	מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך של מילות מפתח. לדוגמה, ["feature, biography"] יכול להיות מערך של מילות מפתח לתיאור התוכן.
`actor`	Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של שחקני הפרק. כאן מפורטות הנחיות ליצירת מודלים.
`director`	אדם	מומלץ מאוד למה? הבמאים של הפרק.
`producer`	ארגון או אדם	מומלץ מאוד למה? המפיקים של העונה.
`image`	ImageObject	מומלץ מאוד למה? ל-Google TV – תמונות שונות שקשורות ל-TVEpisode. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-`image` זמינים במאמר מאפייני תמונה.
`trailer.description`	טקסט	התיאור של הטריילר. ראו את הדוגמה טריילר.
`trailer.inLanguage`	טקסט	השפה של הטריילר בפורמט BCP 47.
`trailer.url`	כתובת URL	כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים הרלוונטיים.
`trailer.regionsAllowed`	מקום	האזורים שבהם מותר להציג את המדיה. אם לא צוין אזור, ההנחה היא שהמודעה מותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
`review`	ביקורות	בדיקת הדירוגים של פרק הטלוויזיה
`review.reviewRating`	דירוג	חובה אם `review` מסופק השדה הזה משמש לציון הדירוג שסופק בביקורת.
`contentRating`	טקסט או דירוג	חובה לתוכן למבוגרים בלבד, מומלץ מאוד במקרים אחרים – סיווג התוכן הכולל. אם סיווג התוכן מצוין כמחרוזת טקסט, אפשר להשתמש בשתי וריאציות: סוכנות הדירוג הוסיפה את השם שלה לפני הדירוג עם רווח באמצע. לדוגמה, סיווג TV-MA מהסוכנות TVPG בארה"ב צריך להיות מתואר כ-TVPG TV-MA. רשימת הסוכנויות הערך 'RATING NOT KNOWN' (ללא קשר לאותיות רישיות) כדי לציין שאתם לא יודעים מהו דירוג התוכן.
`contentRating.author`	ארגון	חובה אם `contentRating` משתמש ב-`Rating` – שם סוכנות הדירוג. בדף סוכנויות סיווג תוכן מופיעה רשימה של סוכנויות סיווג תוכן מקובלות
`contentRating.ratingValue`	טקסט	חובה אם `contentRating` משתמש ב-`Rating` – הערך של הדירוג.
`contentRating.advisoryCode`	טקסט	קוד האזהרה של התוכן. הערכים הקבילים הם D,‏ FV,‏ L,‏ S ו-V. D = דו-שיח, FV = אלימות פנטזיה, L = שפה, S = תוכן מיני, V = אלימות.
`identifier`	PropertyValue	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה.
`popularityScore`	PopularityScoreSpecification	מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0.
`popularityScore.@type`	טקסט	הערך תמיד מוגדר ל-`PopularityScoreSpecification`.
`popularityScore.value`	מספר	ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר.
`popularityScore.eligibleRegion`	מדינה	האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-`EARTH`. כברירת מחדל, הנכס הזה מוגדר ל-`EARTH`. `Note:` הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)

TVSeason

נכס	הסוג הנדרש	תיאור
`@context`	טקסט	חובה – תמיד מוגדר ל-`["http://schema.org", {"@language": "xx"}]` כאשר 'xx' מייצג את שפת המחרוזות בפיד. לכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השדה @language לקוד השפה המתאים בפורמט BCP 47. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות יהיו בספרדית גם אם שפת הכתוביות או הדיבוב היא אנגלית.
`@type`	טקסט	חובה – תמיד מוגדר ל-`TVSeason`.
`@id`	כתובת URL	חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc. `@id` חייב לעמוד בדרישות הבאות: ייחודיים ברמת הקטלוג המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל. כמזהה משאב אחיד (URI) הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון. מכיוון שהשדה `url` של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה `url` של הישות בתור `@id`. פרטים נוספים זמינים בקטע מזהה.
`url`	כתובת URL	חובה – כתובת ה-URL הקנונית של התוכן, שבה Google משתמשת כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google. `url` חייבת לעמוד בדרישות הבאות: השדה `url` חייב להיות ייחודי ברמת המערכת השדה `url` חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. קישור העומק של ההפעלה מופיע במקום זאת במאפיין `urlTemplate` של האובייקט היעד.
`name`	טקסט	חובה – שם העונה של תוכנית הטלוויזיה. משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה ייצוג בכמה שפות. שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
`titleEIDR`	טקסט	מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג, ברמה הכללית או המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, הערך של titleEIDR לעונה הראשונה של TVSeries שנקראת 'משחקי הכס' הוא '10.5240/FD91-C72C-4161-FCBA-058B-1'.
`seasonNumber`	Integer	חובה – המספר שמציין את המיקום של העונה הזו בסדר העונות של סדרת הטלוויזיה.
`partOfSeries`	TVSeries	חובה – סדרת הטלוויזיה שאליה שייכת העונה הזו.
`partOfSeries.@type`	טקסט	חובה – תמיד מוגדר ל-`TVSeries`.
`partOfSeries.@id`	כתובת URL	חובה – ה-`@id` של ה-`TVSeries` שהעונה הזו היא חלק ממנו.
`partOfSeries.name`	טקסט	חובה – שם סדרת הטלוויזיה.
`partOfSeries.sameAs`	טקסט	כתובת URL לדף אינטרנט של עזרה שיכול לזהות את התוכנית. לדוגמה, דף התוכנית בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין `url`.
`potentialAction`	WatchAction	חובה אם רלוונטי – אובייקט של רכיב עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand‏ (VoD), צריך לציין את המאפיין הזה. אובייקט ה-Action markup צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. הישות המשויכת `BroadcastService` מספקת במקום זאת את הקישור העמוק של הערוץ. `TVSeason` יכול להיות זמין גם ב-VoD וגם ב-LiveTV. שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. ראו את הדוגמה מספר אזורים ושפות.
`sameAs`	כתובת URL	מומלץ מאוד למה? כתובת URL לדף אינטרנט של עזרה שיכול לזהות את העונה. לדוגמה, דף העונה בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין `url`.
`releasedEvent`	`PublicationEvent`,‏ `FeaturedEvent` או `ExclusiveEvent`	מומלץ מאוד למה? - הקוד `PublicationEvent` משמש לציון תאריך הפרסום המקורי (הגלובלי או המקומי) של תוכן על ידי בעל התוכן הדיגיטלי, למשל תאריך הפרסום המקורי של סרט בבתי הקולנוע. בנוסף, אפשר להשתמש בקוד `FeaturedEvent` כדי לציין שהשירות שלכם משווקת את התוכן הזה כתוכן מקורי, כתוכן מוצג, כתוכן מיוחד וכו'. `ExclusiveEvent` מציין שלשירות יש זכויות הפצה בלעדיות, וכוללים את המיקום והתאריך. פרטים ודוגמאות מופיעים בקטע הדוגמאות.
`releasedEvent.@type`	טקסט	חובה – חשוב להגדיר את המאפיין הזה תמיד לאחת מהאפשרויות הבאות: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	מדינה	חובה – האזורים שמשויכים לאירוע הזה. באירוע מסוג `PublicationEvent`, זהו האזור שבו התוכן פורסם. באירועים מסוג `FeaturedEvent` ו-`ExclusiveEvent`, זהו האזור שבו התוכן מוצג או זמין באופן בלעדי. צריך להשתמש בקודים של מדינות לפי תקן ISO 3166. כדי לציין את כל העולם, מגדירים את הערך `EARTH`.
`releasedEvent.startDate`	תאריך או DateTime	מומלץ – חובה עבור `ExclusiveEvent` – תאריך ההתחלה של פרסום הישות. בפריט `PublicationEvent`, התאריך הזה מציין את תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לאקרנים בפעם הראשונה. בפריט `ExclusiveEvent` ו-`FeaturedEvent`, התאריך הזה מייצג את תאריך ההתחלה שבו הישות היא בלעדית או מוצגת.
`releasedEvent.endDate`	תאריך או DateTime	מומלץ – נדרש עבור `ExclusiveEvent` – השדה הזה רלוונטי רק לסוגי `ExclusiveEvent` ו-`FeaturedEvent`. ב-`ExclusiveEvent`, השדה הזה מייצג את התאריך שבו יפוג התוקף של הזכויות על התוכן. ב-`FeaturedEvent`, השדה הזה מייצג את התאריך האחרון שבו הספק הציג את הישות. אם התוכן הוא בלעדי או מוצג לתמיד, צריך להגדיר את `endDate` ל-20 שנה מהתאריך הנוכחי.
`releasedEvent.publishedBy`	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמתם את הישות הזו.
`description`	טקסט	מומלץ מאוד למה? תקציר של העונה. עדיף לשלוח סיכומי עלילה במקום סיכומים עובדתיים. מגבלת תווים של 300. משתמשים במערך כדי לסמן את התיאור בכמה שפות. ראו את הדוגמה ייצוג בכמה שפות.
`actor`	[Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של שחקני העונה. כאן מפורטות הנחיות ליצירת מודלים.
`director`	אדם	מומלץ מאוד למה? מערך של הבמאים של התוכנית.
`producer`	ארגון או אדם	מומלץ מאוד למה? המפיקים של העונה.
`image`	ImageObject	התמונות שקשורות לעונה הטלוויזיה. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-`image` זמינים במאמר מאפייני תמונה.
`genre`	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : `["Action", "Fashion", "Environment", "Football"]`
`keywords`	טקסט	מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך של מילות מפתח. לדוגמה, ["feature, biography"] יכול להיות מערך של מילות מפתח לתיאור התוכן.
`trailer.description`	טקסט	התיאור של הטריילר. ראו את הדוגמה טריילר.
`trailer.inLanguage`	טקסט	השפה של הטריילר בפורמט BCP 47.
`trailer.url`	כתובת URL	כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים הרלוונטיים.
`trailer.regionsAllowed`	מקום	האזורים שבהם מותר להציג את המדיה. אם לא צוין אזור, ההנחה היא שהמודעה מותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
`identifier`	PropertyValue	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה.
`popularityScore`	PopularityScoreSpecification	מומלץ מאוד למה? ציון ש-Google משתמשת בו, יחד עם אותות אחרים, כדי לקבוע איזה מדיה להפעיל למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג. לכן, סולם הציונים צריך להיות עקבי בכל הפידים, בין כל הישויות בקטלוג. כברירת מחדל, דירוג הפופולריות של ישות מוגדר ל-0.
`popularityScore.@type`	טקסט	הערך תמיד מוגדר ל-`PopularityScoreSpecification`.
`popularityScore.value`	מספר	ערך מספרי לא שלילי שמייצג את הפופולריות של הישות. ככל שהציון גבוה יותר, כך הפופולריות גבוהה יותר.
`popularityScore.eligibleRegion`	מדינה	האזורים שבהם ציון הפופולריות הזה רלוונטי. אם ציון הפופולריות רלוונטי באופן גלובלי, מגדירים אותו כ-`EARTH`. כברירת מחדל, הנכס הזה מוגדר ל-`EARTH`. `Note:` הפופולריות הספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
`review`	ביקורות	בדיקת הדירוגים של העונה בטלוויזיה
`review.reviewRating`	דירוג	חובה אם `review` מסופק השדה הזה משמש לציון הדירוג שסופק בביקורת.
`contentRating`	טקסט או דירוג	חובה לתוכן למבוגרים בלבד, מומלץ מאוד במקרים אחרים – סיווג התוכן הכולל. אם סיווג התוכן מצוין כמחרוזת טקסט, אפשר להשתמש בשתי וריאציות: סוכנות הדירוג הוסיפה את השם שלה לפני הדירוג עם רווח באמצע. לדוגמה, סיווג TV-MA מהסוכנות TVPG בארה"ב צריך להיות מתואר כ-TVPG TV-MA. רשימת הסוכנויות הערך 'RATING NOT KNOWN' (ללא קשר לאותיות רישיות) כדי לציין שאתם לא יודעים מהו דירוג התוכן.
`contentRating.author`	ארגון	חובה אם `contentRating` משתמש ב-`Rating` – שם סוכנות הדירוג. בדף סוכנויות סיווג תוכן מופיעה רשימה של סוכנויות סיווג תוכן מקובלות
`contentRating.ratingValue`	טקסט	חובה אם `contentRating` משתמש ב-`Rating` – הערך של הדירוג.
`contentRating.advisoryCode`	טקסט	קוד האזהרה של התוכן. הערכים הקבילים הם D,‏ FV,‏ L,‏ S ו-V. D = דו-שיח, FV = אלימות פנטזיה, L = שפה, S = תוכן מיני, V = אלימות.

מפרטי השחקן

המאפיין actor בסוגי הישויות TVSeries, ‏ TVEpisode ו-TVSeason מאפשר לציין פרטים נוספים על השחקנים, כולל שם הדמויות שלהם והתפקידים שהם ממלאים בתוכנית הטלוויזיה. בקטעים הבאים מפורט אותו מידע, עם כמה דוגמאות להבהרת השימוש.

נכס הסוג הנדרש תיאור

נכס	הסוג הנדרש	תיאור
`actor`	Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? : מערך של שחקני הסרט. משתמשים בסוג PerformanceRole כשידוע התפקיד שמילא חבר השחקנים (אופציונלי) ושם הדמות שלו. במקרה הזה, השחקן Person או PerformingGroup מוטמעים בתוך האובייקט PerformanceRole. אם לא ידועים התפקידים של שחקני הלהקה, צריך להשתמש בסוג Person כדי לציין את השחקנים הספציפיים או בסוג PerformingGroup כדי לספק פרטים על הלהקות או על קבוצות הביצוע. משתמשים במערך כדי לייצג כמה אנשים, קבוצות של שחקנים או תפקידים במופעים.

actor

Person או PerformingGroup או PerformanceRole

מומלץ מאוד למה? : מערך של שחקני הסרט.

משתמשים בסוג PerformanceRole כשידוע התפקיד שמילא חבר השחקנים (אופציונלי) ושם הדמות שלו. במקרה הזה, השחקן Person או PerformingGroup מוטמעים בתוך האובייקט PerformanceRole.
אם לא ידועים התפקידים של שחקני הלהקה, צריך להשתמש בסוג Person כדי לציין את השחקנים הספציפיים או בסוג PerformingGroup כדי לספק פרטים על הלהקות או על קבוצות הביצוע.

משתמשים במערך כדי לייצג כמה אנשים, קבוצות של שחקנים או תפקידים במופעים.

שימוש בסוגי `Person` או `PerformingGroup`

יש לציין את המאפיינים הבאים כשמשתמשים בסוג Person או PerformingGroup

נכס	הסוג הנדרש	תיאור
`@type`	Person או PerformingGroup	חובה – תמיד מוגדר ל-Person או ל-PerformingGroup
`@id`	כתובת URL	מומלץ מאוד למה? - מזהה השחקנים או קבוצת הביצועים בפורמט URI. לדוגמה, https://example.com/actor/abc. `@id` חייב לעמוד בדרישות הבאות: ייחודי ברמת הגלובוס בקטלוג לכל שחקן/קבוצת ביצוע המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל. כמזהה משאב אחיד (URI) הארגון שלכם צריך להיות הבעלים של הדומיין שמשמש לערך `@id`. חשוב לזכור שצריך להשתמש בערך `@id` שצוין בנכס השחקן בעקביות לאורך הפיד. לדוגמה, אם יש שני סרטים שבהם מופיע אותו שחקן, הערך של `@id` צריך להיות זהה בשני אובייקטי השחקן האלה.
`name`	טקסט	חובה – השם של השחקן/השחקנית/חבר הצוות/הקבוצה.
`sameAs`	כתובת URL	מומלץ מאוד למה? - כתובת URL לדף אינטרנט של עזרה שאפשר לזהות בו את השחקן או את קבוצת הביצועים. לדוגמה, הדף של השחקן בוויקיפדיה. השם הזה צריך להיות שונה מהשם של המאפיין `@id`.

שימוש בסוג `PerformanceRole`

יש לציין את המאפיינים הבאים כשמשתמשים בסוג PerformanceRole

נכס	הסוג הנדרש	תיאור
`@type`	PerformanceRole	חובה – תמיד מוגדר ל-PerformanceRole
`roleName`	טקסט	מומלץ מאוד למה? - התפקיד שמילא חבר הצוות. כאן מופיעה רשימת הערכים הקבילים.
`characterName`	טקסט	השם של דמות שמישהו שיחק בה. אין להגדיר את השדה הזה אם סוג השחקן הוא PerformingGroup.
`actor`	Person או PerformingGroup	חובה – חברי הצוות של התוכן כשמשתמשים בסוג הנתונים Person. הלהקה או הקבוצה שמבצעים את התוכן, כשמשתמשים בסוג הנתונים PerformingGroup.
`actor.@type`	Person או PerformingGroup	חובה – תמיד מוגדר ל-Person או ל-PerformingGroup
`actor.@id`	כתובת URL	מומלץ מאוד למה? - מזהה השחקן או קבוצת הביצועים בפורמט URI. לדוגמה, https://example.com/actor/abc. `@id` חייב לעמוד בדרישות הבאות: ייחודי ברמת הגלובוס בקטלוג לכל שחקן/קבוצת ביצוע המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל. כמזהה משאב אחיד (URI) הארגון שלכם צריך להיות הבעלים של הדומיין שמשמש לערך `@id`. חשוב לזכור שצריך להשתמש בערך `@id` שצוין בנכס השחקן בעקביות לאורך הפיד. לדוגמה, אם יש שני סרטים שבהם מופיע אותו שחקן, הערך של `@id` צריך להיות זהה בשני אובייקטי השחקן האלה.
`actor.name`	טקסט	חובה – השם של השחקן/השחקנית/חבר הצוות/הקבוצה.
`actor.sameAs`	כתובת URL	מומלץ מאוד למה? - כתובת URL לדף אינטרנט של עזרה שאפשר לזהות בו את השחקן או את קבוצת הביצועים. לדוגמה, הדף של השחקן בוויקיפדיה. המאפיין הזה חייב להיות שונה מהמאפיין actor.@id.

שמות תפקידים קבילים

הערכים האלה דורשים שהערך של actor.@type יהיה Person.

ערך של `roleName`	תיאור
'Cameo'	תפקיד קמיע, שנקרא גם הופעת קמיע, הוא הופעה קצרה של אדם ידוע ביצירה של אומנות הבמה.
"VoiceActor"	ביצוע קולי הוא ביצוע שבו נעשה שימוש בקול של השחקן, אבל השחקן לא מופיע על המסך. התופעה הזו נפוצה בעיקר בסרטוני אנימציה, אבל היא מתרחשת גם כשקול של שחקן מסוים נדבב מעל לדיבור של שחקן אחר.
"Double"	כפיל הוא אדם שמחליף שחקן אחר כך שהפנים שלו לא מוצגים.
‎"MotionCaptureActor"‎	רכיב MotionCaptureActor מתייחס לאדם שמצלם פעולות של שחקנים אנושיים ומשתמש במידע הזה כדי ליצור אנימציה של מודלים של דמויות דיגיטליות באנימציה ממוחשבת דו-ממדית או תלת-ממדית.

בדרך כלל המערכת מקבלת את הערכים האלה עבור סוגי Person ו-PerformingGroup.

ערך של `roleName`	תיאור
"Actor"	שחקן או שחקנית הם אנשים שמגלמים דמות במופע במדיה המסורתית של התיאטרון או במדיה המודרנית כמו קולנוע, רדיו וטלוויזיה.
'GuestStar'	"כוכב אורח הוא שחקן שמשחק תפקיד בדיוני ומופיע בפרק אחד או בכמה פרקים. במקרים מסוימים, כוכב או שחקנית אורח עשויים לגלם דמות חשובה שמופיעה שוב ושוב בסדרה, למרות שהם לא חלק מהצוות הראשי. מגדירים את הערך כ-GuestStar כשהשחקן או השחקנית מופיעים כאורחים בתוכנית. יש לציין את שחקני האורח רק ברמת הפרק, ולא להוסיף אותם ברמת הסדרה.
'אורח'	"אורח בתוכנית אירוח. חשוב לזכור ש'GuestStar' הוא תפקיד בדיוני, ו'Guest' הוא הופעה לא בדיונית.
'מגיש/ת'	קריין הוא אדם שמקריא את הנאומים הפתיחה והסיום של התוכנית, מציג את המארח, המתמודדים ו/או אורחים מפורסמים, מתאר את הפרסים הזמינים, מחמם את הקהל לפני הצילומים ומעסיק אותו במהלך ההפסקות.
'פרשן'	פרשן מספק פרשנות בזמן אמת של משחק או אירוע, בדרך כלל במהלך שידור חי.
'אימפרסיוניסטי'	שחקן חיקויים הוא שחקן שמופיע במסגרת תוכנית שבה הוא מחקה קולות, ניבים ומנהגים של ידוענים ודמויות מסרטים מצוירים.
"מארח"	אדם שמציג, מנחה או מארח תוכניות טלוויזיה, ולעיתים קרובות משמש כמתווך בין התוכנית לקהל. התפקיד 'מארח' הוא בדרך כלל תפקיד בתוכנית לא בדיונית.
'מארחים'	אדם שמארח אירוע או תוכנית בשיתוף עם אנשים אחרים.
"GuestHost"	מארח אורח הוא מארח, בדרך כלל של תוכנית אירוח, שמארח את התוכנית במקום המארח הרגיל כשהאחרון לא זמין.
'מגיש חדשות'	אדם שמציג או מספק מידע לציבור על חדשות ואירועים שמתרחשים ברמה המקומית, הלאומית והבינלאומית באמצעות תוכנית חדשות בטלוויזיה.
'כתב/ת'	כתב או כתבת מקומיים הם בדרך כלל עיתונאים או פרשנים של מגזין, או סוכנים שתורמים דיווחים לעיתון, לחדשות ברדיו או בטלוויזיה או לחברה מסוג אחר, ממיקום מרוחק, לרוב רחוק.
"ShowJudge"	שופט הוא אדם שנחשב לעתים קרובות למומחה בתחום של התוכנית, ומוקצה לו התפקיד 'שופט' כדי לבקר מתמודדים שמשתתפים באודישנים לתוכנית הטלוויזיה ומצטרפים לתחרות.
'מומחה'	חבר בצוות של דיון או בצוות ייעוץ של תוכנית רדיו או טלוויזיה.
'מתמודד'	מתמודד בתחרות או בתוכנית טלוויזיה הוא אדם שמשתתף בה.
'StoryNarrator'	'מספר' הוא אדם שמספר משהו, במיוחד דמות שמספרת את האירועים ברומן או בשיר סיפורי.
‎"MusicalArtist"‎	"מוזיקאי יכול להיות אדם, קבוצה או דמות בדיונית שבדרך כלל הופיעו בפני קהל באופן קבוע או הקליטו טראקים או אלבומים מוזיקליים. מלחינים ומחברי מילים צריכים לקבל את הסוג הזה רק אם הקרדיטים של יצירה מוזיקלית מסוימת מציינים שהם תרמו גם כמבצעים הראשיים. אפשר להשתמש בסוג הזה כדי לשייך מוזיקאים או קבוצות מוזיקאים קבועים, ומוזיקאים או קבוצות מוזיקאים אורחים, לתוכניות.

הבחנה בין תפקיד ראשי לתפקיד תומך של שחקן

כדי להבדיל בין השחקנים הראשיים/הקבועים לבין השחקנים האורחים/השחקנים בתפקידים תומכים בתוכנית טלוויזיה, מוסיפים את צוות השחקנים הראשי לישות TVSeries בלבד, ומוסיפים רק את צוות השחקנים האורחים או את צוות השחקנים בתפקידים תומכים לישות TVEpisode. חשוב לוודא שהשחקנים הראשיים או הקבועים לא נוספו לישויות TVEpisode.

דוגמאות

דוגמה ל-`TVSeries`, ל-`TVEpisode` ול-`TVSeason`

TVSeries

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeries",
  "@id": "http://www.example.com/my_favorite_tv_show/",
  "url": "http://www.example.com/my_favorite_tv_show/",
  "name": "My Favorite TV Show",
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
       },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2008-01-20",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 4.1,
    "eligibleRegion": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "CA"
      }
    ]
  },
  "description": "This is my favorite TV show.",
  "contentRating": "RATING NOT KNOWN",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": [
     {
       "@type": "PropertyValue",
       "propertyID": "IMDB_ID",
       "value":  "tt0903747"
     }
   ]
}

TVEpisode

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVEpisode",
  "@id": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "url": "http://www.example.com/my_favorite_tv_show/s7/e14",
  "name": "John Doe returns with a horse.",
  "episodeNumber": 14,
  "contentRating": "TVPG TV-MA",
  "partOfSeason": {
    "@type": "TVSeason",
    "@id": "http://www.example.com/my_favorite_tv_show/s7",
    "seasonNumber": 7
  },
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/e14?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
       "eligibleRegion": [
         {
            "@type": "Country",
            "name": "US"
         },
         {
            "@type": "Country",
            "name": "CA"
         }
       ]
    }
  },
  "sameAs": "https://en.wikipedia.org/wiki/john_doe_returns_with_a_horse",
  "duration": "PT00H25M",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2014-01-09",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "popularityScore": {
    "@type": "PopularityScoreSpecification",
    "value": 3.9,
    "eligibleRegion": "EARTH"
  },
  "description": "John Doe returns to the village three years after his disappearance.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ],
  "identifier": {
     "@type": "PropertyValue",
     "propertyID": "IMDB_ID",
     "value":  "tt3453320"
   }
}

TVSeason

{
  "@context": ["http://schema.org", {"@language": "en"}],
  "@type": "TVSeason",
  "@id": "http://www.example.com/my_favorite_tv_show/s7",
  "url": "http://www.example.com/my_favorite_tv_show/s7",
  "name": "Season 7",
  "seasonNumber": 7,
  "partOfSeries": {
    "@type": "TVSeries",
    "@id": "http://www.example.com/my_favorite_tv_show",
    "name": "My Favorite TV Show",
    "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show"
  },
  "potentialAction": {
    "@type": "WatchAction",
    "target": {
      "@type": "EntryPoint",
      "urlTemplate": "http://www.example.com/my_favorite_tv_show/s7/watch?autoplay=true",
      "inLanguage": "en",
      "actionPlatform": [
        "http://schema.org/DesktopWebPlatform",
        "http://schema.org/MobileWebPlatform",
        "http://schema.org/IOSPlatform",
        "http://schema.org/AndroidPlatform",
        "http://schema.org/AndroidTVPlatform",
        "http://schema.googleapis.com/GoogleVideoCast"
      ]
    },
     "actionAccessibilityRequirement": {
       "@type": "ActionAccessSpecification",
       "category": "subscription",
       "requiresSubscription": {
          "@type": "MediaSubscription",
          "name": "Example Package",
          "commonTier": true,
          "@id": "https://example.com/package/example"
        },
       "availabilityStarts": "2017-07-21T10:35:29Z",
       "availabilityEnds": "2018-10-21T10:35:29Z",
      "eligibleRegion": [
       {
          "@type": "Country",
          "name": "US"
       },
       {
          "@type": "Country",
          "name": "CA"
       }
      ]
     }
  },
  "sameAs": "https://en.wikipedia.org/wiki/my_favorite_tv_show_(season_7)",
  "releasedEvent": {
    "@type": "PublicationEvent",
    "startDate": "2010-09-23",
    "location": {
      "@type": "Country",
      "name": "US"
    }
  },
  "description": "The seventh season of My Favorite TV Show.",
  "actor": [
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "Person",
      "@id": "http://www.example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
    }
  ]
}

דוגמאות לנכס `Actor`

התפקיד של הגורם המבצע לא ידוע

כשהתפקיד של שחקן או שחקנית לא ידוע, מומלץ לספק רק את פרטי השחקן או השחקנית באמצעות הסוג Person או PerformingGroup

"actor": [
    {
      "@type": "Person",
      "@id": "https://example.com/actor/john_doe",
      "name": "John Doe",
      "sameAs": "https://en.wikipedia.org/wiki/john_doe"
    },
    {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
    }
  ]

התפקיד של הגורם המבצע ידוע

כשידוע התפקיד של גורם כלשהו, מומלץ לספק את פרטי הגורם באמצעות הסוג PerformanceRole

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "GuestStar",
      "characterName": "Dr. Peter Venkman",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/jane_doe",
        "name": "Jane Doe",
        "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
      }
  }
]

תפקידים ידועים לקבוצת משנה של שחקנים

אם לא ידועים המטא-נתונים של התפקיד במופע, מומלץ לספק את פרטי השחקן באמצעות הסוג Person או PerformingGroup. במקרה השני, שבו המידע הזה ידוע, צריך להשתמש בסוג PerformanceRole. אפשר להוסיף את הסוגים האלה יחד באותה מערך.

"actor": [
  {
      "@type": "PerformanceRole",
      "roleName": "Host",
      "actor": {
        "@type": "Person",
        "@id": "https://example.com/actor/john_doe",
        "name": "John Doe",
        "sameAs": "https://en.wikipedia.org/wiki/john_doe"
      }
  },
  {
      "@type": "Person",
      "@id": "https://example.com/actor/jane_doe",
      "name": "Jane Doe",
      "sameAs": "https://en.wikipedia.org/wiki/jane_doe"
  },
  {
      "@type": "PerformingGroup",
      "@id": "https://example.com/artists/ramones",
      "name": "Ramones",
      "sameAs": "https://en.wikipedia.org/wiki/Ramones"
  }
]

דפים קשורים

בדפים הבאים מפורטים נושאים שקשורים לנכסים האלה:

מאפייני תגי עיצוב של תוכן בתוכניות טלוויזיה

טבלת מפרט

TVSeries

TVEpisode

TVSeason

מפרטי השחקן

שימוש בסוגי Person או PerformingGroup

שימוש בסוג PerformanceRole

שמות תפקידים קבילים

הבחנה בין תפקיד ראשי לתפקיד תומך של שחקן

דוגמאות

דוגמה ל-TVSeries, ל-TVEpisode ול-TVSeason

TVSeries

TVEpisode

TVSeason

דוגמאות לנכס Actor

התפקיד של הגורם המבצע לא ידוע

התפקיד של הגורם המבצע ידוע

תפקידים ידועים לקבוצת משנה של שחקנים

דפים קשורים

שימוש בסוגי `Person` או `PerformingGroup`

שימוש בסוג `PerformanceRole`

דוגמה ל-`TVSeries`, ל-`TVEpisode` ול-`TVSeason`

דוגמאות לנכס `Actor`