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

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

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

טבלת מפרט

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

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

לדוגמה, titleEIDR עבור TVSeries נקרא "Game of Thrones" הוא "10.5240/C1B5-3BA1-8991-A571-8472-W".
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון על פי דרישה' (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 שבו התוכן מוצג או בלעדי.

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

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

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

ב-ExclusiveEvent, זהו התאריך שבו הזכויות על התוכן פגות.

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

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

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

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

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

לדוגמה, הפרק הראשון של העונה הראשונה של TVSeries נקרא "Game of Thrones" והשם של הספר E&R;

titleEIDR יש לציין חובה בעת עריכת EE.
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 סדרות טלוויזיה חובה – סדרת הטלוויזיה שאליה משתייך הפרק.
partOfSeries.@type טקסט חובה – תמיד מוגדר ל-TVSeries.
partOfSeries.@id כתובת URL חובה@id מתוך TVSeries שהפרק הזה נכלל בהם.
partOfSeries.name טקסט חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs טקסט כתובת URL של דף אינטרנט שמזהה את התוכנית. לדוגמה, דף הוויקיפדיה של התוכנית. חייב להיות שונה מהנכס url.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון על פי דרישה' (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 שבו התוכן מוצג או בלעדי.

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

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

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

ב-ExclusiveEvent, זהו התאריך שבו הזכויות על התוכן פגות.

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

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

TVSeason

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

לדוגמה, titleEIDR לעונה הראשונה של TVSeries נקראת "Game of Thrones" היא "10.5240/FD91-C72C-4161-FCBA-058B-1".
seasonNumber Integer חובה – המספר שמציין את המיקום בעונה הזו לפי סדר העונות בסדרת הטלוויזיה.
partOfSeries סדרות טלוויזיה חובה – סדרת הטלוויזיה שאליה שייכת העונה הזו.
partOfSeries.@type טקסט חובה – תמיד מוגדר ל-TVSeries.
partOfSeries.@id כתובת URL חובה@id מה-TVSeries שהעונה הזו נכללת בהם.
partOfSeries.name טקסט חובה – השם של סדרת הטלוויזיה.
partOfSeries.sameAs טקסט כתובת URL של דף אינטרנט שמזהה את התוכנית. לדוגמה, דף הוויקיפדיה של התוכנית. חייב להיות שונה מהנכס url.
potentialAction WatchAction חובה אם רלוונטיאובייקט תגי עיצוב של פעולה שמספק את הפרטים של הפעולה.
  • אם התוכן זמין ב'סרטון על פי דרישה' (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 שבו התוכן מוצג או בלעדי.

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

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

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

ב-ExclusiveEvent, זהו התאריך שבו הזכויות על התוכן פגות.

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

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

דוגמאות

דוגמאות של TVSeries, TVEpisode ו-TVSeason.

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

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

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

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

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