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

בקטע הזה מפורטים מאפייני התוכן של תגי העיצוב עבור סוגי הישויות 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 חובה אם רלוונטי – אובייקט של תג Action שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון לפי דרישה' (VoD), חובה לציין את המאפיין הזה. אובייקט התיוג של הפעולה צריך לספק את הקישור העמוק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, המאפיין הזה הוא אופציונלי. במקומו, הישות המשויכת BroadcastService מספקת את הקישור העמוק של הערוץ.
  • תוכן TVSeries יכול להיות זמין גם ב-VoD וגם בשידור חי בטלוויזיה.
כדי לציין קישורי עומק שונים במספר אזורים, משתמשים במערך. אפשר לעיין בדוגמה Multiple regions and languages.
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 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 Number ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר.
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 חובה אם רלוונטי – אובייקט של תג Action שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון לפי דרישה' (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 Number ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר.
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 חובה אם רלוונטי – אובייקט של תג Action שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון לפי דרישה' (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 Number ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ציון גבוה יותר מציין פופולריות גבוהה יותר.
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 במאפיין השחקן בכל הפיד. לדוגמה, אם יש שני סרטים שמופיע בהם אותו שחקן, הערך של @id צריך להיות זהה בשני אובייקטי השחקן האלה.

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

שימוש בסוג PerformanceRole

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

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

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

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

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

הערכים האלה מחייבים שהערך של actor.@type יהיה Person.

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

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

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

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