Thuộc tính đánh dấu nội dung của sự kiện

Phần này cung cấp thông tin chi tiết về các thuộc tính đánh dấu nội dung cho loại thực thể có liên quan Event.

Bảng quy cách SportsEvent

Thuộc tính Loại dự kiến Mô tả
@context Văn bản Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}]
  • Thay thế xx bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "en".
@type Văn bản Bắt buộc – Luôn đặt thành SportsEvent.
@id URL Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.
@id phải đáp ứng các yêu cầu sau:
  • Riêng biệt trên toàn cầu trong danh mục của bạn
  • Cố định; Mã này phải là giá trị cố định và không thay đổi theo thời gian (ngay cả khi thuộc tính url của chương trình thay đổi). URL này sẽ được coi là một chuỗi nguyên vẹn và không cần phải là một đường liên kết đang hoạt động.
  • Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
  • Miền mà bạn dùng cho giá trị @id phải thuộc sở hữu của tổ chức của bạn.
url của một thực thể đáp ứng mọi yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
name Văn bản Bắt buộc – Tên của sự kiện này.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ chỉ hỗ trợ một tên (cặp ngôn ngữ-quốc gia).
description Văn bản Nội dung mô tả về sự kiện này. Giới hạn 300 ký tự. Sử dụng một mảng để đưa nội dung mô tả bằng nhiều ngôn ngữ và độ dài.
sport URL Bắt buộc Đường liên kết đến trang Wikipedia (nên dùng phiên bản tiếng Anh) của môn thể thao.
startDate DateTime hoặc Date Bắt buộc – Thời gian bắt đầu của sự kiện ở định dạng ISO 8601 có múi giờ. Xin lưu ý rằng đây là thời gian bắt đầu thực tế của sự kiện, chứ không phải thời điểm sự kiện được phát sóng trên truyền hình.
endDate DateTime hoặc Date Thời gian kết thúc của sự kiện ở định dạng ISO 8601 có múi giờ.
homeTeam SportsTeam Rất nên dùng Lý do? Đội nhà của sự kiện.
homeTeam.name Văn bản Bắt buộc Tên đầy đủ của đội thể thao.
homeTeam.sport URL Bắt buộc Đường liên kết đến trang Wikipedia (nên dùng phiên bản tiếng Anh) của môn thể thao.
homeTeam.sameAs URL Rất nên dùng Lý do? URL của một trang web tham khảo có thể xác định đội; ví dụ: trang Wikipedia của đội.
homeTeam.athlete Person (Người) (Các) chú thích cho từng vận động viên trong đội.
homeTeam.athlete.name Văn bản Họ tên đầy đủ của vận động viên.
homeTeam.parentOrganization.name SportsOrganization Bắt buộc Tên của giải đấu thể thao mà đội tham gia. Ví dụ: Hiệp hội Bóng rổ Quốc gia hoặc Giải bóng chày nhà nghề. Xin lưu ý rằng bạn không nên sử dụng trường này cho hội nghị của nhóm.
homeTeam.parentOrganization.sameAs URL Rất nên dùng Lý do? URL của một trang web tham khảo có thể xác định giải đấu của đội; ví dụ: trang Wikipedia của giải đấu.
awayTeam SportsTeam Rất nên dùng Lý do? Đội khách của sự kiện. Các thuộc tính này giống với SportsEvent.homeTeam.
competitor SportsTeam (Đội thể thao) hoặc Person (Người) Rất nên dùng Lý do? Nếu đội nhà hoặc đội khách không áp dụng (ví dụ: trận đấu quyền anh, Thế vận hội), hãy chỉ định người tham gia là đối thủ. Nếu SportsTeam, các thuộc tính này giống như SportsEvent.homeTeam. Nếu Person, các thuộc tính này giống với các đối tượng Person khác; chẳng hạn như một diễn viên trong Movie.
location Địa điểm HOẶC Thành phố Địa điểm diễn ra sự kiện.
location.name Văn bản Bắt buộc – Tên của vị trí.
location.address PostalAddress Bắt buộc nếu @type vị trí là Địa điểm – Địa chỉ của vị trí. Bạn không nên sử dụng thuộc tính này nếu @type vị trí là Thành phố
location.address.streetAddress Văn bản Địa chỉ đường phố của vị trí.
location.address.addressLocality Văn bản Thành phố của vị trí.
location.address.addressRegion Văn bản Tiểu bang của vị trí.
location.address.postalCode Văn bản Mã bưu chính của vị trí.
location.address.addressCountry Văn bản Các quốc gia ở định dạng ISO 3166.
image ImageObject (Đối tượng hình ảnh) Bắt buộc đối với Google TV – (Các) hình ảnh liên quan đến sự kiện. Nên là hình ảnh chính thức trên áp phích hoặc biểu ngữ của sự kiện. Để biết thêm thông tin chi tiết về các thuộc tính bắt buộc và không bắt buộc cần thêm vào image, hãy xem Thuộc tính hình ảnh.
potentialAction WatchAction Bắt buộc nếu có thể áp dụng – Đường liên kết sâu phát bản ghi hình của sự kiện thể thao này theo yêu cầu. Để chỉ định đường liên kết sâu cho một sự kiện phát trực tiếp, hãy dùng thuộc tính publishedOn hoặc potentialAction trong BroadcastEvent.
identifier PropertyValue Rất nên dùng Lý do? – Giá trị nhận dạng bên ngoài hoặc giá trị nhận dạng khác giúp xác định rõ ràng thực thể này. Bạn được phép sử dụng nhiều giá trị nhận dạng. Hãy xem phần Thuộc tính của giá trị nhận dạng để biết thông tin chi tiết.

Ví dụ về SportsEvent

Ví dụ về thể thao đồng đội

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

Ví dụ về thể thao cá nhân

{
  "@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 có các quy định hạn chế về 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"
            ]
          },
        ]
      }
    }
  ]
}

Bảng quy cách MusicEvent

Thuộc tính Loại dự kiến Mô tả
@context Văn bản Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}]
  • Thay thế xx bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "en".
@type Văn bản Bắt buộc – Luôn đặt thành MusicEvent.
@id URL Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.
@id phải đáp ứng các yêu cầu sau:
  • Riêng biệt trên toàn cầu trong danh mục của bạn
  • Tĩnh
  • Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
url của một thực thể đáp ứng mọi yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
name Văn bản Bắt buộc – Tên của sự kiện này.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ chỉ hỗ trợ một tên (cặp ngôn ngữ-quốc gia).
description Văn bản Nội dung mô tả về sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để đưa nội dung mô tả bằng nhiều ngôn ngữ và độ dài.
attendee Organization (Tổ chức) hoặc Person (Người) Một người hoặc tổ chức tham dự sự kiện.
startDate Ngày Bắt buộc – Thời gian bắt đầu của sự kiện ở định dạng ISO 8601 có múi giờ.
endDate Ngày Thời gian kết thúc của sự kiện ở định dạng ISO 8601 có múi giờ.
composer Organization (Tổ chức) hoặc Person (Người) Người hoặc tổ chức đã viết một bản sáng tác hoặc là nhà soạn nhạc của một tác phẩm được biểu diễn tại một sự kiện nào đó.
performer Organization (Tổ chức) hoặc Person (Người) Bắt buộc – Một người biểu diễn tại sự kiện, chẳng hạn như người trình bày, nghệ sĩ âm nhạc, nhóm nhạc hoặc diễn viên.
subEvent Sự kiện Một Sự kiện nằm trong sự kiện này. Ví dụ: một sự kiện hội nghị bao gồm nhiều bài thuyết trình, mỗi bài thuyết trình là một subEvent của hội nghị.
superEvent Sự kiện Một sự kiện mà sự kiện này là một phần của sự kiện đó. Ví dụ: một bộ sưu tập các buổi biểu diễn âm nhạc riêng lẻ có thể có một lễ hội âm nhạc làm superEvent.
location Địa điểm HOẶC Thành phố Bắt buộc – Địa điểm diễn ra sự kiện.
location.name Văn bản Bắt buộc – Tên của vị trí.
location.address PostalAddress Bắt buộc nếu @type vị trí là Địa điểm – Địa chỉ của vị trí. Bạn không nên sử dụng thuộc tính này nếu @type vị trí là Thành phố.
location.address.streetAddress Văn bản Địa chỉ đường phố của vị trí.
location.address.addressLocality Văn bản Thành phố của vị trí.
location.address.addressRegion Văn bản Tiểu bang của vị trí.
location.address.postalCode Văn bản Mã bưu chính của vị trí.
location.address.addressCountry Văn bản Các quốc gia ở định dạng ISO 3166.
workPerformed CreativeWork (Tác phẩm sáng tạo) Một tác phẩm được biểu diễn trong một sự kiện nào đó, ví dụ: một vở kịch được biểu diễn trong một TheaterEvent.

Ví dụ về 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"
  }
}

Bảng quy cách sự kiện

Thuộc tính Loại dự kiến Mô tả
@context Văn bản Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}]
  • Thay thế xx bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "en".
@type Văn bản Bắt buộc – Luôn đặt thành Event.
@id URL Bắt buộc – Giá trị nhận dạng của nội dung ở định dạng URI; ví dụ: https://example.com/1234abc.
@id phải đáp ứng các yêu cầu sau:
  • Riêng biệt trên toàn cầu trong danh mục của bạn
  • Tĩnh
  • Dưới dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
url của một thực thể đáp ứng mọi yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của thực thể làm @id. Hãy xem phần Giá trị nhận dạng để biết thêm thông tin chi tiết.
name Văn bản Bắt buộc – Tên của sự kiện này.
  • Sử dụng một mảng để liệt kê tên bằng nhiều ngôn ngữ. Hãy xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ chỉ hỗ trợ một tên (cặp ngôn ngữ-quốc gia).
description Văn bản Nội dung mô tả về sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để đưa nội dung mô tả bằng nhiều ngôn ngữ và độ dài.
attendee Organization (Tổ chức) hoặc Person (Người) Một người hoặc tổ chức tham dự sự kiện.
startDate Ngày Bắt buộc – Thời gian bắt đầu của sự kiện ở định dạng ISO 8601 có múi giờ.
endDate Ngày Thời gian kết thúc của sự kiện ở định dạng ISO 8601 có múi giờ.
subEvent Sự kiện Một Sự kiện nằm trong sự kiện này. Ví dụ: một sự kiện hội nghị bao gồm nhiều bài thuyết trình, mỗi bài thuyết trình là một subEvent của hội nghị.
superEvent Sự kiện Một sự kiện mà sự kiện này là một phần của sự kiện đó. Ví dụ: một bộ sưu tập các buổi biểu diễn âm nhạc riêng lẻ có thể có một lễ hội âm nhạc làm superEvent.
releasedEvent PublicationEvent, FeaturedEvent hoặc ExclusiveEvent Rất nên dùng Lý do?PublicationEvent được dùng để chỉ định lần phát hành nội dung ban đầu (trên toàn cầu hoặc tại địa phương) của một nhà xuất bản, chẳng hạn như ngày phát hành ban đầu của một bộ phim tại rạp.

Ngoài ra, hãy dùng FeaturedEvent để cho biết dịch vụ của bạn tiếp thị nội dung này là nội dung gốc, nội dung nổi bật, nội dung đặc biệt, v.v.

ExclusiveEvent chỉ định rằng dịch vụ của bạn có độc quyền phân phối nội dung này, đồng thời cho biết địa điểm và thời gian.

Hãy xem phần ví dụ để biết thông tin chi tiết và ví dụ.
releasedEvent.@type Văn bản Bắt buộc – Nhớ luôn đặt thuộc tính này thành một trong các giá trị sau:
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
releasedEvent.location Quốc gia Bắt buộc – Khu vực được liên kết với sự kiện này.

Đối với PublicationEvent, đây là khu vực nơi nội dung được xuất bản.

Đối với FeaturedEventExclusiveEvent, đây là khu vực nơi nội dung được xuất hiện nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để cho biết ở mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Được đề xuấtBắt buộc đối với ExclusiveEvent – Ngày bắt đầu xuất bản của thực thể.

Đối với PublicationEvent, ngày này biểu thị ngày phát hành ban đầu của thực thể này, chẳng hạn như ngày một bộ phim được phát hành lần đầu tại rạp chiếu phim.

Đối với ExclusiveEventFeaturedEvent, ngày này biểu thị ngày bắt đầu khi thực thể được độc quyền hoặc xuất hiện nổi bật.
releasedEvent.endDate Date (Ngày tháng) hoặc DateTime (Ngày giờ) Nên dùngBắt buộc đối với ExclusiveEvent – Thuộc tính này chỉ áp dụng cho các loại ExclusiveEventFeaturedEvent.

Đối với ExclusiveEvent, thuộc tính này thể hiện ngày hết hạn quyền đối với nội dung.

Đối với FeaturedEvent, thuộc tính này thể hiện ngày cuối cùng mà nhà cung cấp giới thiệu thực thể.

Nếu nội dung độc quyền hoặc được giới thiệu vĩnh viễn, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization (Tổ chức) hoặc Person (Người) Không bắt buộc – Tổ chức hoặc người đã xuất bản thực thể này.
location Địa điểm HOẶC Thành phố Bắt buộc – Địa điểm diễn ra sự kiện. Xin lưu ý rằng bạn có thể cung cấp Place ở cấp City.
location.name Văn bản Bắt buộc – Tên của vị trí.
location.address PostalAddress Bắt buộc nếu @type vị trí là Địa điểm – Địa chỉ của vị trí. Bạn không nên sử dụng thuộc tính này nếu @type của vị trí là Thành phố
location.address.streetAddress Văn bản Địa chỉ đường phố của vị trí.
location.address.addressLocality Văn bản Thành phố của vị trí.
location.address.addressRegion Văn bản Tiểu bang của vị trí.
location.address.postalCode Văn bản Mã bưu chính của vị trí.
location.address.addressCountry Văn bản Các quốc gia ở định dạng ISO 3166.
workPerformed CreativeWork (Tác phẩm sáng tạo) Một tác phẩm được biểu diễn trong một sự kiện nào đó, ví dụ: một vở kịch được biểu diễn trong một TheaterEvent.

Ví dụ về sự kiện

Sự kiện

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