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

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

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

טבלת מפרטים

TVSeries

נכס	הסוג הנדרש	תיאור
@context	טקסט	חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}] הקטע 'xx' מייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השפה באמצעות קוד השפה המתאים בפורמט 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 חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. כדי לראות את קישור העומק להפעלה, צריך לעיין במאפיין urlTemplate של אובייקט היעד.
name	טקסט	חובה – שם התוכנית. משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages. שימו לב: אפשר להזין רק שם אחד לכל לוקאל (שילוב של שפה ומדינה).
titleEIDR	טקסט	מומלץ מאוד למה? ‫– מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית או המופשטת ביותר יצירה קולנועית או טלוויזיונית. לדוגמה, מזהה EIDR של שם התוכנית בסדרת הטלוויזיה 'משחקי הכס' הוא ‎10.5240/C1B5-3BA1-8991-A571-8472-W.
potentialAction	WatchAction	חובה אם רלוונטי – אובייקט של תג עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב'סרטון על פי דרישה' (VoD), צריך לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ. תוכן TVSeries יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה. כדי לציין קישורי עומק שונים בכמה אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
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	‫Date או DateTime	מומלץ – חובה לExclusiveEvent – תאריך ההתחלה של פרסום הישות. במקרה של PublicationEvent, זהו תאריך ההפצה הראשוני של הישות, למשל התאריך שבו סרט יצא לאקרנים. במקרה של ExclusiveEvent וFeaturedEvent, זהו תאריך ההתחלה של תקופת הבלעדיות או ההצגה של הישות.
releasedEvent.endDate	‫Date או DateTime	מומלץ – חובה לExclusiveEvent – המאפיין הזה רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent. בסוג ExclusiveEvent, המאפיין הזה מייצג את התאריך שבו מסתיימות הזכויות על התוכן. בסוג FeaturedEvent, המאפיין הזה מייצג את התאריך האחרון שבו הספק מציג את הישות. אם התוכן הוא בלעדי או מוצג באופן קבוע, צריך להגדיר את endDate ל-20 שנה מהתאריך הנוכחי.
releasedEvent.publishedBy	ארגון או אדם	אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description	טקסט	מומלץ מאוד למה? תקציר של התוכנית. עדיף להשתמש בתקצירים של העלילה ולא בסיכומים עובדתיים. מגבלה של 300 תווים. משתמשים במערך כדי לתייג את התיאור בכמה שפות. אפשר לעיין בדוגמה Multiple regions and languages.
actor	Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של חברי צוות השחקנים בסדרה. כאן אפשר לקרוא הנחיות לגבי יצירת מודלים.
director	Person	מומלץ מאוד למה? הבמאי או הבמאים של התוכנית.
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 = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות פנטזיה),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).

TVEpisode

נכס	הסוג הנדרש	תיאור
@context	טקסט	חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}] הקטע 'xx' מייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השפה באמצעות קוד השפה המתאים בפורמט 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 חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. כדי לראות את קישור העומק להפעלה, צריך לעיין במאפיין urlTemplate של אובייקט היעד.
name	טקסט	חובה – שם הפרק. משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה לייצוג של כמה שפות. שימו לב: אפשר להזין רק שם אחד לכל לוקאל (שילוב של שפה ומדינה).
titleEIDR	טקסט	מומלץ מאוד למה? ‫– מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית או המופשטת ביותר יצירה קולנועית או טלוויזיונית. לדוגמה, מזהה EIDR של הכותרת לפרק הראשון בעונה הראשונה של סדרת הטלוויזיה 'משחקי הכס' הוא '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'.
editEIDR	טקסט	מומלץ מאוד למה? ‫– מזהה EIDR (Entertainment Identifier Registry) שמייצג עריכה או מהדורה ספציפית של יצירה קולנועית או טלוויזיונית. לדוגמה, לפרק הראשון בעונה הראשונה של סדרת הטלוויזיה 'משחקי הכס', שמזהה ה-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	חובה אם רלוונטי – אובייקט של תג עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב'סרטון על פי דרישה' (VoD), צריך לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ. תוכן TVEpisode יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה. כדי לציין קישורי עומק שונים בכמה אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
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	טקסט	מילות מפתח או תגים שמשמשים לתיאור התוכן הזה. מותר להשתמש גם במערך של מילות מפתח. לדוגמה, ['feature, biography'] יכול להיות מערך של מילות מפתח לתיאור התוכן.
actor	Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של חברי צוות השחקנים בפרק. כאן אפשר לקרוא הנחיות לגבי יצירת מודלים.
director	Person	מומלץ מאוד למה? הבמאי או הבמאים של הפרק.
producer	ארגון או אדם	מומלץ מאוד למה? המפיקים של העונה.
image	ImageObject	מומלץ מאוד למה? ל-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. רשימת הסוכנויות הערך RATING NOT KNOWN (לא משנה אם האותיות רישיות או לא) מציין שאתם לא יודעים מה הסיווג של התוכן.
contentRating.author	ארגון	חובה אם contentRating משתמש ב-Rating – שם סוכנות הסיווג. רשימת סוכנויות הסיווג המקובלות מופיעה בדף סוכנויות סיווג תוכן
contentRating.ratingValue	טקסט	חובה אם contentRating משתמש ב-Rating – ערך הסיווג.
contentRating.advisoryCode	טקסט	קוד האזהרה לגבי התוכן. הערכים הקבילים כוללים D,‏ FV,‏ L,‏ S ו-V. ‏ D = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות פנטזיה),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).
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' מייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות ברמה הבסיסית צריך להגדיר את השפה באמצעות קוד השפה המתאים בפורמט 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 חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק. כדי לראות את קישור העומק להפעלה, צריך לעיין במאפיין urlTemplate של אובייקט היעד.
name	טקסט	חובה – שם העונה של תוכנית הטלוויזיה. משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה לייצוג של כמה שפות. שימו לב: אפשר להזין רק שם אחד לכל לוקאל (שילוב של שפה ומדינה).
titleEIDR	טקסט	מומלץ מאוד למה? ‫– מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית או המופשטת ביותר יצירה קולנועית או טלוויזיונית. ‫ לדוגמה, מזהה EIDR של שם התוכן בעונה הראשונה של סדרת הטלוויזיה 'משחקי הכס' הוא ‎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	חובה אם רלוונטי – אובייקט של תג עיצוב של פעולה שמספק את הפרטים של הפעולה. אם התוכן זמין ב'סרטון על פי דרישה' (VoD), צריך לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן. אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ. תוכן TVSeason יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה. כדי לציין קישורי עומק שונים בכמה אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
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	‫[Person או PerformingGroup או PerformanceRole	מומלץ מאוד למה? מערך של חברי צוות השחקנים בעונה. כאן אפשר לקרוא הנחיות לגבי יצירת מודלים.
director	Person	מומלץ מאוד למה? מערך של במאי התוכנית.
producer	ארגון או אדם	מומלץ מאוד למה? המפיקים של העונה.
image	ImageObject	התמונות שקשורות ל-TVSeason. פרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול בתג 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 = Dialogue (דיאלוג),‏ FV = Fantasy Violence (אלימות פנטזיה),‏ L = Language (שפה),‏ S = Sexual Content (תוכן מיני),‏ V = Violence (אלימות).

מפרטים של משתמש

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

נכס	הסוג הנדרש	תיאור
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 במאפיין actor בכל מקום בפיד. לדוגמה, אם יש שני סרטים שמופיע בהם אותו שחקן, הערך של @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 במאפיין actor בכל מקום בפיד. לדוגמה, אם יש שני סרטים שמופיע בהם אותו שחקן, הערך של @id צריך להיות זהה בשני אובייקטי השחקן האלה.
actor.name	טקסט	חובה – שם השחקן או השחקנית, או שם חבר צוות או קבוצת המופיעים.
actor.sameAs	כתובת URL	מומלץ מאוד למה? ‫- כתובת URL לדף אינטרנט שאפשר לזהות בו את השחקן או את קבוצת המבצעים. לדוגמה, דף ויקיפדיה של השחקן. הערך הזה צריך להיות שונה מהערך של המאפיין actor.@id.

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

כדי להשתמש בערכים האלה, הערך של actor.@type צריך להיות Person.

ערך של roleName	תיאור
‫“Cameo”	תפקיד קמע, שנקרא גם הופעת קמע, הוא הופעה קצרה של אדם מוכר ביצירה של אומנויות הבמה.
‪"VoiceActor"	ביצוע קולי הוא ביצוע שבו נעשה שימוש בקול של השחקן, אבל השחקן לא מופיע על המסך. השימוש הנפוץ ביותר הוא באנימציה, אבל הוא מתרחש גם כשמדובבים את הקול של שחקן אחד על פני הדיבור של שחקן אחר.
‫"Double" (כפול)	כפיל הוא אדם שמחליף שחקן אחר כך שהפנים של האדם לא מוצגות.
"MotionCaptureActor"	המונח MotionCaptureActor מתייחס לאדם שמקליט פעולות של שחקנים אנושיים, ומשתמש במידע הזה כדי להנפיש מודלים של דמויות דיגיטליות באנימציה ממוחשבת דו-ממדית או תלת-ממדית.

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

ערך של roleName	תיאור
‫"Actor" (שחקן)	שחקן או שחקנית הם אנשים שמגלמים דמות בהצגה במדיום המסורתי של התיאטרון או במדיה מודרנית כמו סרטים, רדיו וטלוויזיה.
‫"GuestStar"	"כוכב אורח הוא שחקן שמגלם תפקיד בדיוני ומופיע בפרק אחד או בכמה פרקים. במקרים מסוימים, כוכב אורח יכול לגלם דמות חשובה שחוזרת על עצמה ולהופיע פעמים רבות בסדרה, למרות שהוא לא חבר בצוות השחקנים הראשי. מגדירים את הערך GuestStar אם יש שחקן אורח בתוכנית או אם השחקן הוא אורח בתוכנית. צריך לציין שחקנים אורחים רק ברמת הפרק, ולא ברמת סדרת הטלוויזיה.
‫"Guest"‏ (אורח)	‫"A guest on a talk show. שימו לב: התפקיד 'כוכב אורח' הוא תפקיד בדיוני, אבל ההופעה של 'אורח' היא לא בדיונית.
‫"Announcer" (קריין)	הכרוז הוא האדם שאומר את דברי הפתיחה והסיום של התוכנית, מציג את המארח, המתמודדים או האורחים המפורסמים, מתאר את הפרסים שזמינים ומבדר את הקהל לפני הצילומים ובמהלך ההפסקות.
'מגיב'	פרשן מספק פרשנות בזמן אמת למשחק או לאירוע, בדרך כלל במהלך שידור חי.
‫"Impressionist"	חקיין הוא אמן שהמופע שלו כולל חיקוי של צלילים, קולות והתנהגויות של סלבריטאים ודמויות מצוירות.
‫"Host" ‏(מארח)	אדם שמציג או מארח תוכניות טלוויזיה, ולעתים קרובות משמש כמתווך בין התוכנית לבין הקהל. התפקיד 'מארח' הוא בדרך כלל תפקיד לא בדיוני.
"CoHost"	אדם שמארח אירוע או תוכנית יחד עם אדם או אנשים אחרים.
‫"GuestHost"	מארח אורח הוא מארח, בדרך כלל של תוכנית אירוח, שמארח את התוכנית במקום המארח הקבוע כשהוא לא זמין.
‫"Newscaster" ‏(מגיש חדשות)	אדם שמציג מידע לציבור על חדשות ואירועים שמתרחשים ברמה המקומית, הארצית והבינלאומית באמצעות תוכנית חדשות בטלוויזיה.
"התכתבות"	כתב או כתבת בשטח הם בדרך כלל עיתונאים או פרשנים של מגזין, או סוכנים ששולחים דוחות לעיתון, לחדשות ברדיו או בטלוויזיה, או לחברה מסוג אחר, ממיקום מרוחק, שלעתים קרובות נמצא במרחק רב.
‫"ShowJudge"‏ (הצגת שופט)	שופט הוא אדם שנחשב למומחה בתחום שבו עוסקת התוכנית, והוא מקבל את התפקיד של "שופט" כדי לבקר את המתמודדים שנבחנים ומשתתפים בתחרות של סדרת הטלוויזיה.
"משתתף בפאנל"	חבר בוועדת דיון או בוועדה מייעצת של פאנל רדיו או טלוויזיה.
‫"Contestant" (מתמודד)	משתתף בתחרות או בתוכנית משחק הוא אדם שלוקח בה חלק.
‫"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"
  }
]

דפים קשורים

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

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