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

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

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

טבלת מפרט

TVSeries

נכס הסוג הצפוי תיאור
@context טקסט חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
  • איפה" xx" שמייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות בסיסית צריך להשתמש ב- @language ובפורמט BCP 47 לקוד השפה המתאים. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות הם בספרדית, גם אם שפת הכתוביות היא אנגלית.
@type טקסט חובה – תמיד מוגדר לערך TVSeries.
@id כתובת URL חובה – מזהה התוכן בפורמט URI; לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלך
  • המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאבים מאוחד (URI)
  • הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון.
מכיוון שה-url של ישות עומד בכל הדרישות כמזהה, אנחנו ממליצים להשתמש ב-url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
url כתובת URL חובהכתובת ה-URL הקנונית של התוכן, ש-Google משתמשת בה כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.
url חייבת לעמוד בדרישות הבאות:
  • url חייב להיות ייחודי בכל העולם
  • url חייבת להכיל כתובת URL קנונית פעילה ש-Google יכולה לסרוק.
לקישור העומק של הפעלה, כדאי לעיין במאפיין urlTemplate של אובייקט היעד.
name טקסט חובה – שם התוכנית.
  • להשתמש במערך כדי להציג את השמות בשפות שונות. אפשר לעיין בדוגמה במספר אזורים ושפות.
  • לתשומת ליבכם: אפשר להזין רק שם אחד לכל לוקאל (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה.

לדוגמה, titleEIDR של סדרת הטלוויזיה שנקראת 'משחקי הכס' הוא '10.5240/C1B5-3BA1-8991-A571-8472-W'.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה.
  • אם התוכן זמין ב-Video על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ.
  • המכשיר TVSeries יכול להיות זמין ב-VoD וגם ב-LiveTV.
שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. אפשר לעיין בדוגמה במספר אזורים ושפות.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL של דף עזר שיכול לזהות את התוכנית. לדוגמה, את דף התוכנית בוויקיפדיה. הערך הזה חייב להיות שונה מהמאפיין url.
inLanguage טקסט השפה המקורית של הסדרה בפורמט BCP 47.
genre טקסט רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords טקסט מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
releasedEvent PublicationEvent, FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט.

בנוסף, צריך להשתמש ב-FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה.

ExclusiveEvent מציין שלשירות יש זכויות הפצה בלעדיות ולכלול איפה ומתי.

יש פרטים ודוגמאות בקטע לדוגמה.
releasedEvent.@type טקסט חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location מדינה חובה – האזורים שמשויכים לאירוע הזה.

אם מדובר ב-PublicationEvent, זהו האזור שבו התוכן פורסם.

בFeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי.

יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH.
releasedEvent.startDate Date או DateTime מומלץחובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות.

בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע.

עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate Date או DateTime מומלץחובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.

בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן.

ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.

אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description טקסט מומלץ מאוד למה? תקציר של התוכנית. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים.
actor אדם או PerformingGroup או PerformanceRole מומלץ מאוד למה? מערך של צוות השחקנים בסדרה. תוכלו למצוא הנחיות לבניית מודלים כאן.
director אדם מומלץ מאוד למה? מנהלי התוכנית.
producer ארגון או אדם מומלץ מאוד למה? מפיקי התוכנית.
image ImageObject חובה ב-Google TV – התמונות שקשורות ל-TVSeries. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות.
trailer.description טקסט תיאור הטריילר. ראו את הדוגמה של הטריילר.
trailer.inLanguage טקסט השפה של הטריילר בפורמט BCP 47.
trailer.url כתובת URL כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים רלוונטיים.
trailer.regionsAllowed מקום האזורים שבהם מותר לפרסם מדיה. אם לא מציינים זאת, ההנחה היא שמותר להשתמש בו בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה באופן חד-משמעי את הישות הזו. אפשר לציין מספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהים.
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ניקוד שבו Google משתמשת, ובאותות אחרים, כדי לקבוע איזו מדיה להציג למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מסוימת מוגדר כ-0.
popularityScore.@type טקסט תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value מספר ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ניקוד גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion מדינה אזורים שבהם רלוונטי דירוג הפופולריות. אם ציון הפופולריות רלוונטי בכל העולם, צריך להגדיר את הערך EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH.
Note: פופולריות ספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
review ביקורות בדיקת סיווגי התוכן של סדרת הטלוויזיה
review.reviewRating דירוג חובה אם צוין review המאפיין הזה משמש לציון הדירוג שניתן בביקורת.
contentRating טקסט או דירוג חובה עבור תוכן למבוגרים בלבד, מומלץ מאוד אחרת – סיווג תוכן כולל. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, יתקבלו שתי וריאציות:
  • סוכנות הדירוג הוסיפה את הדירוג עם רווח לבן באמצע. לדוגמה, המספר "TV-MA" דירוג מהסוכנות "TVPG" בארה"ב צריכים להיות מתוארים כ-"TVPG TV-MA". לעיון ברשימת הסוכנויות
  • ערך של 'RATING NOT KNOWN' (לא תלוי-רישיות) כדי לציין שאתם לא יודעים מה הסיווג של התוכן.
contentRating.author ארגון חובה אם contentRating משתמש בערך Rating – השם של סוכנות הדירוג. רשימה של סוכנויות סיווג מאושרות של סוכנויות לדירוג תוכן
contentRating.ratingValue טקסט חובה אם contentRating משתמש ב-Rating – ערך הדירוג.
contentRating.advisoryCode טקסט קוד ההתרעה של התוכן. הערכים הקבילים כוללים: D, FV, L, S ו-V. D = דו-שיח, FV = אלימות בפנטזיה , L = שפה, S = תוכן מיני, V = אלימות.

TVEpisode

נכס הסוג הצפוי תיאור
@context טקסט חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
  • איפה" xx" שמייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות בסיסית צריך להשתמש ב- @language ובפורמט BCP 47 לקוד השפה המתאים. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות הם בספרדית, גם אם שפת הכתוביות היא אנגלית.
@type טקסט חובה – תמיד מוגדר לערך TVEpisode.
@id כתובת URL חובה – מזהה התוכן בפורמט URI; לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלך
  • המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאבים מאוחד (URI)
  • הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון.
מכיוון שה-url של ישות עומד בכל הדרישות כמזהה, אנחנו ממליצים להשתמש ב-url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
url כתובת URL חובהכתובת ה-URL הקנונית של התוכן, ש-Google משתמשת בה כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.
url חייבת לעמוד בדרישות הבאות:
  • url חייב להיות ייחודי בכל העולם
  • url חייבת להכיל כתובת URL קנונית פעילה ש-Google יכולה לסרוק.
לקישור העומק של הפעלה, כדאי לעיין במאפיין urlTemplate של אובייקט היעד.
name טקסט חובה – שם הפרק.
  • להשתמש במערך כדי להציג את השמות בשפות שונות. אפשר לראות דוגמה לייצוג במספר שפות.
  • לתשומת ליבכם: אפשר להזין רק שם אחד לכל לוקאל (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה.

לדוגמה: שם EIDR של הפרק הראשון של העונה הראשונה של סדרת TVSeries שנקרא 'Game of Thrones' הוא '10.5240/B6A6-1B32-B5E5-D5CB-6B84-X'.
editEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג מהדורה ספציפית של יצירה או סרט טלוויזיה.

לדוגמה, הפרק הראשון של העונה הראשונה של TVSeries בשם 'Game of Thrones', ששם EIDR שלו הוא "10.5240/B6A6-1B32-B5E5-D5CB-6B84-X", כולל עריכה אחת, למשל: "10.5240/FB97-C847-2969-D0AB-ECD1-C".

titleEIDR הוא מאפיין חובה כשמציינים EditEIDR.
inLanguage טקסט השפה המקורית של הסדרה בפורמט BCP 47.
episodeNumber Integer נדרש – המספר שמציין את מיקום הפרק לפי סדר הפרקים בעונה. צריך להפעיל מחדש את episodeNumber לכל עונה. כלומר, הפרק הראשון של כל עונה צריך להיות 1.
partOfSeason TVSeason חובה – עונת הטלוויזיה שאליה שייך הפרק הזה.

גם אם ל-TVEpisode אין TVSeason תואם, עדיין צריך לספק את המאפיינים של partOfSeason.@id ו-partOfSeason.seasonNumber. פתרון זמני הוא:
  • לוקחים את הפקודה partofSeries.@id (לדוגמה, http://www.example.com/my_favorite_tv_show) ומצרפים שדה שאילתה של placeholder (לדוגמה, ?SEASON1) כדי ליצור partOfSeason.@id ייחודי (לדוגמה, http://www.example.com/my_favorite_tv_show? season1).
  • מגדירים את partOfSeason.seasonNumber ל-1.
partOfSeason.@type טקסט חובה – תמיד מוגדר לערך TVSeason.
partOfSeason.@id כתובת URL חובה@id מתוך TVSeason שהפרק הזה חלק ממנו.
partOfSeason.seasonNumber Integer חובה – המספר שמציין את מיקום העונה לפי סדר העונות בסדרת הטלוויזיה.
partOfSeries TVSeries חובה – סדרת הטלוויזיה שאליה שייך הפרק הזה.
partOfSeries.@type טקסט חובה – תמיד מוגדר לערך TVSeries.
partOfSeries.@id כתובת URL חובה@id מתוך TVSeries שהפרק הזה חלק ממנו.
partOfSeries.name טקסט חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs טקסט כתובת URL של דף עזר שיכול לזהות את התוכנית. לדוגמה, את דף התוכנית בוויקיפדיה. הערך הזה חייב להיות שונה מהמאפיין url.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה.
  • אם התוכן זמין ב-Video על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ.
  • המכשיר TVEpisode יכול להיות זמין ב-VoD וגם ב-LiveTV.
שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. אפשר לעיין בדוגמה במספר אזורים ושפות.
sameAs מומלץ מאוד למה? כתובת URL כתובת URL של דף אינטרנט שיכול לזהות את הפרק. לדוגמה, דף הוויקיפדיה של הפרק. הערך הזה חייב להיות שונה מהמאפיין url.
duration משך הקורס אורך הפרק בפורמט ISO 8601. יש להשתמש בפורמט: "PT00H00M".
releasedEvent PublicationEvent, FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט.

בנוסף, צריך להשתמש ב-FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה.

ExclusiveEvent מציין שלשירות יש זכויות הפצה בלעדיות ולציין איפה ומתי.

אפשר למצוא פרטים ודוגמאות בקטע לדוגמה.
releasedEvent.@type טקסט חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location מדינה חובה – האזורים שמשויכים לאירוע הזה.

אם מדובר ב-PublicationEvent, זהו האזור שבו התוכן פורסם.

בFeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי.

יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH.
releasedEvent.startDate Date או DateTime מומלץחובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות.

בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע.

עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate Date או DateTime מומלץחובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.

בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן.

ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.

אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description טקסט מומלץ מאוד למה? תקציר של הפרק. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים.
  • אפשר להשתמש במערך כדי לסמן את התיאור בכמה שפות. אפשר לראות דוגמה לייצוג במספר שפות.
genre טקסט רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords טקסט מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
actor אדם או PerformingGroup או PerformanceRole מומלץ מאוד למה? מערך של צוות השחקנים של הפרק. תוכלו למצוא הנחיות לבניית מודלים כאן.
director אדם מומלץ מאוד למה? במאי הפרק.
producer ארגון או אדם מומלץ מאוד למה? מפיקי העונה.
image ImageObject מומלץ מאוד למה? ל-Google TV – תמונות שונות שקשורות לפרק ב-TV. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות.
trailer.description טקסט תיאור הטריילר. ראו את הדוגמה של הטריילר.
trailer.inLanguage טקסט השפה של הטריילר בפורמט BCP 47.
trailer.url כתובת URL כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים רלוונטיים.
trailer.regionsAllowed מקום האזורים שבהם מותר לפרסם מדיה. אם לא מציינים זאת, ההנחה היא שמותר להשתמש בו בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
review ביקורות בדיקת סיווגי התוכן של הפרק בסדרת הטלוויזיה
review.reviewRating דירוג חובה אם צוין review המאפיין הזה משמש לציון הדירוג שניתן בביקורת.
contentRating טקסט או דירוג חובה עבור תוכן למבוגרים בלבד, מומלץ מאוד אחרת – סיווג תוכן כולל. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, יתקבלו שתי וריאציות:
  • סוכנות הדירוג הוסיפה את הדירוג עם רווח לבן באמצע. לדוגמה, המספר "TV-MA" דירוג מהסוכנות "TVPG" בארה"ב צריכים להיות מתוארים כ-"TVPG TV-MA". לעיון ברשימת הסוכנויות
  • ערך של 'RATING NOT KNOWN' (לא תלוי-רישיות) כדי לציין שאתם לא יודעים מה הסיווג של התוכן.
contentRating.author ארגון חובה אם contentRating משתמש בערך Rating – השם של סוכנות הדירוג. רשימה של סוכנויות סיווג מאושרות של סוכנויות לדירוג תוכן
contentRating.ratingValue טקסט חובה אם contentRating משתמש ב-Rating – ערך הדירוג.
contentRating.advisoryCode טקסט קוד ההתרעה של התוכן. הערכים הקבילים כוללים: D, FV, L, S ו-V. D = דו-שיח, FV = אלימות בפנטזיה , L = שפה, S = תוכן מיני, V = אלימות.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה באופן חד-משמעי את הישות הזו. אפשר לציין מספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהים.
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ניקוד שבו Google משתמשת, ובאותות אחרים, כדי לקבוע איזו מדיה להציג למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מסוימת מוגדר כ-0.
popularityScore.@type טקסט תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value מספר ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ניקוד גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion מדינה אזורים שבהם רלוונטי דירוג הפופולריות. אם ציון הפופולריות רלוונטי בכל העולם, צריך להגדיר את הערך EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH.
Note: פופולריות ספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)

TVSeason

נכס הסוג הצפוי תיאור
@context טקסט חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
  • איפה" xx" שמייצג את השפה של המחרוזות בפיד. בכל הקשר של ישות בסיסית צריך להשתמש ב- @language ובפורמט BCP 47 לקוד השפה המתאים. לדוגמה, אם השפה מוגדרת לספרדית, ההנחה היא שהשמות הם בספרדית, גם אם שפת הכתוביות היא אנגלית.
@type טקסט חובה – תמיד מוגדר לערך TVSeason.
@id כתובת URL חובה – מזהה התוכן בפורמט URI; לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלך
  • המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית משתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאבים מאוחד (URI)
  • הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון.
מכיוון שה-url של ישות עומד בכל הדרישות כמזהה, אנחנו ממליצים להשתמש ב-url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
url כתובת URL חובהכתובת ה-URL הקנונית של התוכן, ש-Google משתמשת בה כדי להתאים את התוכן בפיד לתוכן במסדי הנתונים של Google.
url חייבת לעמוד בדרישות הבאות:
  • url חייב להיות ייחודי בכל העולם
  • url חייבת להכיל כתובת URL קנונית פעילה ש-Google יכולה לסרוק.
לקישור העומק של הפעלה, כדאי לעיין במאפיין urlTemplate של אובייקט היעד.
name טקסט חובה – שם העונה של תוכנית הטלוויזיה.
  • להשתמש במערך כדי להציג את השמות בשפות שונות. אפשר לראות דוגמה לייצוג במספר שפות.
  • לתשומת ליבכם: אפשר להזין רק שם אחד לכל לוקאל (צמד שפה-מדינה).
titleEIDR טקסט מומלץ מאוד למה? - מזהה EIDR (Entertainment Identifier Registry) שמייצג ברמה הכללית/המופשטת ביותר יצירת סרטים או תוכן בטלוויזיה.

לדוגמה: titleEIDR לעונה הראשונה של סדרת TVSeries בשם 'משחקי הכס' הוא 10.5240/FD91-C72C-4161-FCBA-058B-1.
seasonNumber Integer חובה – המספר שמציין את מיקום העונה לפי סדר העונות בסדרת הטלוויזיה.
partOfSeries TVSeries חובה – סדרת הטלוויזיה שאליה שייכת העונה הזו.
partOfSeries.@type טקסט חובה – תמיד מוגדר לערך TVSeries.
partOfSeries.@id כתובת URL חובה – ה@id של TVSeries שהעונה הזו נכללת בהם.
partOfSeries.name טקסט חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs טקסט כתובת URL של דף עזר שיכול לזהות את התוכנית. לדוגמה, את דף התוכנית בוויקיפדיה. הערך הזה חייב להיות שונה מהמאפיין url.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את פרטי הפעולה.
  • אם התוכן זמין ב-Video על פי דרישה (VoD), הנכס הזה נדרש. אובייקט תגי העיצוב של הפעולה צריך לספק את קישור העומק של התוכן.
  • אם התוכן זמין בערוץ LiveTV, הנכס הזה הוא אופציונלי. הישות BroadcastService המשויכת מספקת במקום זאת את קישור העומק של הערוץ.
  • המכשיר TVSeason יכול להיות זמין ב-VoD וגם ב-LiveTV.
שימוש במערך כדי לציין קישורי עומק שונים במספר אזורים. אפשר לעיין בדוגמה במספר אזורים ושפות.
sameAs כתובת URL מומלץ מאוד למה? כתובת URL של דף אינטרנט שיכול לזהות את העונה. לדוגמה, דף ויקיפדיה של העונה. הערך הזה חייב להיות שונה מהמאפיין url.
releasedEvent PublicationEvent, FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - PublicationEvent משמש לציון ההוצאה המקורית (גלובלית או מקומית) של תוכן שמוציא לאור יוצר, למשל תאריך ההפצה המקורי של סרט.

בנוסף, צריך להשתמש ב-FeaturedEvent כדי לציין שהשירות משווק את התוכן הזה בתור תוכן מקורי, מוצג, מיוחד וכן הלאה.

ExclusiveEvent מציין שלשירות שלך יש זכויות הפצה בלעדיות והוא כולל איפה ומתי.

יש פרטים ודוגמאות בקטע לדוגמה.
releasedEvent.@type טקסט חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location מדינה חובה – האזורים שמשויכים לאירוע הזה.

אם מדובר ב-PublicationEvent, זהו האזור שבו התוכן פורסם.

בFeaturedEvent ובExclusiveEvent, זהו האזור שבו התוכן מוצג או בלעדי.

יש להשתמש בקודי ISO 3166 למדינות. כדי לציין בכל מקום בעולם, צריך להגדיר את הערך EARTH.
releasedEvent.startDate Date או DateTime מומלץחובה עבור ExclusiveEvent – תאריך ההתחלה של הפרסום של הישות.

בPublicationEvent, תאריך הפרסום הראשוני של הישות הזו הוא תאריך הפרסום הראשוני של הישות הזו, למשל התאריך שבו סרט יצא לראשונה בבתי קולנוע.

עבור ExclusiveEvent ו-FeaturedEvent, תאריך ההתחלה של התאריך שבו הישות הייתה בלעדית או מוצגת.
releasedEvent.endDate Date או DateTime מומלץחובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.

בExclusiveEvent, הערך הזה מייצג את התאריך שבו פג התוקף של הזכויות על התוכן.

ב-FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.

אם התוכן מוצג או בלעדי תמיד, צריך להגדיר את endDate ל-20 שנים מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמו את הישות הזו.
description טקסט מומלץ מאוד למה? תקציר העונה. תקצירי עלילה עדיפים על סיכומים עובדתיים. עד 300 תווים.
  • אפשר להשתמש במערך כדי לסמן את התיאור בכמה שפות. אפשר לראות דוגמה לייצוג במספר שפות.
actor [אדם או PerformingGroup או PerformanceRole מומלץ מאוד למה? מערך של צוות השחקנים של העונה. תוכלו למצוא הנחיות לבניית מודלים כאן.
director אדם מומלץ מאוד למה? מערך של מנהלי התוכנית.
producer ארגון או אדם מומלץ מאוד למה? מפיקי העונה.
image ImageObject התמונות שקשורות לעונה בטלוויזיה. למידע נוסף על המאפיינים הנדרשים והאופציונליים שצריך לכלול עם image, ראו מאפייני תמונות.
genre טקסט רשימה ממוינת של כל הז'אנרים הרלוונטיים. לדוגמה : ["Action", "Fashion", "Environment", "Football"]
keywords טקסט מילות המפתח או התגים שמשמשים לתיאור התוכן הזה. מותר גם להשתמש במערך מילות מפתח. לדוגמה, המילה ["תכונה, ביוגרפיה"] יכולה להיות מערך של מילות מפתח שמתארות את התוכן.
trailer.description טקסט תיאור הטריילר. ראו את הדוגמה של הטריילר.
trailer.inLanguage טקסט השפה של הטריילר בפורמט BCP 47.
trailer.url כתובת URL כתובת URL של טריילר שמתארח באופן ציבורי והועלה על ידי אולפני ההפקה או מקורות מורשים רלוונטיים.
trailer.regionsAllowed מקום האזורים שבהם מותר לפרסם מדיה. אם לא מציינים זאת, ההנחה היא שמותר להשתמש בו בכל מקום. יש לציין את המדינות בפורמט ISO 3166.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה באופן חד-משמעי את הישות הזו. אפשר לציין מספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהים.
popularityScore PopularityScoreSpecification מומלץ מאוד למה? ניקוד שבו Google משתמשת, ובאותות אחרים, כדי לקבוע איזו מדיה להציג למשתמשים. הציון הזה מייצג את הפופולריות של התוכן ביחס לתוכן אחר בקטלוג שלכם. לכן, סולם הציון צריך להיות עקבי בכל הפידים שלכם, בין כל הישויות בקטלוג. כברירת מחדל, ציון הפופולריות של ישות מסוימת מוגדר כ-0.
popularityScore.@type טקסט תמיד מוגדר ל-PopularityScoreSpecification.
popularityScore.value מספר ערך מספרי לא שלילי שמציין את הפופולריות של הישות. ניקוד גבוה יותר פירושו פופולריות גבוהה יותר.
popularityScore.eligibleRegion מדינה אזורים שבהם רלוונטי דירוג הפופולריות. אם ציון הפופולריות רלוונטי בכל העולם, צריך להגדיר את הערך EARTH. כברירת מחדל, הנכס הזה מוגדר ל-EARTH.
Note: פופולריות ספציפית ללוקאל מקבלת עדיפות על פני הפופולריות הגלובלית (EARTH)
review ביקורות בדיקת סיווגי התוכן לעונה של תוכנית טלוויזיה
review.reviewRating דירוג חובה אם צוין review המאפיין הזה משמש לציון הדירוג שניתן בביקורת.
contentRating טקסט או דירוג חובה עבור תוכן למבוגרים בלבד, מומלץ מאוד אחרת – סיווג תוכן כולל. אם סיווג התוכן ניתן בפורמט של מחרוזת טקסט, יתקבלו שתי וריאציות:
  • סוכנות הדירוג הוסיפה את הדירוג עם רווח לבן באמצע. לדוגמה, המספר "TV-MA" דירוג מהסוכנות "TVPG" בארה"ב צריכים להיות מתוארים כ-"TVPG TV-MA". לעיון ברשימת הסוכנויות
  • ערך של 'RATING NOT KNOWN' (לא תלוי-רישיות) כדי לציין שאתם לא יודעים מה הסיווג של התוכן.
contentRating.author ארגון חובה אם contentRating משתמש בערך Rating – השם של סוכנות הדירוג. רשימה של סוכנויות סיווג מאושרות של סוכנויות לדירוג תוכן
contentRating.ratingValue טקסט חובה אם contentRating משתמש ב-Rating – ערך הדירוג.
contentRating.advisoryCode טקסט קוד ההתרעה של התוכן. הערכים הקבילים כוללים: D, FV, L, S ו-V. D = דו-שיח, FV = אלימות בפנטזיה , L = שפה, S = תוכן מיני, V = אלימות.

מפרטי השחקנים

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

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

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

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

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

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

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

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

שימוש בסוג PerformanceRole

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

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

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

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

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

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

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

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

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

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

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

דוגמאות

דוגמאות TVSeries, TVEpisode ו-TVSeason

TVSeries

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

TVEpisode

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

TVSeason

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

דוגמאות לנכסים של Actor

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

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

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

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

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

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

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

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

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

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