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

המקטע הזה מספק את הפרטים של מאפייני תגי העיצוב של תוכן עבור סוגי הישויות 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 על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ. המכשיר TVSeries יכול להיות זמין ב-VoD וגם ב-LiveTV. שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. אפשר לעיין בדוגמה במספר אזורים ושפות.
sameAs	כתובת URL	מומלץ מאוד למה? כתובת URL של דף עזר שיכול לזהות את התוכנית. לדוגמה, את דף התוכנית בוויקיפדיה. הערך הזה חייב להיות שונה מהמאפיין url.
inLanguage	טקסט	השפה המקורית של הסדרה בפורמט BCP 47.
genre	טקסט	רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords	טקסט	מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
releasedEvent	PublicationEvent, FeaturedEvent או ExclusiveEvent	מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט. בנוסף, צריך להשתמש ב-FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה. ExclusiveEvent מציין שלשירות יש זכויות הפצה בלעדיות ולכלול איפה ומתי. יש פרטים ודוגמאות בקטע לדוגמה.
releasedEvent.@type	טקסט	חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	מדינה	חובה – האזורים שמשויכים לאירוע הזה. אם מדובר ב-PublicationEvent, זהו האזור שבו התוכן פורסם. בFeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי. יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH.
releasedEvent.startDate	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות. בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע. עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent. בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן. ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות. אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description	טקסט	מומלץ מאוד למה? תקציר של התוכנית. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים. אפשר להשתמש במערך כדי לסמן את התיאור בכמה שפות. אפשר לעיין בדוגמה במספר אזורים ושפות.
actor	אדם או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של צוות השחקנים בסדרה. תוכלו למצוא הנחיות לבניית מודלים כאן.
director	אדם	מומלץ מאוד למה? מנהלי התוכנית.
producer	ארגון או אדם	מומלץ מאוד למה? מפיקי התוכנית.
image	ImageObject	חובה ב-Google TV – התמונות שקשורות ל-TVSeries. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם 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) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה. לדוגמה: שם EIDR של הפרק הראשון של העונה הראשונה של סדרת TVSeries שנקרא 'Game of Thrones' הוא '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'.
editEIDR	טקסט	מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג מהדורה ספציפית של יצירה או סרט טלוויזיה. לדוגמה, הפרק הראשון של העונה הראשונה של TVSeries בשם 'Game of Thrones', ששם EIDR שלו הוא "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 על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ 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	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות. בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע. עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent. בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן. ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות. אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description	טקסט	מומלץ מאוד למה? תקציר של הפרק. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים. אפשר להשתמש במערך כדי לסמן את התיאור בכמה שפות. אפשר לראות דוגמה לייצוג במספר שפות.
genre	טקסט	רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords	טקסט	מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
actor	אדם או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של צוות השחקנים של הפרק. תוכלו למצוא הנחיות לבניית מודלים כאן.
director	אדם	מומלץ מאוד למה? במאי הפרק.
producer	ארגון או אדם	מומלץ מאוד למה? מפיקי העונה.
image	ImageObject	מומלץ מאוד למה? ל-Google TV – תמונות שונות שקשורות לפרק ב-TV. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם 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 על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ 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	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות. בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע. עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate	Date או DateTime	מומלץ – חובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent. בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן. ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות. אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description	טקסט	מומלץ מאוד למה? תקציר העונה. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים. אפשר להשתמש במערך כדי לסמן את התיאור בכמה שפות. אפשר לראות דוגמה לייצוג במספר שפות.
actor	[אדם או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של צוות השחקנים של העונה. תוכלו למצוא הנחיות לבניית מודלים כאן.
director	אדם	מומלץ מאוד למה? מערך של מנהלי התוכנית.
producer	ארגון או אדם	מומלץ מאוד למה? מפיקי העונה.
image	ImageObject	התמונות שקשורות לעונה בטלוויזיה. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות.
genre	טקסט	רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords	טקסט	מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
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	אדם או PerformingGroup או PerformanceRole	מומלץ מאוד למה? : מערך של השחקנים. כדאי להשתמש בסוג PerformanceRole כשהתפקיד מילא, ואם כן, שם הדמות של השחקנים ידוע. במקרה הזה, השחקן person או PerformingGroup מוטמע בתוך אובייקט ה-PerformanceRole. יש להשתמש בסוג אדם כדי לציין את השחקנים האינדיבידואליים או על PerformingGroup כדי לספק פרטים על הקבוצות או להקות שמבצעים כשהתפקידים של השחקנים לא ידועים. שימוש במערך כדי לייצג מספר אנשים, קבוצות ביצועים או PerformanceRoles.

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

כשנעשה שימוש בסוג person או PerformingGroup, צריך לספק את המאפיינים הבאים

נכס	הסוג הצפוי	תיאור
@type	אדם או PerformingGroup	חובה – תמיד מוגדר ל-אדם או ל-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	אדם או PerformingGroup	חובה - חברי ההעברה(cast) של התוכן כשנעשה שימוש בסוג הנתונים אדם. הקבוצות/התדרים/הקבוצות/הלהיטים שמבצעים את התוכן תוך שימוש בסוג הנתונים PerformingGroup.
actor.@type	אדם או PerformingGroup	חובה – תמיד מוגדר ל-אדם או ל-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"	קול של שחקן הוא קול שבו השחקן מופיע בקול שלו, אבל הוא לא מופיע במסך. מצב כזה מופיע בדרך כלל באנימציה, אבל קורה גם כשהקול של שחקן מסוים מדבב במהלך דיבור של שחקן אחר.
"כפולה"	כפיל הוא אדם שמחליף שחקן אחר כך שלא יוצגו לו פניו של אותו אדם.
'MotionCaptureActor'	המונח MotionCaptureActor מתייחס לאדם שמקליט פעולות של שחקנים אנושיים, ומשתמש במידע הזה כדי להנפיש מודלים של דמויות דיגיטליות באנימציה ממוחשבת בדו-ממד או בתלת-ממד.

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

ערך של roleName	תיאור
'Actor'	שחקן או שחקנית הם אדם שמציג דמות בהופעה באמצעי המדיה המסורתיים של התיאטרון או במדיה מודרנית כמו סרט, רדיו וטלוויזיה.
"אורח"	"כוכב אורח הוא שחקן שמגלם תפקיד בדיוני ומופיע בפרק אחד או בכמה פרקים. במקרים מסוימים, כוכב אורח עשוי לגלם דמות חשובה שחוזרת על עצמה, והוא עשוי להופיע פעמים רבות בסדרה, למרות שהוא לא חבר בקבוצה הראשית. הגדרת הערך ל-"GuestStar" כשהצוות מציג הופעה של אורח או שהוא אורח בתוכנית. אפשר לספק כוכבים אורחים רק ברמת הפרק, ואין להוסיף אותם ברמת TVSeries.
'אורח'	"אורח בתוכנית אירוח. שימו לב שבעוד ש-"GuestStar" הוא תפקיד בדיוני, "אורח" מראה לא בדיוני.
"Offerr" (הכרזה)	קריין הוא אדם שמציג קטעים פתיחה וסגירה של התוכנית, מציג את המארח, את המתחרים ו/או האורחים סלבריטאים, מתאר את הפרסים הזמינים ומחמם את הקהל לפני ההקלטה ומבדר אותם במהלך ההפסקות.
'פרשן'	פרשן מספק פרשנות בזמן אמת של משחק או אירוע, בדרך כלל במהלך שידור חי.
"אימפרסיוניסטי"	אימפרסיוניסטי או חיקוי הוא שחקן שפעולה שלו כוללת חיקוי של צלילים, קולות והתנהגותם של ידוענים ודמויות מצוירות.
'מארח'	אדם שמציג, מציג או מארח תוכניות טלוויזיה, ולעיתים קרובות משמש כמגשר בתוכנית ובקהל. ה'מארח' הוא בדרך כלל תפקיד לא בדיוני.
'CoHost'	אדם שמארח אירוע או תוכנית במשותף עם אנשים אחרים.
'מארח אורח'	מארח אורח הוא בדרך כלל מנחה (בדרך כלל של תוכנית אירוח) שמארח את התוכנית במקום המארח הרגיל, כאשר הדבר לא זמין.
"שדרן חדשות"	אדם שמציג או מודיע לציבור על חדשות ואירועים שמתרחשים ברמה מקומית, לאומית ובינלאומית באמצעות תוכנית חדשות בטלוויזיה.
"כתבי חדשות"	כתבים או עיתונאים שמופיעים במקום הם בדרך כלל עיתונאי או פרשן של כתב עת, או סוכן שתורם דיווחים לעיתון, לחדשות רדיו או טלוויזיה, או חברה מסוג אחר, ממיקום מרוחק, שלרוב מרוחק.
"ShowJudge"	שופט הוא אדם שלעיתים קרובות נחשב מומחה בתחום ההצגה, וממלא את התפקיד 'שופט' כדי להעביר ביקורת על מתחרים שנכונים להשתתפות בתחרות של סדרת הטלוויזיה ונכנסים אליה.
"Panelist"	חבר בפאנל או בפאנל ייעוץ של פאנל רדיו או טלוויזיה.
'מתחרה'	מתחרה בתחרות או בתוכנית משחקים הוא אדם שמשתתף בהם.
"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

תפקיד השחקן לא ידוע

במקרים שבהם תפקידו של שחקן לא ידוע, ההמלצה שלנו היא לספק לו את פרטי השחקנים באמצעות סוג האדם או 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"
      }
  }
]

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

כאשר המטא-נתונים של תפקיד הביצוע לא ידועים, ההמלצה שלנו היא לספק לשחקן את פרטי הגורם אדם או 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"
  }
]

דפים קשורים

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

• זיהוי סוגי הישויות של התוכן
• לאסוף את המזהה, כתובת ה-URL והשם של התוכן
• זיהוי הקשרים בין סדרות טלוויזיה, עונה בטלוויזיה ופרקים בתוכנית טלוויזיה
• איסוף המטא-נתונים של התוכן