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

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

טבלת מפרט של SportsEvent

מאפיין (property) הסוג הנדרש תיאור
@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 טקסט חובה – שם האירוע הזה.
  • ניתן להשתמש במערך כדי להציג את השמות בשפות שונות. דוגמה למספר אזורים ושפות.
  • לתשומת ליבכם: יש תמיכה בשם אחד בלבד לכל מקום (צמד שפה-מדינה).
description טקסט תיאור האירוע הזה. 300 תווים, משרד למשרד. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
sport כתובת URL חובה קישור לדף ויקיפדיה (עדיף גרסה באנגלית) של ספורט הספורט.
startDate DateTime או Date חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן. לתשומת ליבך, זוהי שעת ההתחלה בפועל של האירוע, ולא כאשר האירוע משודר בטלוויזיה.
endDate DateTime או Date שעת הסיום של האירוע בפורמט ISO 8601, עם אזור זמן.
homeTeam SportsTeam מומלץ מאוד למה? הצוות הראשי של האירוע.
homeTeam.name טקסט חובה השם המלא של קבוצת הספורט.
homeTeam.sport כתובת URL חובה קישור לדף ויקיפדיה (עדיף גרסה באנגלית) של ספורט הספורט.
homeTeam.sameAs כתובת URL מומלץ מאוד למה? כתובת אתר של דף אינטרנט להתייחסות שיכול לזהות את הצוות. לדוגמה, דף הוויקיפדיה של הצוות.
homeTeam.athlete אדם הערות לגבי ספורטאי יחיד בקבוצה.
homeTeam.athlete.name טקסט השם המלא של הספורטאי.
homeTeam.parentOrganization.name SportsOrganization חובה שם ליגת הספורט שבה הקבוצה חברה. למשל, איגוד הכדורסל הלאומי או ה-Major League Baseball. שימו לב: אסור להשתמש בשדה הזה בשיחת הוועידה של הצוות.
homeTeam.parentOrganization.sameAs כתובת URL מומלץ מאוד למה? כתובת URL של דף אינטרנט שיכול לזהות את הליגה של הקבוצה. לדוגמה, דף הוויקיפדיה של הליגה.
awayTeam SportsTeam מומלץ מאוד למה? צוות החקירה של האירוע. המאפיינים זהים ל-SportsEvent.homeTeam.
competitor SportsTeam או אדם מומלץ מאוד למה? אם הקבוצה הביתית או הקבוצה 'לא בבית' לא רלוונטית (למשל, קרב אגרוף או האולימפיאדה), יש לציין את המשתתפים כמתחרים. אם הערך הוא SportsTeam, המאפיינים זהים ל-SportsEvent.homeTeam. אם Person, המאפיינים זהים לאובייקטיםPerson אחרים. למשל, שחקן ב-Movie.
location מקום או עיר מיקום האירוע.
location.name טקסט חובה – שם המיקום.
location.address PostalAddress חובה אם סוג @של המיקום הוא מקום – כתובת המיקום. אין להשתמש באפשרות הזו אם סוג ה-@ של המיקום הוא 'עיר'
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). כדי לציין את קישור העומק לאירוע בשידור חי, צריך להשתמש במקום זאת בנכס publishedOn או potentialAction ב-BroadcastEvent.
identifier PropertyValue מומלץ מאוד למה? - מזהה חיצוני או מזהה אחר שמזהה את הישות הזו באופן חד-משמעי. ניתן להשתמש במספר מזהים. פרטים נוספים זמינים בקטע מאפיינים של מזהים.

דוגמאות לאירועי ספורט

דוגמה 1

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

דוגמה 2

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

מאפיין (property) הסוג הנדרש תיאור
@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 טקסט חובה – שם האירוע הזה.
  • ניתן להשתמש במערך כדי להציג את השמות בשפות שונות. דוגמה למספר אזורים ושפות.
  • לתשומת ליבכם: יש תמיכה בשם אחד בלבד לכל מקום (צמד שפה-מדינה).
description טקסט תיאור האירוע. 300 תווים, משרד למשרד. משתמשים במערך כדי לכלול את התיאורים בכמה שפות ובאורכים שונים.
attendee ארגון או אדם אדם או ארגון שמשתתפים באירוע.
startDate תאריך חובה – שעת ההתחלה של האירוע בפורמט ISO 8601 עם אזור זמן.
endDate תאריך שעת הסיום של האירוע בפורמט ISO 8601, עם אזור זמן.
composer ארגון או אדם האדם או הארגון שכתבו יצירה, או המלחין של יצירה שבוצעה באירוע מסוים.
performer ארגון או אדם חובה – אמן באירוע. לדוגמה, מנחה, מוזיקאי, להקה או שחקן.
subEvent אירוע אירוע ששייך לאירוע הזה. לדוגמה, אירוע כנס כולל הרבה מצגות, וכל אחת מהן היא אירוע משנה של הכנס.
superEvent אירוע אירוע שהאירוע הזה הוא חלק ממנו. לדוגמה, אוסף של הופעות מוזיקה נפרדות יכול לכלול פסטיבל מוזיקה כאירוע-על.
location מקום או עיר חובה – מיקום האירוע.
location.name טקסט חובה – שם המיקום.
location.address PostalAddress חובה אם סוג @של המיקום הוא מקום – כתובת המיקום. אין להשתמש באפשרות הזו אם ה- @type של המיקום הוא 'עיר'.
location.address.streetAddress טקסט הרחוב של המיקום.
location.address.addressLocality טקסט העיר שבה נמצא המיקום.
location.address.addressRegion טקסט המצב של המיקום.
location.address.postalCode טקסט המיקוד שרלוונטי למיקום.
location.address.addressCountry טקסט המדינות בפורמט ISO 3166.
workPerformed CreativeWork יצירה שהוצגה באירוע מסוים, למשל, הצגה שהוצגה ב-GaetEvent.

דוגמה ל-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"
  }
}

טבלת מפרט לאירוע

מאפיין (property) הסוג הנדרש תיאור
@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 טקסט חובה – שם האירוע הזה.
  • ניתן להשתמש במערך כדי להציג את השמות בשפות שונות. דוגמה למספר אזורים ושפות.
  • לתשומת ליבכם: יש תמיכה בשם אחד בלבד לכל מקום (צמד שפה-מדינה).
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 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 של המיקום הוא 'עיר'
location.address.streetAddress טקסט הרחוב של המיקום.
location.address.addressLocality טקסט העיר שבה נמצא המיקום.
location.address.addressRegion טקסט המצב של המיקום.
location.address.postalCode טקסט המיקוד שרלוונטי למיקום.
location.address.addressCountry טקסט המדינות בפורמט ISO 3166.
workPerformed CreativeWork יצירה שהוצגה באירוע מסוים, למשל, הצגה שהוצגה ב-GaetEvent.

דוגמה לאירוע

אירוע

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