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ể liên quan Event.

Bảng thông số kỹ thuật của 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"}]
@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:
  • Duy nhất trên toàn cầu trong danh mục của bạn (và khác với @id của bất kỳ BroadcastEvent nào tham chiếu đến SportsEvent này)
  • Tĩnh; Giá trị này cũng phải ổn định và không thay đổi theo thời gian. URL này sẽ được coi là một chuỗi mờ và không cần phải là một đường liên kết đang hoạt động.
  • Ở 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.
Quan trọng: Đừng thêm thuộc tính url vào SportsEvent hoặc BroadcastEvent. Cung cấp đường liên kết phát bằng SportsEvent.potentialAction. 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ữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ hỗ trợ một tên.
description Văn bản Nội dung mô tả sự kiện này. Giới hạn 300 ký tự. Sử dụng một mảng để thêm nội dung mô tả bằng nhiều ngôn ngữ (mỗi ngôn ngữ một nội dung mô tả).
sport URL Bắt buộc Đường liên kết đến trang Wikipedia (ưu tiên 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 sự kiện theo định dạng ISO 8601 kèm theo 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 gian sự kiện được phát sóng trên TV.
endDate DateTime hoặc Date Nên dùng – Thời gian kết thúc dự kiến của sự kiện ở định dạng ISO 8601 kèm theo múi giờ. Cung cấp thời gian kết thúc theo lịch bất cứ khi nào biết; nếu không biết thời gian kết thúc, hãy bỏ qua thuộc tính này thay vì cung cấp một phần giữ chỗ ước tính.
homeTeam SportsTeam Rất nên dùng Tại sao? Độ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 (ưu tiên phiên bản tiếng Anh) của môn thể thao.
homeTeam.sameAs URL Rất nên dùng Tại sao? URL của một trang web tham khảo có thể xác định đội thể thao; ví dụ: trang Wikipedia của đội thể thao.
homeTeam.athlete Person (Người) (Các) chú thích cho một vận động viên trong đội.
homeTeam.athlete.name Văn bản Tên đầy đủ của vận động viên.
homeTeam.parentOrganization SportsOrganization Bắt buộc – Giải đấu thể thao hoặc tổ chức quản lý mà đội thể thao đó trực thuộc. Thêm parentOrganization vào cả homeTeam và awayTeam khi cả hai đội đều được cung cấp.
homeTeam.parentOrganization.name Văn bản 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ề Mỹ. 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 Tại sao? – Đường liên kết đến trang Wikipedia (ưu tiên phiên bản tiếng Anh) xác định giải đấu của đội (ví dụ: https://en.wikipedia.org/wiki/National_Basketball_Association). Đừng sử dụng URL phần giữ chỗ example.com.
awayTeam SportsTeam Rất nên dùng Tại sao? – Đội khách của sự kiện. Các thuộc tính và yêu cầu (bao gồm cả parentOrganization) giống như SportsEvent.homeTeam.
competitor SportsTeam hoặc Person Rất nên dùng Tại sao? Nếu không áp dụng đội nhà hoặc đội khách (ví dụ: trận đấu quyền anh, Thế vận hội), hãy chỉ định người tham gia là đối thủ cạnh tranh. Nếu SportsTeam, các thuộc tính sẽ giống như SportsEvent.homeTeam. Nếu Person, các thuộc tính sẽ giống với các đối tượng Person khác; ví dụ: 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 của vị trí là Place – Địa chỉ của vị trí. Không nên sử dụng thuộc tính này nếu @type của vị trí là City
location.address.streetAddress Văn bản Địa chỉ đường phố của địa điểm.
location.address.addressLocality Văn bản Thành phố của địa điểm.
location.address.addressRegion Văn bản Tiểu bang của địa điểm.
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à áp phích hoặc biểu ngữ chính thức cho 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 đưa vào image, hãy xem phần Thuộc tính hình ảnh.
potentialAction WatchAction Bắt buộc nếu có – (Các) đường liên kết sâu để phát sự kiện thể thao, được dùng cho cả sự kiện phát trực tiếp không có kênh và video phát lại theo yêu cầu. Tất cả đường liên kết sâu của sự kiện thể thao phải nằm trên SportsEvent.potentialAction; không bao giờ đặt potentialAction trên BroadcastEvent tham chiếu đến SportsEvent (đối với chương trình phát sóng trên kênh truyền hình tuyến tính không có đường liên kết sâu trực tiếp đến sự kiện, hãy cung cấp đường liên kết sâu của kênh trên BroadcastService.potentialAction). Cung cấp một mảng đối tượng WatchAction khi cung cấp nhiều sự kiện phát trực tiếp (chẳng hạn như nguồn cấp dữ liệu khu vực, sân nhà hoặc sân khách hoặc chương trình phát sóng đa ngôn ngữ) hoặc các cửa sổ phát lại video theo yêu cầu và phát trực tiếp riêng biệt.
potentialAction.actionAccessibilityRequirement ActionAccessSpecification Bắt buộc nếu bạn cung cấp potentialAction – Xác định quyền và khung thời gian phát sóng có thể nhấp vào (availabilityStarts và availabilityEnds) cho mỗi WatchAction:
  • Cửa sổ trước khi phát (availabilityStarts): Đối với các chương trình phát sóng thể thao trực tiếp, hãy đặt availabilityStarts ít nhất 14 ngày trước SportsEvent.startDate (availabilityStarts <= SportsEvent.startDate - 14 days) để các ô sự kiện sắp diễn ra có thể xuất hiện trước (bản thân thực thể sự kiện có thể được phân phối gần ngày diễn ra trận đấu hơn, miễn là dấu thời gian availabilityStarts trước startDate ít nhất 14 ngày).
  • Khoảng thời gian đệm cho hiệp phụ (availabilityEnds): Đặt availabilityEnds sau SportsEvent.endDate với khoảng thời gian đệm ít nhất từ 2 đến 3 giờ (availabilityEnds >= SportsEvent.endDate + 2 to 3 hours hoặc cho đến khi kết thúc khoảng thời gian phát lại video theo yêu cầu) để ngăn đường liên kết sâu hết hạn trong thời gian phát trực tiếp hiệp phụ hoặc đưa tin sau trận đấu.
Xem Thuộc tính mã đánh dấu hành động để biết thông tin chi tiết đầy đủ.
identifier PropertyValue Rất nên dùng Tại sao? – Giá trị nhận dạng bên ngoài hoặc mã khác giúp nhận dạng rõ ràng thực thể này. Bạn có thể sử dụng nhiều giá trị nhận dạng. Hãy xem phần Thuộc tính 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ]
}

Ví dụ về kênh 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",
  "endDate": "2019-07-12T23:30-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ó 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": "es",
      "@value": "Juego 6 de las Finales de Baloncesto Profesional de 2019. El Equipo A lidera la serie 3-2 contra el Equipo B."
    }
  ],
  "startDate": "2019-09-16T21:10-08:00",
  "endDate": "2019-09-17T00:00-08:00",
  "homeTeam": {
    "@type": "SportsTeam",
    "name": "Team B",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "athlete": [
      {
        "@type": "Person",
        "name": "John Doe"
      }
    ]
  },
  "awayTeam": {
    "@type": "SportsTeam",
    "name": "Team A",
    "sport": "https://en.wikipedia.org/wiki/Basketball",
    "parentOrganization": {
      "@type": "SportsOrganization",
      "name": "Professional Basketball League",
      "sameAs": "https://en.wikipedia.org/wiki/Professional_Basketball_League"
    },
    "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": "EP000194303282"
    }
  ],
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?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-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/basketball/final_game_6?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform"
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-09-01T10:35:29Z",
        "availabilityEnds": "2019-09-17T11:00:00Z",
        "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 thông số kỹ thuật của 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"}]
@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:
  • Duy nhất trên toàn hệ thống trong danh mục của bạn
  • Tĩnh
  • Ở dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
Vì url của một thực thể đáp ứng tất cả các yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của một 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ữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ hỗ trợ một tên.
description Văn bản Nội dung mô tả sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để thêm nội dung mô tả bằng nhiều ngôn ngữ và có độ dài khác nhau.
attendee Organization hoặc Person 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 sự kiện ở định dạng ISO 8601 kèm theo múi giờ.
endDate Ngày Thời gian kết thúc sự kiện ở định dạng ISO 8601 kèm theo múi giờ.
composer Organization hoặc Person 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 hoặc Person Bắt buộc – Người biểu diễn tại sự kiện, ví dụ: 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 thuộc 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 trong đó. Ví dụ: một tập hợ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 của vị trí là Place – Đị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à City.
location.address.streetAddress Văn bản Địa chỉ đường phố của địa điểm.
location.address.addressLocality Văn bản Thành phố của địa điểm.
location.address.addressRegion Văn bản Tiểu bang của địa điểm.
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 thông số kỹ thuật của 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"}]
@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:
  • Duy nhất trên toàn hệ thống trong danh mục của bạn
  • Tĩnh
  • Ở dạng Giá trị nhận dạng tài nguyên thống nhất (URI)
Vì url của một thực thể đáp ứng tất cả các yêu cầu về giá trị nhận dạng, nên bạn nên sử dụng url của một 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ữ. Xem ví dụ về Nhiều khu vực và ngôn ngữ.
  • Xin lưu ý rằng mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia) chỉ hỗ trợ một tên.
description Văn bản Nội dung mô tả sự kiện. Giới hạn 300 ký tự. Sử dụng một mảng để thêm nội dung mô tả bằng nhiều ngôn ngữ và có độ dài khác nhau.
attendee Organization hoặc Person 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 sự kiện theo định dạng ISO 8601 kèm theo múi giờ.
endDate Ngày Thời gian kết thúc sự kiện ở định dạng ISO 8601 kèm theo múi giờ.
subEvent Sự kiện Một Sự kiện thuộc 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 trong đó. Ví dụ: một tập hợ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 Tại sao? – PublicationEvent được dùng để chỉ định bản phát hành gốc (toàn cầu hoặc địa phương) của nội dung do nhà xuất bản cung cấp, chẳng hạn như ngày phát hành gốc tại rạp của một bộ phim.

Ngoài ra, hãy sử dụng FeaturedEvent để cho biết rằng dịch vụ của bạn tiếp thị nội dung này dưới dạng 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ó quyền phân phối độc quyền, đồ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 – Hãy 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 – Các khu vự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 FeaturedEvent và ExclusiveEvent, đây là khu vực nơi nội dung được giới thiệu nổi bật hoặc độc quyền.

Sử dụng mã ISO 3166 cho các quốc gia. Để chỉ định mọi nơi trên thế giới, hãy đặt thành EARTH.
releasedEvent.startDate Date hoặc DateTime Nên dùng – Bắt buộc đối với ExclusiveEvent – Ngày bắt đầu xuất bản thực thể.

Đối với PublicationEvent, thuộc tính 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.

Đối với ExclusiveEvent và FeaturedEvent, thuộc tính này biểu thị ngày bắt đầu khi thực thể này là độc quyền hoặc nổi bật.
releasedEvent.endDate Date hoặc DateTime Nên dùng – Bắt buộc đối với ExclusiveEvent – Thuộc tính này chỉ áp dụng cho các loại ExclusiveEvent và FeaturedEvent.

Đối với ExclusiveEvent, thuộc tính này thể hiện ngày hết hạn của 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 giới thiệu hoặc độc quyền vĩnh viễn, hãy đặt endDate thành 20 năm kể từ ngày hiện tại.
releasedEvent.publishedBy Organization hoặc Person 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 của vị trí là Place – Địa chỉ của vị trí. Không nên sử dụng thuộc tính này nếu @type của vị trí là City
location.address.streetAddress Văn bản Địa chỉ đường phố của địa điểm.
location.address.addressLocality Văn bản Thành phố của địa điểm.
location.address.addressRegion Văn bản Tiểu bang của địa điểm.
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"
  }
}