בקטע הזה מפורטים המאפיינים של תגי העיצוב של התוכן שקשורים לסוג הישות Event.
טבלת המפרט של SportsEvent
| נכס | הסוג הצפוי | תיאור |
|---|---|---|
@context |
טקסט | חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר לערך SportsEvent. |
@id |
כתובת URL | חובה – מזהה התוכן בפורמט URI, לדוגמה: https://example.com/1234abc.@id צריך לעמוד בדרישות הבאות:
url ב-SportsEvent או ב-BroadcastEvent. לספק קישורים להפעלה באמצעות SportsEvent.potentialAction. פרטים נוספים זמינים בקטע מזהה. |
name |
טקסט | חובה – שם האירוע.
|
description |
טקסט | תיאור האירוע. מגבלת תווים של 300. כדי לכלול תיאורים בכמה שפות, צריך להשתמש במערך (תיאור אחד לכל שפה). |
sport |
כתובת URL | חובה קישור לדף של ענף הספורט בוויקיפדיה (עדיף בגרסה האנגלית). |
startDate |
DateTime או Date | חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן. חשוב לזכור: זו שעת ההתחלה בפועל של האירוע, ולא השעה שבה האירוע משודר בטלוויזיה. |
endDate |
DateTime או Date | מומלץ – שעת הסיום המתוכננת של האירוע בפורמט ISO 8601 עם אזור זמן. ציינו את שעת הסיום המתוכננת אם היא ידועה. אם שעת הסיום לא ידועה, השמיטו את המאפיין הזה במקום לספק פלייסהולדר משוער. |
homeTeam |
SportsTeam | מומלץ מאוד למה? הקבוצה המארחת באירוע. |
homeTeam.name |
טקסט | חובה השם המלא של קבוצת הספורט. |
homeTeam.sport |
כתובת URL | חובה קישור לדף של ענף הספורט בוויקיפדיה (עדיף בגרסה האנגלית). |
homeTeam.sameAs |
כתובת URL | מומלץ מאוד למה? כתובת URL של דף אינטרנט שמאפשר לזהות את הקבוצה, למשל דף הוויקיפדיה של הקבוצה. |
homeTeam.athlete |
אדם | הערות לגבי ספורטאי מסוים בקבוצה. |
homeTeam.athlete.name |
טקסט | השם המלא של הספורטאי. |
homeTeam.parentOrganization |
SportsOrganization | חובה – ליגת הספורט או הארגון המנהל שאליהם הקבוצה משתייכת. צריך לכלול את parentOrganization גם ב-homeTeam וגם ב-awayTeam כששתי הקבוצות מצוינות. |
homeTeam.parentOrganization.name |
טקסט | חובה – השם של ליגת הספורט שהקבוצה משתייכת אליה. לדוגמה, התאחדות הכדורסל הלאומית (NBA) או ליגת הבייסבול הבכירה (MLB). שימו לב: אין להשתמש בשדה הזה כדי לציין את הליגה של הקבוצה. |
homeTeam.parentOrganization.sameAs |
כתובת URL | מומלץ מאוד למה? - קישור לדף בוויקיפדיה (עדיף בגרסה האנגלית) שמזהה את הליגה של הקבוצה (לדוגמה, https://en.wikipedia.org/wiki/National_Basketball_Association). אין להשתמש בכתובות URL של פלייסהולדר example.com. |
awayTeam |
SportsTeam | מומלץ מאוד למה? - הקבוצה האורחת באירוע. המאפיינים והדרישות (כולל parentOrganization) זהים לאלה של SportsEvent.homeTeam. |
competitor |
SportsTeam או Person | מומלץ מאוד למה? אם אין קבוצה מארחת או קבוצה אורחת (למשל, קרב אגרוף, המשחקים האולימפיים), ציינו את המשתתפים כמתחרים. אם SportsTeam, המאפיינים זהים לאלה של SportsEvent.homeTeam. אם Person, המאפיינים זהים לאובייקטים אחרים של Person, למשל שחקן ב-Movie. |
location |
מקום או עיר | המיקום של האירוע. |
location.name |
טקסט | חובה – שם המיקום. |
location.address |
PostalAddress | חובה אם הערך של location @type הוא Place – הכתובת של המיקום. אין להשתמש בזה אם המיקום @type הוא City |
location.address.streetAddress |
טקסט | הרחוב של המיקום. |
location.address.addressLocality |
טקסט | העיר שבה נמצא המיקום. |
location.address.addressRegion |
טקסט | המדינה שבה נמצא המיקום. |
location.address.postalCode |
טקסט | המיקוד של המיקום. |
location.address.addressCountry |
טקסט | המדינות בפורמט ISO 3166. |
image |
ImageObject | חובה ב-Google TV – התמונות שקשורות לאירוע. מומלץ להשתמש בכרזה הרשמית או בגרפיקה של הכרזה של האירוע. לפרטים נוספים על המאפיינים הנדרשים והאופציונליים שצריך לכלול ב-image, ראו מאפייני תמונה. |
potentialAction |
WatchAction | חובה אם רלוונטי – קישורי עומק להפעלת אירוע הספורט, שמשמשים גם לשידורים חיים ללא ערוץ וגם לשידורים חוזרים של וידאו על פי דרישה (VOD). כל קישורי העומק לאירועי ספורט חייבים להיות ב-SportsEvent.potentialAction. אף פעם אל תמקמו את potentialAction ב-BroadcastEvent שמפנה אל SportsEvent (בשידורים של ערוצי טלוויזיה לינאריים ללא קישור עומק ישיר לאירוע, צריך לספק את קישור העומק לערוץ ב-BroadcastService.potentialAction). צריך לספק מערך של אובייקטים מסוג WatchAction כשמציעים כמה שידורים (כמו פיד אזורי, פיד של משחק בית או חוץ, או שידורים בכמה שפות) או חלונות נפרדים לשידור חי ולשידור חוזר של וידאו על פי דרישה. |
potentialAction.actionAccessibilityRequirement |
ActionAccessSpecification | חובה אם צוין potentialAction – מגדיר את ההרשאה ואת חלון הזמינות של הקישור (availabilityStarts ו-availabilityEnds) לכל WatchAction:
|
identifier |
PropertyValue | מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. אפשר להוסיף כמה מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה. |
דוגמאות ל-SportsEvent
דוגמה לספורט קבוצתי
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "SportsEvent",
"@id": "http://example.com/basketball/professional/final_game_6",
"name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"description": [
{
"@language": "en",
"@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
},
{
"@language": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "Jane Doe"
}
]
},
"location": {
"@type": "Place",
"name": "Example Stadium",
"address": {
"@type": "PostalAddress",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"postalCode": "94043",
"addressCountry": "US"
}
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "EP000194303282"
}
]
}
דוגמה לענפי ספורט אישי
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "SportsEvent",
"@id": "http://example.com/boxing/johndoe_vs_janedoe_2019",
"name": "2019 Professional Boxing - John Doe vs Jane Doe",
"sport": "https://en.wikipedia.org/wiki/Boxing",
"description": "World champion Jane Doe fights undefeated John Doe at the Example Arena in Mountain View, California.",
"startDate": "2019-07-12T21:10-08:00",
"endDate": "2019-07-12T23:30-08:00",
"competitor": [
{
"@type": "Person",
"name": "Jane Doe",
"birthDate": "1977-12-14",
"gender": "F",
"nationality": "US"
},
{
"@type": "Person",
"name": "John Doe",
"birthDate": "1978-10-17",
"gender": "M",
"nationality": "GB"
}
],
"location": {
"@type": "Place",
"name": "Example Arena",
"address": {
"@type": "PostalAddress",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"postalCode": "94043",
"addressCountry": "US"
}
}
}
SportsEvent עם הגבלות GeoShape
{
"@context": ["http://schema.org", {"@language": "en"}],
"@type": "SportsEvent",
"@id": "http://example.com/basketball/professional/final_game_6",
"name": "2019 Professional Basketball Finals, Game 6: Team A at Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"description": [
{
"@language": "en",
"@value": "Game 6 of the 2019 Professional Basketball Finals. Team A leads the series 3-2 against Team B."
},
{
"@language": "es",
"@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
}
],
"startDate": "2019-09-16T21:10-08:00",
"endDate": "2019-09-17T00:00-08:00",
"homeTeam": {
"@type": "SportsTeam",
"name": "Team B",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "John Doe"
}
]
},
"awayTeam": {
"@type": "SportsTeam",
"name": "Team A",
"sport": "https://en.wikipedia.org/wiki/Basketball",
"parentOrganization": {
"@type": "SportsOrganization",
"name": "Professional Basketball League",
"sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
},
"athlete": [
{
"@type": "Person",
"name": "Jane Doe"
}
]
},
"location": {
"@type": "Place",
"name": "Example Stadium",
"address": {
"@type": "PostalAddress",
"streetAddress": "1600 Amphitheatre Pkwy",
"addressLocality": "Mountain View",
"addressRegion": "CA",
"postalCode": "94043",
"addressCountry": "US"
}
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "TMS_ID",
"value": "EP000194303282"
}
],
"potentialAction": [
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
"inLanguage": "en",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "free",
"availabilityStarts": "2019-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
{
"@type": "WatchAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
"inLanguage": "en",
"actionPlatform": "http://schema.org/AndroidTVPlatform"
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "subscription",
"availabilityStarts": "2019-09-01T10:35:29Z",
"availabilityEnds": "2019-09-17T11:00:00Z",
"requiresSubscription": {
"@type": "MediaSubscription",
"name": "Example Package",
"commonTier": true,
"@id": "http://www.example.com/example_package"
},
"eligibleRegion": [
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
},
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "US",
"postalCode": [
"94120",
"94121"
]
}
]
}
}
]
}
טבלת המפרט של MusicEvent
| נכס | הסוג הצפוי | תיאור |
|---|---|---|
@context |
טקסט | חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר לערך MusicEvent. |
@id |
כתובת URL | חובה – מזהה התוכן בפורמט URI, לדוגמה: https://example.com/1234abc.@id צריך לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות של מזהה, מומלץ להשתמש במאפיין url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה. |
name |
טקסט | חובה – שם האירוע.
|
description |
טקסט | תיאור האירוע. מגבלה של 300 תווים. אפשר להשתמש במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים. |
attendee |
ארגון או אדם פרטי | אדם או ארגון שמשתתפים באירוע. |
startDate |
תאריך | חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן. |
endDate |
תאריך | שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן. |
composer |
ארגון או אדם פרטי | האדם או הארגון שכתבו יצירה מוזיקלית, או המלחין של יצירה שבוצעה באירוע כלשהו. |
performer |
ארגון או אדם פרטי | חובה – מי שמופיע באירוע, למשל: מנחה, מוזיקאי, להקה או שחקן. |
subEvent |
אירוע | אירוע שהוא חלק מהאירוע הזה. לדוגמה, אירוע של כנס כולל הרבה מצגות, וכל אחת מהן היא subEvent של הכנס. |
superEvent |
אירוע | אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, לאוסף של הופעות מוזיקה נפרדות יכול להיות פסטיבל מוזיקה בתור superEvent. |
location |
מקום או עיר | חובה – המיקום של האירוע. |
location.name |
טקסט | חובה – שם המיקום. |
location.address |
PostalAddress | חובה אם הערך של location @type הוא Place – הכתובת של המיקום. אין להשתמש בזה אם המיקום @type הוא עיר. |
location.address.streetAddress |
טקסט | הרחוב של המיקום. |
location.address.addressLocality |
טקסט | העיר שבה נמצא המיקום. |
location.address.addressRegion |
טקסט | המדינה שבה נמצא המיקום. |
location.address.postalCode |
טקסט | המיקוד של המיקום. |
location.address.addressCountry |
טקסט | המדינות בפורמט ISO 3166. |
workPerformed |
CreativeWork | יצירה שמוצגת באירוע מסוים, למשל מחזה שמוצג ב-TheaterEvent. |
דוגמה ל-MusicEvent
MusicEvent
{
"@context":"http://schema.org",
"@type":"MusicEvent",
"@id": "http://example.com/music/my_favortie_artist/2019_tour",
"name":"My Favorite Artist’s 2019 Homecoming Tour",
"description":"After 8 years off the music scene, My Favorite Artist is back with the Homecoming Tour.",
"startDate": "2014-10-12T21:10-08:00",
"location":{
"@type":"Place",
"name":"Example Arena",
"address":{
"@type":"PostalAddress",
"streetAddress":"1600 Amphitheatre Pkwy",
"addressLocality":"Mountain View",
"addressRegion":"CA",
"postalCode":"94043",
"addressCountry":"US"
}
},
"performer": {
"@type":"Person",
"name":"My Favorite Artist",
"birthDate":"1977-02-24",
"gender":"F",
"nationality":"CA"
}
}
טבלת מפרט האירועים
| נכס | הסוג הצפוי | תיאור |
|---|---|---|
@context |
טקסט | חובה – תמיד מוגדר לערך ["http://schema.org", {"@language": "xx"}]
|
@type |
טקסט | חובה – תמיד מוגדר לערך Event. |
@id |
כתובת URL | חובה – מזהה התוכן בפורמט URI, לדוגמה: https://example.com/1234abc.@id צריך לעמוד בדרישות הבאות:
url של ישות עומד בכל הדרישות של מזהה, מומלץ להשתמש במאפיין url של ישות בתור @id. פרטים נוספים זמינים בקטע מזהה. |
name |
טקסט | חובה – שם האירוע.
|
description |
טקסט | תיאור האירוע. מגבלה של 300 תווים. אפשר להשתמש במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים. |
attendee |
ארגון או אדם פרטי | אדם או ארגון שמשתתפים באירוע. |
startDate |
תאריך | חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן. |
endDate |
תאריך | שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן. |
subEvent |
אירוע | אירוע שהוא חלק מהאירוע הזה. לדוגמה, אירוע של כנס כולל הרבה מצגות, וכל אחת מהן היא subEvent של הכנס. |
superEvent |
אירוע | אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, לאוסף של הופעות מוזיקה נפרדות יכול להיות פסטיבל מוזיקה בתור superEvent. |
releasedEvent |
PublicationEvent, FeaturedEvent או ExclusiveEvent |
מומלץ מאוד למה? - השדה PublicationEvent משמש לציון ההשקה המקורית (הגלובלית או המקומית) של תוכן על ידי בעל תוכן דיגיטלי, כמו תאריך ההשקה המקורי של סרט בבתי קולנוע.בנוסף, אפשר להשתמש בשדה FeaturedEvent כדי לציין שהשירות שלך משווק את התוכן הזה כתוכן מקורי, מומלץ, מיוחד וכו'.השדה ExclusiveEvent מציין שלשירות שלך יש זכויות הפצה בלעדיות, וכולל את המיקום והמועד.פרטים ודוגמאות זמינים בקטע הדוגמאות. |
releasedEvent.@type |
טקסט | חובה – הקפידו תמיד להגדיר את המאפיין הזה לאחת מהאפשרויות הבאות:
|
releasedEvent.location |
מדינה | חובה – האזורים שמשויכים לאירוע הזה. ב- PublicationEvent, זה האזור שבו התוכן פורסם.ב- FeaturedEvent וב-ExclusiveEvent, זה האזור שבו התוכן מוצג או בלעדי.צריך להשתמש בקודי מדינות לפי תקן ISO 3166. כדי לציין את כל העולם, מגדירים את הערך EARTH. |
releasedEvent.startDate |
תאריך או DateTime | מומלץ – חובה עבור ExclusiveEvent – תאריך ההתחלה של פרסום הישות.עבור PublicationEvent, המאפיין הזה מציין את תאריך ההשקה הראשוני של הישות, למשל התאריך שבו הסרט הוקרן לראשונה בבתי הקולנוע.עבור ExclusiveEvent ו-FeaturedEvent, המאפיין הזה מייצג את תאריך ההתחלה שבו הישות בלעדית או מוצגת. |
releasedEvent.endDate |
Date או DateTime | מומלץ – חובה עבור ExclusiveEvent – רלוונטי רק לסוגים ExclusiveEvent ו-FeaturedEvent.עבור ExclusiveEvent, זה מייצג את התאריך שבו פג תוקף הזכויות על התוכן.עבור FeaturedEvent, זה מייצג את התאריך האחרון שבו הספק מציג את הישות.אם התוכן בלעדי או מוצג באופן קבוע, צריך להגדיר את endDate ל-20 שנה מהתאריך הנוכחי. |
releasedEvent.publishedBy |
ארגון או אדם פרטי | אופציונלי – הארגון או האדם שפרסמו את הישות הזו. |
location |
מקום או עיר | חובה – המיקום של האירוע. שימו לב שאפשר לספק Place ברמת City. |
location.name |
טקסט | חובה – שם המיקום. |
location.address |
PostalAddress | חובה אם הערך של location @type הוא Place – הכתובת של המיקום. אין להשתמש בזה אם המיקום @type הוא City |
location.address.streetAddress |
טקסט | הרחוב של המיקום. |
location.address.addressLocality |
טקסט | העיר שבה נמצא המיקום. |
location.address.addressRegion |
טקסט | המדינה שבה נמצא המיקום. |
location.address.postalCode |
טקסט | המיקוד של המיקום. |
location.address.addressCountry |
טקסט | המדינות בפורמט ISO 3166. |
workPerformed |
CreativeWork | יצירה שמוצגת באירוע מסוים, למשל מחזה שמוצג ב-TheaterEvent. |
דוגמה לאירוע
אירוע
{
"@context":"http://schema.org",
"@type":"Event",
"@id": "http://example.com/keynote/google_io_2019",
"name":"Google I/O 2019 keynote",
"description":"Google’s annual developer conference keynote event.",
"startDate": "2019-05-07T10:00-08:00",
"location":{
"@type":"Place",
"name":"Example Arena",
"address":{
"@type":"PostalAddress",
"streetAddress":"1600 Amphitheatre Pkwy",
"addressLocality":"Mountain View",
"addressRegion":"CA",
"postalCode":"94043",
"addressCountry":"US"
}
},
"attendee": {
"@type":"Person",
"name":"My Favorite Speaker",
"birthDate":"1971-12-02",
"gender":"F",
"nationality":"IN"
}
}