דף זה תורגם על ידי Cloud Translation API.

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

קטע זה מספק פרטים על מאפייני תגי העיצוב של סוגי הישויות 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"
    }
  ]
}

דפים קשורים

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