מאפייני תגי עיצוב של תוכן של אירועים

בקטע הזה מפורטים פרטי מאפייני ה-Markup של התוכן לסוג הישות הקשור Event.

טבלת המפרט של SportsEvent

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'iw'.
@type טקסט חובה – תמיד מוגדר ל-SportsEvent.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודיים ברמת הקטלוג
  • סטטי. המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם מאפיין כתובת ה-URL של התוכנית ישתנה). הוא ייחשב כמחרוזת אטומה ולא חייב להיות קישור פעיל.
  • כמזהה משאב אחיד (URI)
  • הדומיין שבו נעשה שימוש בערך @id חייב להיות בבעלות הארגון.
מכיוון שהשדה url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
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.name SportsOrganization חובה שם הליגה שבה הקבוצה משתתפת. לדוגמה, National Basketball Association או Major League Baseball. חשוב לזכור שאין להשתמש בשדה הזה לפגישה של הצוות.
homeTeam.parentOrganization.sameAs כתובת URL מומלץ מאוד למה? כתובת URL לדף אינטרנט של עזרה שיכול לזהות את הליגה של הקבוצה. לדוגמה, דף הליגה בוויקיפדיה.
awayTeam SportsTeam מומלץ מאוד למה? שם הקבוצה האורחת באירוע. המאפיינים זהים לאלה של SportsEvent.homeTeam.
competitor SportsTeam או Person מומלץ מאוד למה? אם אין קבוצת בית או קבוצת אורחים (למשל, קרב אגרוף, אולימפיאדה), צריך לציין את המשתתפים כמתחרים. אם SportsTeam, המאפיינים זהים למאפיינים של SportsEvent.homeTeam. אם הערך הוא Person, המאפיינים זהים לאלה של אובייקטים אחרים מסוג Person. לדוגמה, שחקן ב-Movie.
location מקום או עיר המיקום של האירוע.
location.name טקסט חובה – השם של המיקום.
location.address PostalAddress חובה אם ה-@type של המיקום הוא Place – הכתובת של המיקום. אין להשתמש באפשרות הזו אם הערך של location @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 חובה אם רלוונטי – קישור העומק שמפעיל את ההקלטה של אירוע הספורט הזה בסרטון על פי דרישה. כדי לציין את הקישור העומק של אירוע בשידור חי, צריך להשתמש במקום זאת במאפיין publishedOn או potentialAction ב-BroadcastEvent.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. מותר להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפייני מזהה.

דוגמאות ל-SportsEvent

דוגמה 1 דוגמה 2 
{
  "@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": "en",
      "@value": "2019 Professional Basketball, Game 6. Team A at Team B."
    }
  ],
  "startDate": "2018-09-16T21:10-08:00",
  "homeTeam":{
    "@type":"SportsTeam",
    "name":"Team B",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization":{
      "@type":"SportsOrganization",
      "name":"Professional Basketball League",
      "sameAs":"http://www.example.com/professional_basketball_league"
    }
    "athlete":[
      {
        "@type":"Person",
        "name":"John doe"
      }
    ]
  },
  "awayTeam":{
    "@type":"SportsTeam",
    "name":"Team A",
    "sport":"https://en.wikipedia.org/wiki/Basketball",
    "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":  "TMS ID of this game"
    }
  ]
}

{
  "@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",
  "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"
    }
  }
}

טבלת המפרט של MusicEvent

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'iw'.
@type טקסט חובה – תמיד מוגדר ל-MusicEvent.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודיים ברמת הקטלוג
  • סטטי
  • כמזהה משאב אחיד (URI)
מכיוון שהשדה url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם האירוע.
  • משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה מספר אזורים ושפות.
  • שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
description טקסט תיאור האירוע. מגבלה של 300 תווים. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
attendee ארגון או אדם אדם או ארגון שמשתתפים באירוע.
startDate ‫תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate ‫תאריך שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן.
composer ארגון או אדם האדם או הארגון שכתבו יצירה, או המלחין של יצירה שהוצגה באירוע כלשהו.
performer ארגון או אדם חובה – מבצע באירוע – לדוגמה, מנחה, מוזיקאי, קבוצה מוזיקלית או שחקן.
subEvent אירוע אירוע שהוא חלק מהאירוע הזה. לדוגמה, אירוע כנס כולל הרבה מצגות, שכל אחת מהן היא אירוע משנה של הכנס.
superEvent אירוע אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, אוסף של הופעות מוזיקה נפרדות יכול לכלול פסטיבל מוזיקה כאירוע-על.
location מקום או עיר חובה – המיקום של האירוע.
location.name טקסט חובה – השם של המיקום.
location.address PostalAddress חובה אם ה-@type של המיקום הוא Place – הכתובת של המיקום. אין להשתמש באפשרות הזו אם הערך של location @type הוא City.
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"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'iw'.
@type טקסט חובה – תמיד מוגדר ל-Event.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id חייב לעמוד בדרישות הבאות:
  • ייחודיים ברמת הקטלוג
  • סטטי
  • כמזהה משאב אחיד (URI)
מכיוון שהשדה url של ישות עומד בכל הדרישות כמזהה, מומלץ להשתמש בשדה url של הישות בתור @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם האירוע.
  • משתמשים במערך כדי לרשום את השמות בשפות שונות. ראו את הדוגמה מספר אזורים ושפות.
  • שימו לב: יש תמיכה רק בשם אחד לכל אזור (צמד שפה-מדינה).
description טקסט תיאור האירוע. מגבלה של 300 תווים. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
attendee ארגון או אדם אדם או ארגון שמשתתפים באירוע.
startDate ‫תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate ‫תאריך שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן.
subEvent אירוע אירוע שהוא חלק מהאירוע הזה. לדוגמה, אירוע כנס כולל הרבה מצגות, שכל אחת מהן היא אירוע משנה של הכנס.
superEvent אירוע אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, אוסף של הופעות מוזיקה נפרדות יכול לכלול פסטיבל מוזיקה כאירוע-על.
releasedEvent PublicationEvent,‏ FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? - הקוד PublicationEvent משמש לציון תאריך הפרסום המקורי (הגלובלי או המקומי) של תוכן על ידי בעל התוכן הדיגיטלי, למשל תאריך הפרסום המקורי של סרט בבתי הקולנוע.

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

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

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

באירוע מסוג PublicationEvent, זהו האזור שבו התוכן פורסם.

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

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

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

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

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

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

אם התוכן הוא בלעדי או מוצג לתמיד, צריך להגדיר את endDate ל-20 שנה מהתאריך הנוכחי.
releasedEvent.publishedBy ארגון או אדם אופציונלי – הארגון או האדם שפרסמתם את הישות הזו.
location מקום או עיר חובה – המיקום של האירוע. הערה: אפשר לספק את Place ברמת City.
location.name טקסט חובה – השם של המיקום.
location.address PostalAddress חובה אם ה-@type של המיקום הוא Place – הכתובת של המיקום. אין להשתמש באפשרות הזו אם הערך של location @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"
  }
}