ویژگی‌های نشانه‌گذاری محتوا رویدادها، ویژگی‌های نشانه‌گذاری محتوا رویدادها

این بخش جزئیات ویژگی‌های نشانه‌گذاری محتوا را برای نوع موجودیت مرتبط با Event ارائه می‌دهد.

جدول مشخصات رویدادهای ورزشی

ملک نوع مورد انتظار توضیحات
@context متن الزامی - همیشه روی ["http://schema.org", {"@language": "xx"}] تنظیم شود
  • xx با کد زبان نهاد در قالب BCP 47 جایگزین کنید، به عنوان مثال، "en".
@type متن الزامی - همیشه روی SportsEvent تنظیم شود.
@id آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • ایستا؛ شناسه باید پایدار باشد و با گذشت زمان تغییر نکند (حتی اگر ویژگی url مربوط به show تغییر کند). با آن به عنوان یک رشته مبهم رفتار می‌شود و لازم نیست یک لینک فعال باشد.
  • به شکل شناسه منبع یکپارچه (URI)
  • دامنه‌ای که برای مقدار @id استفاده می‌شود باید متعلق به سازمان شما باشد.
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
name متن الزامی - نام این رویداد.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال مناطق و زبان‌های چندگانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
description متن توضیحات این رویداد. محدودیت ۳۰۰ کاراکتری. از یک آرایه برای گنجاندن توضیحات به زبان‌ها و طول‌های مختلف استفاده کنید.
sport آدرس اینترنتی الزامی است. لینکی به صفحه ویکی‌پدیا (نسخه انگلیسی ترجیح داده می‌شود) مربوط به آن ورزش.
startDate تاریخ/زمان یا تاریخ الزامی - زمان شروع رویداد در قالب ISO 8601 به همراه منطقه زمانی. لطفاً توجه داشته باشید که این زمان شروع واقعی رویداد است، نه زمان پخش رویداد از تلویزیون.
endDate تاریخ/زمان یا تاریخ زمان پایان رویداد در قالب ISO 8601 به همراه منطقه زمانی.
homeTeam تیم ورزشی اکیداً توصیه می‌شود. چرا؟ تیم میزبان این رویداد.
homeTeam.name متن نام کامل تیم ورزشی الزامی است .
homeTeam.sport آدرس اینترنتی الزامی است. لینکی به صفحه ویکی‌پدیا (نسخه انگلیسی ترجیح داده می‌شود) مربوط به آن ورزش.
homeTeam.sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ یک URL به یک صفحه وب مرجع که بتواند تیم را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای تیم.
homeTeam.athlete شخص حاشیه‌نویسی (یا توضیحات) برای یک ورزشکار به صورت انفرادی در تیم.
homeTeam.athlete.name متن نام کامل ورزشکار.
homeTeam.parentOrganization.name سازمان ورزشی الزامی نام لیگ ورزشی که تیم عضو آن است. برای مثال، انجمن ملی بسکتبال یا لیگ برتر بیسبال. توجه داشته باشید که این زمین نباید برای کنفرانس تیم استفاده شود.
homeTeam.parentOrganization.sameAs آدرس اینترنتی اکیداً توصیه می‌شود. چرا؟ یک URL به یک صفحه وب مرجع که بتواند لیگ تیم را شناسایی کند؛ برای مثال، صفحه ویکی‌پدیای آن لیگ.
awayTeam تیم ورزشی اکیداً توصیه می‌شود. چرا؟ تیم مهمان رویداد. ویژگی‌ها مشابه SportsEvent.homeTeam هستند.
competitor تیم یا شخص ورزشی اکیداً توصیه می‌شود. چرا؟ اگر تیم میزبان یا میهمان قابل اجرا نباشد (مثلاً مسابقه بوکس، المپیک)، شرکت‌کنندگان را به عنوان رقیب مشخص کنید. اگر SportsTeam ، ویژگی‌ها مشابه SportsEvent.homeTeam هستند. اگر Person ، ویژگی‌ها مشابه سایر اشیاء Person هستند؛ به عنوان مثال، یک بازیگر در Movie .
location مکان یا شهر محل برگزاری رویداد.
location.name متن الزامی - نام مکان.
location.address آدرس پستی اگر @type مکان، برابر با Place باشد، الزامی است - آدرس مکان. اگر @type مکان، برابر با City باشد، نباید از این استفاده شود.
location.address.streetAddress متن آدرس خیابان محل.
location.address.addressLocality متن شهر محل سکونت.
location.address.addressRegion متن وضعیت محل.
location.address.postalCode متن کد پستی محل.
location.address.addressCountry متن کشورها در قالب ISO 3166 .
image شیء تصویر مورد نیاز برای گوگل تی‌وی - تصویر(های) مربوط به رویداد. توصیه می‌شود که به عنوان پوستر یا بنر رسمی رویداد استفاده شود. برای جزئیات بیشتر در مورد ویژگی‌های مورد نیاز و اختیاری که باید همراه image باشند، به ویژگی‌های تصویر مراجعه کنید.
potentialAction تماشا کنید در صورت لزوم - لینک عمیقی که ویدیوی ضبط شده این رویداد ورزشی را در Video on Demand پخش می‌کند. برای مشخص کردن لینک عمیق برای یک رویداد زنده، به جای آن از ویژگی publishedOn یا potentialAction در BroadcastEvent استفاده کنید.
identifier ارزش ملک اکیداً توصیه می‌شود. چرا؟ - شناسه خارجی یا شناسه دیگری که به طور واضح این موجودیت را شناسایی کند. استفاده از چندین شناسه مجاز است. برای جزئیات بیشتر به بخش ویژگی‌های شناسه مراجعه کنید.

نمونه‌های رویدادهای ورزشی

مثال ورزش تیمی

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

رویدادهای ورزشی با محدودیت‌های 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 آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • استاتیک
  • به شکل شناسه منبع یکپارچه (URI)
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
name متن الزامی - نام این رویداد.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال مناطق و زبان‌های چندگانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
description متن شرح رویداد. محدودیت ۳۰۰ کاراکتری. از یک آرایه برای گنجاندن توضیحات به زبان‌ها و طول‌های مختلف استفاده کنید.
attendee سازمان یا شخص شخص یا سازمانی که در این رویداد شرکت می‌کند.
startDate تاریخ الزامی - زمان شروع رویداد در قالب ISO 8601 به همراه منطقه زمانی.
endDate تاریخ زمان پایان رویداد در قالب ISO 8601 به همراه منطقه زمانی.
composer سازمان یا شخص شخص یا سازمانی که اثری را نوشته، یا آهنگساز اثری است که در رویدادی اجرا شده است.
performer سازمان یا شخص الزامی - یک اجراکننده در رویداد - برای مثال، یک مجری، یک نوازنده، گروه موسیقی یا بازیگر.
subEvent رویداد رویدادی که بخشی از این رویداد است. به عنوان مثال، یک رویداد کنفرانس شامل ارائه‌های زیادی است که هر کدام یک رویداد فرعی از کنفرانس هستند.
superEvent رویداد رویدادی که این رویداد بخشی از آن است. برای مثال، مجموعه‌ای از اجراهای موسیقی منفرد ممکن است هر کدام یک جشنواره موسیقی به عنوان رویداد برتر خود داشته باشند.
location مکان یا شهر الزامی - محل برگزاری رویداد.
location.name متن الزامی - نام مکان.
location.address آدرس پستی الزامی است اگر @type مکان، برابر با Place باشد - آدرس مکان. اگر @type مکان، برابر با City باشد، نباید از این استفاده شود.
location.address.streetAddress متن آدرس خیابان محل.
location.address.addressLocality متن شهر محل سکونت.
location.address.addressRegion متن وضعیت محل.
location.address.postalCode متن کد پستی محل.
location.address.addressCountry متن کشورها در قالب ISO 3166 .
workPerformed کار خلاقانه اثری که در یک رویداد اجرا شده است، مثلاً نمایشی که در یک تئاتر اجرا می‌شود.

مثال رویداد موسیقی

رویداد موسیقی

{
  "@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 آدرس اینترنتی الزامی - شناسه محتوا در قالب URI؛ برای مثال، https://example.com/1234abc .
@id باید شرایط زیر را داشته باشد:
  • منحصر به فرد در سطح جهانی در سراسر کاتالوگ شما
  • استاتیک
  • به شکل شناسه منبع یکپارچه (URI)
از آنجا که url یک موجودیت تمام الزامات را به عنوان یک شناسه برآورده می‌کند، توصیه می‌کنیم url یک موجودیت به صورت @id استفاده کنید. برای جزئیات بیشتر به بخش شناسه مراجعه کنید.
name متن الزامی - نام این رویداد.
  • از یک آرایه برای فهرست کردن نام‌ها به زبان‌های مختلف استفاده کنید. به مثال مناطق و زبان‌های چندگانه مراجعه کنید.
  • توجه داشته باشید که فقط یک نام برای هر منطقه (جفت زبان-کشور) پشتیبانی می‌شود.
description متن شرح رویداد. محدودیت ۳۰۰ کاراکتری. از یک آرایه برای گنجاندن توضیحات به زبان‌ها و طول‌های مختلف استفاده کنید.
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 روی ۲۰ سال از تاریخ فعلی تنظیم کنید.
releasedEvent.publishedBy سازمان یا شخص اختیاری - سازمان یا شخصی که این موجودیت را منتشر کرده است.
location مکان یا شهر الزامی - مکان رویداد. توجه داشته باشید که می‌توانید Place در سطح City وارد کنید.
location.name متن الزامی - نام مکان.
location.address آدرس پستی الزامی است اگر location@type برابر با Place باشد - آدرس مکان. اگر location@type برابر با City باشد، نباید از این استفاده شود.
location.address.streetAddress متن آدرس خیابان محل.
location.address.addressLocality متن شهر محل سکونت.
location.address.addressRegion متن وضعیت محل.
location.address.postalCode متن کد پستی محل.
location.address.addressCountry متن کشورها در قالب ISO 3166 .
workPerformed کار خلاقانه اثری که در یک رویداد اجرا شده است، مثلاً نمایشی که در یک تئاتر اجرا می‌شود.

مثال رویداد

رویداد

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