Trang này được dịch bởi Cloud Translation API.

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 đến 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"}]` Thay thế `xx` bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "vi".
`@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 bộ danh mục của bạn Tĩnh; Mã này phải 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 mờ 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 hợp 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. Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với 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ữ. 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ỉ được 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 để đưa vào 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) về 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 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 điểm sự kiện được phát sóng trên TV.
`endDate`	DateTime hoặc Date	Thời gian kết thúc sự kiện ở định dạng ISO 8601 kèm theo múi giờ.
`homeTeam`	SportsTeam	Rất nên dùng Lý do? Đội chủ 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) về 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 nhóm; ví dụ: trang Wikipedia của nhóm.
`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	Họ tên 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 (NBA) hoặc Giải bóng chày nhà nghề Mỹ (MLB). Xin lưu ý rằng bạn không nên sử dụng trường này cho cuộc họp 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 hoặc Person	Rất nên dùng Lý do? Nếu không áp dụng được đội chủ 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 là `SportsTeam`, các thuộc tính sẽ giống như `SportsEvent.homeTeam`. Nếu là `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à Đị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	Trạng thái 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à áp phích hoặc biểu ngữ chính thức 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 đư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ó – Đường liên kết sâu phát bản ghi của sự kiện thể thao này trên dịch vụ Video 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 sử 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 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ụ 1 Ví dụ 2

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

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"}]` Thay thế `xx` bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "vi".
`@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 bộ danh mục của bạn Tĩnh Dưới dạng Giá trị nhận dạng tài nguyên hợp nhất (URI) Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với 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ữ. 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ỉ được 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 để đưa vào nội dung mô tả bằng nhiều ngôn ngữ và độ dài.
`attendee`	Tổ chức hoặc 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 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`	Tổ chức hoặc 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 trình diễn tại một sự kiện nào đó.
`performer`	Tổ chức hoặc Người	Bắt buộc – Người biểu diễn tại sự kiện, chẳng hạn như người trình bày, nhạc sĩ, 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 sự kiện phụ của hội nghị.
`superEvent`	Sự kiện	Sự kiện mà sự kiện này là một phầ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 của 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	Trạng thái 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 thực hiện trong một số sự kiện, ví dụ: một vở kịch được thực hiện trong 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"}]` Thay thế `xx` bằng mã ngôn ngữ của thực thể ở định dạng BCP 47, ví dụ: "vi".
`@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 bộ danh mục của bạn Tĩnh Dưới dạng Giá trị nhận dạng tài nguyên hợp nhất (URI) Vì `url` của một thực thể đáp ứng tất cả các yêu cầu đối với 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ữ. 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ỉ được 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 để đưa vào nội dung mô tả bằng nhiều ngôn ngữ và độ dài.
`attendee`	Tổ chức hoặc 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 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 sự kiện phụ của hội nghị.
`superEvent`	Sự kiện	Sự kiện mà sự kiện này là một phầ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` dùng để chỉ định bản phát hành nội dung ban đầu (toàn cầu hoặc cục bộ) của nhà xuất bản, chẳng hạn như ngày phát hành ban đầu tại rạp của một bộ phim. Ngoài ra, hãy sử 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 bật, đặ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 và bao gồm cả nơi và thời điểm. 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 những giá trị sau: `PublicationEvent` `ExclusiveEvent` `FeaturedEvent`
`releasedEvent.location`	Quốc gia	Bắt buộc – Cá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 `FeaturedEvent` và `ExclusiveEvent`, đây là khu vực nơi nội dung được giới thiệu hoặc độc quyền. Sử dụng mã ISO 3166 cho quốc gia. Để cho biết ở 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 của thực thể. Đối với `PublicationEvent`, trường 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 phát hành phim đầu tiên tại rạp. Đối với `ExclusiveEvent` và `FeaturedEvent`, trường này biểu thị ngày bắt đầu khi thực thể là độc quyền hoặc được làm 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 quyền đối với nội dung. Đối với `FeaturedEvent`, thuộc tính này thể hiện ngày gần nhất mà nhà cung cấp giới thiệu thực thể. Nếu nội dung là nội dung độc quyền hoặc nội dung đượ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`	Tổ chức hoặc 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 của 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	Trạng thái 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 thực hiện trong một số sự kiện, ví dụ: một vở kịch được thực hiện trong 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"
  }
}