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

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

טבלת מפרט של SportsEvent

נכס הסוג הנדרש תיאור
@context טקסט חובה – תמיד מוגדר ל-["http://schema.org", {"@language": "xx"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'en'.
@type טקסט חובה – תמיד מוגדר ל-SportsEvent.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id צריך לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלכם
  • סטטי; המזהה צריך להיות יציב ולא להשתנות לאורך זמן (גם אם כתובת ה-URL של התוכנית משתנה). המערכת תתייחס לערך הזה כמחרוזת אטומה, והוא לא חייב להיות קישור פעיל.
  • בפורמט של מזהה משאב אחיד (URI)
  • הדומיין שמשמש לערך ‎ @id חייב להיות בבעלות הארגון שלכם.
מכיוון שהערך url של ישות מסוימת עומד בכל הדרישות כמזהה, מומלץ להשתמש בערך url של ישות מסוימת כערך @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם האירוע.
  • משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages.
  • שימו לב: אפשר להשתמש רק בשם אחד לכל לוקאל (שילוב של שפה ואזור).
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 Person הערות על ספורטאי מסוים בקבוצה.
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 – כתובת המיקום. אין להשתמש בערך הזה אם המיקום @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

דוגמה לספורט קבוצתי 

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

‫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": "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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?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-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "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"}]
  • מחליפים את xx בקוד השפה של הישות בפורמט BCP 47, לדוגמה, 'en'.
@type טקסט חובה – תמיד מוגדר ל-MusicEvent.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id צריך לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלכם
  • סטטי
  • בפורמט של מזהה משאב אחיד (URI)
מכיוון שהערך url של ישות מסוימת עומד בכל הדרישות כמזהה, מומלץ להשתמש בערך url של ישות מסוימת כערך @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם האירוע.
  • משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages.
  • שימו לב: אפשר להשתמש רק בשם אחד לכל לוקאל (שילוב של שפה ואזור).
description טקסט תיאור האירוע. מגבלה של 300 תווים. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
attendee ארגון או אדם אדם או ארגון שמשתתפים באירוע.
startDate ‫תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate ‫תאריך שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן.
composer ארגון או אדם האדם או הארגון שכתבו יצירה מוזיקלית, או שהם המלחינים של יצירה שבוצעה באירוע מסוים.
performer ארגון או אדם חובה – אדם שמבצע באירוע, למשל מגיש, מוזיקאי, קבוצה מוזיקלית או שחקן.
subEvent אירוע אירוע שמשויך לאירוע הזה. לדוגמה, אירוע של כנס כולל הרבה מצגות, וכל אחת מהן היא subEvent של הכנס.
superEvent אירוע אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, יכול להיות שכל אחד מהמופעים המוזיקליים באוסף יהיה superEvent של פסטיבל מוזיקה.
location מקום או עיר חובה – המיקום של האירוע.
location.name טקסט חובה – שם המיקום.
location.address PostalAddress חובה אם הערך של המאפיין @type הוא Place – כתובת המיקום. אין להשתמש בערך הזה אם המיקום @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, לדוגמה, 'en'.
@type טקסט חובה – תמיד מוגדר ל-Event.
@id כתובת URL חובה – המזהה של התוכן בפורמט URI. לדוגמה, https://example.com/1234abc.
@id צריך לעמוד בדרישות הבאות:
  • ייחודי בכל העולם בקטלוג שלכם
  • סטטי
  • בפורמט של מזהה משאב אחיד (URI)
מכיוון שהערך url של ישות מסוימת עומד בכל הדרישות כמזהה, מומלץ להשתמש בערך url של ישות מסוימת כערך @id. פרטים נוספים זמינים בקטע מזהה.
name טקסט חובה – שם האירוע.
  • משתמשים במערך כדי לפרט את השמות בשפות שונות. אפשר לעיין בדוגמה Multiple regions and languages.
  • שימו לב: אפשר להשתמש רק בשם אחד לכל לוקאל (שילוב של שפה ואזור).
description טקסט תיאור האירוע. מגבלה של 300 תווים. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
attendee ארגון או אדם אדם או ארגון שמשתתפים באירוע.
startDate ‫תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate ‫תאריך שעת הסיום של האירוע בפורמט ISO 8601 עם אזור זמן.
subEvent אירוע אירוע שמשויך לאירוע הזה. לדוגמה, אירוע של כנס כולל הרבה מצגות, וכל אחת מהן היא subEvent של הכנס.
superEvent אירוע אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, יכול להיות שכל אחד מהמופעים המוזיקליים באוסף יהיה superEvent של פסטיבל מוזיקה.
releasedEvent ‫PublicationEvent,‏ FeaturedEvent או ExclusiveEvent מומלץ מאוד למה? ‫– PublicationEvent משמש לציון התוכן המקורי (גלובלי או מקומי) שפורסם על ידי בעל התוכן, כמו תאריך ההפצה המקורי של סרט בבתי קולנוע.

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

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

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

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

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

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

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

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

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

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

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