מאפייני סימון של תוכניות טלוויזיה

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

ציון TVSeason כישות מלאה הוא אופציונלי. מידע נוסף מופיע בסעיף הסדרות TV, TVSeason ו-TVEpisode.

טבלת מפרטים

סדרות טלוויזיה

מאפיין (property)	הסוג הנדרש	תיאור
@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 (רישום של מזהה בידור) שמייצג ברמה הכללית/המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, titleEIDR for the TVSeries שנקרא "Game of Thrones" הוא "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction	WatchAction	חובה אם רלוונטי – אובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ בשידור חי, הנכס הזה הוא אופציונלי. הישות 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, זהו האזור שבו התוכן פורסם. האזור הזה הוא האזור שבו התוכן מוצג או בלעדי. שימוש בקודי ISO 3166 למדינות.FeaturedEventExclusiveEvent כדי לציין בכל מקום בעולם, צריך להגדיר את הערך 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	Person או PerformingGroup או performanceRole	מומלץ מאוד למה? מערך של חברי השחקנים בסדרה. כאן תמצאו הנחיות ליצירת מודלים.
director	אדם	מומלץ מאוד למה? במאי התוכנית.
producer	ארגון או אדם	מומלץ מאוד למה? מפיקי התוכנית.
image	אובייקט תמונה	חובה עבור Google TV – התמונות שקשורות ל-TVSeries. לקבלת פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-image, אפשר לעיין במאמר מאפייני תמונה.
trailer.description	טקסט	תיאור הטריילר. אפשר לעיין בדוגמה טריילר.
trailer.inLanguage	טקסט	שפת הטריילר בפורמט BCP 47.
trailer.url	כתובת URL	כתובת URL של טריילר שמארח באופן גלוי לכולם ומועלה על ידי אולפני הפקות או מקורות מורשים.
trailer.regionsAllowed	מקום	האזורים שבהם המדיה מותרת. אם היא לא צוינה, ההנחה היא שהיא מותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier	נכס Value	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות באופן חד-משמעי. מותר להשתמש בכמה מזהים. מידע נוסף מופיע בקטע נכסי מזהים.
popularityScore	מפרט פופולרי	מומלץ מאוד למה? ניקוד ש-Google משתמשת בו, כמו גם סימנים אחרים, כדי לקבוע איזו מדיה להפעיל עבור המשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, קנה המידה של הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר ל-0.
popularityScore.@type	טקסט	תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value	מספר	ערך מספרי שאינו שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion	מדינה	האזורים שבהם ציון הפופולריות רלוונטי. אם ציון הפופולריות הוא גלובלי, יש להגדיר כ-EARTH. כברירת מחדל, הנכס הזה מוגדר לערך EARTH. Note: הפופולריות הספציפית לשוק המקומי מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
review	ביקורות	בדיקת הדירוגים של סדרת הטלוויזיה
review.reviewRating	דירוג	חובה אם הזנתם את review כדי לציין את הדירוג שצוין בביקורת.
contentRating	טקסט או דירוג	חובה לגבי תוכן למבוגרים בלבד, מומלץ מאוד – סיווג התוכן הכולל. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, מתקבלות שתי וריאציות: סוכנות הדירוג הטמיעה את הדירוג בתחילתו, עם רווח לבן באמצע. לדוגמה, דירוג "TV-MA" מסוכנות "TVPG" בארה"ב צריך לתאר כ"TVPG TV-MA". בקישור הבא ניתן למצוא את רשימת הסוכנויות. ערך של 'דירוג לא ידוע' (לא תלוי אותיות רישיות) כדי לציין שאינך יודע את הדירוג של התוכן.
contentRating.author	טקסט או ארגון	חובה אם contentRating משתמש ב-Rating – השם של סוכנות הדירוג. בדף סוכנויות לסיווג תוכן מופיעה רשימה של סוכנויות סיווגים שאושרו.
contentRating.ratingValue	טקסט	חובה אם contentRating משתמש ב-Rating – הערך של הדירוג.
contentRating.advisoryCode	טקסט	קוד האזהרה עבור התוכן. הערכים הקבילים הם D, FV, L, S, ו-V. D = Dialogue, FV = אלימות אלימות , L = שפה, S = תוכן מיני, V = אלימות.

פרק בתוכנית טלוויזיה

מאפיין (property)	הסוג הנדרש	תיאור
@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 (רישום של מזהה בידור) שמייצג ברמה הכללית/המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, titleEIDR עבור הפרק הראשון של העונה הראשונה של TVSeries שנקרא "Game of Thrones" הוא "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X".
editEIDR	טקסט	מומלץ מאוד למה? - מזהה EIDR (מספק בידור של מזהה בידור) שמייצג עריכה / מהדורה ספציפית של סרט או טלוויזיה. לדוגמה, הפרק הראשון של העונה הראשונה של TVSeries שנקרא "משחק הכס", שהכותרת שלו היא E1R titleEIDR הנכס נדרש כאשר סופק נתון EIDR.
inLanguage	טקסט	השפה המקורית של הסדרה בפורמט BCP 47.
episodeNumber	Integer	חובה – המספר שמציין את מיקום הפרק לפי סדר הפרקים בעונה. צריך להפעיל מחדש את episodeNumber בכל עונה. כלומר, הפרק הראשון של כל עונה צריך להיות אחד.
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	סדרות טלוויזיה	חובה – סדרת הטלוויזיה שאליה הפרק הזה שייך.
partOfSeries.@type	טקסט	חובה – תמיד מוגדר ל-TVSeries.
partOfSeries.@id	כתובת URL	חובה – @id מתוך TVSeries שהפרק הזה שייך לו.
partOfSeries.name	טקסט	חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs	טקסט	כתובת URL של דף אינטרנט מפנה אל התוכנית. לדוגמה, דף הוויקיפדיה של התוכנית. הערך הזה צריך להיות שונה מהנכס url.
potentialAction	WatchAction	חובה אם רלוונטי – אובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ בשידור חי, הנכס הזה הוא אופציונלי. הישות 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, זהו האזור שבו התוכן פורסם. האזור הזה הוא האזור שבו התוכן מוצג או בלעדי. שימוש בקודי ISO 3166 למדינות.FeaturedEventExclusiveEvent כדי לציין בכל מקום בעולם, צריך להגדיר את הערך 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	Person או PerformingGroup או performanceRole	מומלץ מאוד למה? מערך השחקנים מתוך הפרק. כאן תמצאו הנחיות ליצירת מודלים.
director	אדם	מומלץ מאוד למה? הבמאים של הפרק.
producer	ארגון או אדם	מומלץ מאוד למה? המפיקים של העונה.
image	אובייקט תמונה	מומלץ מאוד למה? ב-Google 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". בקישור הבא ניתן למצוא את רשימת הסוכנויות. ערך של 'דירוג לא ידוע' (לא תלוי אותיות רישיות) כדי לציין שאינך יודע את הדירוג של התוכן.
contentRating.author	טקסט או ארגון	חובה אם contentRating משתמש ב-Rating – השם של סוכנות הדירוג. בדף סוכנויות לסיווג תוכן מופיעה רשימה של סוכנויות סיווגים שאושרו.
contentRating.ratingValue	טקסט	חובה אם contentRating משתמש ב-Rating – הערך של הדירוג.
contentRating.advisoryCode	טקסט	קוד האזהרה עבור התוכן. הערכים הקבילים הם D, FV, L, S, ו-V. D = Dialogue, FV = אלימות אלימות , L = שפה, S = תוכן מיני, V = אלימות.
identifier	נכס Value	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות באופן חד-משמעי. מותר להשתמש בכמה מזהים. מידע נוסף מופיע בקטע נכסי מזהים.
popularityScore	מפרט פופולרי	מומלץ מאוד למה? ניקוד ש-Google משתמשת בו, כמו גם סימנים אחרים, כדי לקבוע איזו מדיה להפעיל עבור המשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, קנה המידה של הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר ל-0.
popularityScore.@type	טקסט	תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value	מספר	ערך מספרי שאינו שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion	מדינה	האזורים שבהם ציון הפופולריות רלוונטי. אם ציון הפופולריות הוא גלובלי, יש להגדיר כ-EARTH. כברירת מחדל, הנכס הזה מוגדר לערך EARTH. Note: הפופולריות הספציפית לשוק המקומי מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)

TVSeason

מאפיין (property)	הסוג הנדרש	תיאור
@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 (רישום של מזהה בידור) שמייצג ברמה הכללית/המופשטת ביותר, יצירה של סרט או טלוויזיה. לדוגמה, titleEIDR לעונה הראשונה של TVSeries הידועה בשם "משחק הכס" הוא "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber	Integer	חובה – המספר שמציין את מיקום העונה בסדר הזה של העונות בסדרת הטלוויזיה.
partOfSeries	סדרות טלוויזיה	חובה – סדרת הטלוויזיה שאליה שייכת העונה הזו.
partOfSeries.@type	טקסט	חובה – תמיד מוגדר ל-TVSeries.
partOfSeries.@id	כתובת URL	חובה – ה-@id מתוך ה-TVSeries שעונה היא חלק מהם.
partOfSeries.name	טקסט	חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs	טקסט	כתובת URL של דף אינטרנט מפנה אל התוכנית. לדוגמה, דף הוויקיפדיה של התוכנית. הערך הזה צריך להיות שונה מהנכס url.
potentialAction	WatchAction	חובה אם רלוונטי – אובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב-Video on Demand (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן. אם התוכן זמין בערוץ בשידור חי, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ. מכשיר TVSeason יכול להיות זמין גם ב-VOD וגם ב-LiveTV. שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. ניתן לעיין בדוגמה מספר אזורים ושפות.
sameAs	כתובת URL	מומלץ מאוד למה? כתובת URL של דף אינטרנט מפנה שיכול לזהות את העונה, לדוגמה, דף הוויקיפדיה של העונה. הערך הזה צריך להיות שונה מהנכס url.
releasedEvent	PublicationEvent, FeaturedEvent או ExclusiveEvent	מומלץ מאוד למה? - PublicationEvent משמש לציון הגרסה המקורית (הגלובלית או המקומית) של בעל התוכן הדיגיטלי, כמו תאריך היציאה המקורי של סרט. בנוסף, יש להשתמש ב-FeaturedEvent כדי לציין שהשירות שלך משווק את התוכן הזה כמקור, מוצג, מיוחד וכן הלאה. ExclusiveEvent מציין שלשירות שלך יש זכויות הפצה בלעדיות, כולל מתי ואיפה. יש לעיין בקטע לדוגמה לקבלת פרטים ודוגמאות.
releasedEvent.@type	טקסט	חובה – תמיד צריך להגדיר את הנכס הזה לאחת מהאפשרויות הבאות: PublicationEvent ExclusiveEvent FeaturedEvent
releasedEvent.location	מדינה	חובה – האזורים המשויכים לאירוע הזה. בPublicationEvent, זהו האזור שבו התוכן פורסם. האזור הזה הוא האזור שבו התוכן מוצג או בלעדי. שימוש בקודי ISO 3166 למדינות.FeaturedEventExclusiveEvent כדי לציין בכל מקום בעולם, צריך להגדיר את הערך 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	אובייקט תמונה	התמונות שקשורות ל-TVSeason. לקבלת פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-image, אפשר לעיין במאמר מאפייני תמונה.
genre	טקסט	רשימה מסודרת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords	טקסט	מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. כמו כן, אפשר להשתמש במגוון של מילות מפתח. לדוגמה, ['תכונה, ביוגרפיה'] יכולה להיות מערך של מילות מפתח לתיאור התוכן.
trailer.description	טקסט	תיאור הטריילר. אפשר לעיין בדוגמה טריילר.
trailer.inLanguage	טקסט	שפת הטריילר בפורמט BCP 47.
trailer.url	כתובת URL	כתובת URL של טריילר שמארח באופן גלוי לכולם ומועלה על ידי אולפני הפקות או מקורות מורשים.
trailer.regionsAllowed	מקום	האזורים שבהם המדיה מותרת. אם היא לא צוינה, ההנחה היא שהיא מותרת בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier	נכס Value	מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות באופן חד-משמעי. מותר להשתמש בכמה מזהים. מידע נוסף מופיע בקטע נכסי מזהים.
popularityScore	מפרט פופולרי	מומלץ מאוד למה? ניקוד ש-Google משתמשת בו, כמו גם סימנים אחרים, כדי לקבוע איזו מדיה להפעיל עבור המשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, קנה המידה של הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מוגדר ל-0.
popularityScore.@type	טקסט	תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value	מספר	ערך מספרי שאינו שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion	מדינה	האזורים שבהם ציון הפופולריות רלוונטי. אם ציון הפופולריות הוא גלובלי, יש להגדיר כ-EARTH. כברירת מחדל, הנכס הזה מוגדר לערך EARTH. Note: הפופולריות הספציפית לשוק המקומי מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
review	ביקורות	דירוג הדירוגים של עונת הטלוויזיה
review.reviewRating	דירוג	חובה אם הזנתם את review כדי לציין את הדירוג שצוין בביקורת.
contentRating	טקסט או דירוג	חובה לגבי תוכן למבוגרים בלבד, מומלץ מאוד – סיווג התוכן הכולל. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, מתקבלות שתי וריאציות: סוכנות הדירוג הטמיעה את הדירוג בתחילתו, עם רווח לבן באמצע. לדוגמה, דירוג "TV-MA" מסוכנות "TVPG" בארה"ב צריך לתאר כ"TVPG TV-MA". בקישור הבא ניתן למצוא את רשימת הסוכנויות. ערך של 'דירוג לא ידוע' (לא תלוי אותיות רישיות) כדי לציין שאינך יודע את הדירוג של התוכן.
contentRating.author	טקסט או ארגון	חובה אם contentRating משתמש ב-Rating – השם של סוכנות הדירוג. בדף סוכנויות לסיווג תוכן מופיעה רשימה של סוכנויות סיווגים שאושרו.
contentRating.ratingValue	טקסט	חובה אם contentRating משתמש ב-Rating – הערך של הדירוג.
contentRating.advisoryCode	טקסט	קוד האזהרה עבור התוכן. הערכים הקבילים הם D, FV, L, S, ו-V. D = Dialogue, FV = אלימות אלימות , L = שפה, S = תוכן מיני, V = אלימות.

פרטי השחקן

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

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

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

יש לספק את המאפיינים הבאים כשנעשה שימוש בסוג אדם או PerformingGroup

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

שימוש בסוג PerformanceRole

יש לספק את המאפיינים הבאים כשנעשה שימוש בסוג performanceRole

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

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

ערך של roleName	תיאור
'שחקן'	שחקן או שחקן הוא אדם שמציג דמות בהופעה במדיום המסורתי של התיאטרון או במדיה מודרנית, כגון קולנוע, רדיו וטלוויזיה.
אורח/ת	"כוכב אורח הוא שחקן שממלאים תפקיד בדיוני ומוצג בפרק אחד או בכמה פרקים. במקרים מסוימים, 'כוכב אורח' עשוי לדמות דמות חשובה ולהופיע מספר רב של פעמים בסדרה, למרות שהוא לא מופיע בשחקנים הראשי. יש להגדיר את הערך כ-'StarStar' כשההעברה כוללת ביצועי אורח או כאורח בתוכנית. יש לספק את כוכבי האורחים רק ברמת הפרק, ואין להוסיף אותם ברמת TVSeries.
'אורח'	"אורח בתוכנית אירוח. שימו לב: אמנם 'אורח' הוא תפקיד בדיוני, אבל 'אורח' הוא מראה בדיוני.
'קריינית'	קריין הוא אדם שמוסר תכנים של פתיחה וסגירה של מופעים, מציג את המארח, את המתחרים ו/או את ידועני הכוכבים, מתאר את הפרסים הזמינים ומחמם את הקהל לפני ההקשה, ומבדר אותם בהפסקות.
'בעל הרשאת תגובה'	הפרשן מספק פרשנות בזמן אמת של משחק או אירוע, בדרך כלל במהלך שידור חי.
'אימפרסיוניסטי'	אימפרסיוניסט או חיקוי הוא שחקן שחיותו מורכב מחיקויים, קולות וגינונים של ידוענים ודמויות מצוירות.
'מארח'	אדם שמציג, מציג או מארח תוכניות טלוויזיה, ובדרך כלל משמש כמתווך עבור התוכנית והקהל. "המארח" הוא בדרך כלל תפקיד בדיוני.
"CoHost"	אדם שמארח אירוע/תוכנית ביחד עם אדם אחר.
"אורח"	מארח אורח הוא מארח, בדרך כלל של תוכנית אירוח, שמארח את התוכנית במקום המארח הרגיל כאשר אינו זמין.
'Newscaster'	אדם שמציג/מיידע את הציבור לגבי חדשות ואירועים שמתרחשים בקנה מידה מקומי, ארצי ובינלאומי באמצעות תוכנית חדשות בטלוויזיה.
"כתב"	עיתונאי או עיתונאי הוא בדרך כלל עיתונאי או כותב של כתב עת, או סוכן שתורם דוחות לעיתון, לחדשות רדיו או לטלוויזיה, או לכתבה אחרת, ממקום מרוחק, לרוב מרוחק.
"ShowJudge"	שופט הוא אדם הנחשב לעתים קרובות למומחה בתחום התוכנית, ומוקצה לו התפקיד "שופט" כדי לערוך ביקורת על מתחרים שניגשים לסדרת הטלוויזיה ונכנסים לתחרות.
"מפרסם/ת שירים"	חבר בדיון או בייעוץ של פאנל רדיו או טלוויזיה.
'נוכח'	מתחרה בתחרות או בתוכנית משחקים הוא אדם שמשתתף בה.
"StoryNraator"	קריין הוא אדם קריינות, בעיקר דמות שמתארת אירועים של שיר חדש או רומן
"מחזות זמר"	"אומן מוזיקלי יכול להיות אדם או קבוצה, או דמות בדיונית שלרוב מושמעת בפני קהל על בסיס קבוע, או אם הם הקליטו טראקים מוזיקליים או אלבומים מוזיקליים. מלחינים ותמלילנים צריכים להשתמש בסוג הזה רק אם הקרדיטים לחלק מהיצירות המוזיקליות מציינים גם שהם תורמים למלחין הראשי. ניתן להשתמש בסוג הזה כדי לשייך מוזיקאים קבועים או קבוצות מוזיקאים, ומופעי מוזיקה כאורחים או קבוצות מוזיקה יופיעו בתוכניות.

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

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

דוגמאות

דוגמה לגבי TVSeries, TVEpisode וגם TVSeason

סדרות טלוויזיה

{
  "@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"
     }
   ]
}

פרק בתוכנית טלוויזיה

{
  "@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"
    }
  ]

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

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

"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 והשם של התוכן
• זיהוי הקשרים בין סדרות טלוויזיה, עונות טלוויזיה ופרקים של סדרות טלוויזיה
• איסוף מטא-נתונים של תוכן