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

Tài sản	Loại dự kiến	Nội dung 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: Dành riêng trên toàn thế giới trong danh mục của bạn Tĩnh; Mã nhận dạng phải ổn đị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 hoạt động. Ở dạng mã nhận dạng tài nguyên hợp nhất (URI) Miề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 pháp nhân đá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 pháp nhân làm `@id`. Hãy xem mục Giá trị nhận dạng để biết thêm 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 chỉ có một tên được hỗ trợ cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
`description`	Văn bản	Nội dung mô tả về sự kiện này. 300 ký tự limist. Sử dụng mảng để thêm 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 (ưu tiên phiên bản tiếng Anh) của môn thể thao này.
`startDate`	DateTime hoặc Date	Bắt buộc – Thời gian bắt đầu sự kiện ở định dạng ISO 8601 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 là 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 sự kiện ở định dạng ISO 8601 với múi giờ.
`homeTeam`	SportsTeam	Lý do được đề xuất ở mức độ cao? Độ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 (ưu tiên phiên bản tiếng Anh) của môn thể thao này.
`homeTeam.sameAs`	URL	Lý do được đề xuất ở mức độ cao? URL đến một trang web tham khảo giúp xác định danh tính của đội bóng; ví dụ: trang Wikipedia của đội bóng.
`homeTeam.athlete`	Person (Người)	(Các) chú thích về một vận động viên cá nhân trong đội.
`homeTeam.athlete.name`	Văn bản	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ề Mỹ. 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	Lý do được đề xuất ở mức độ cao? URL đến 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	Lý do được đề xuất ở mức độ cao? Độ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	Lý do được đề xuất ở mức độ cao? Nếu đội nhà hoặc đội khách không thuộc trường hợp áp dụng (ví dụ: một trận quyền Anh, Thế vận hội), hãy chỉ định những người tham gia là đối thủ cạnh tranh. Nếu là `SportsTeam`, các thuộc tính giống với `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; 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 vị trí @type là Địa điểm – Địa chỉ của vị trí. Không nên dùng thuộc tính này nếu vị trí @type 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 điện của vị trí.
`location.address.addressCountry`	Văn bản	Các quốc gia ở định dạng ISO 3166.
`image`	ImageObject	Bắt buộc đối với Google TV – (Các) Hình ảnh liên quan đến sự kiện. Nên dùng làm áp phích hoặc ảnh biểu ngữ chính thức cho sự kiện. Để biết thêm thông tin về các thuộc tính bắt buộc và không bắt buộc để đưa vào `image`, hãy xem bài viết 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 Video theo yêu cầu. Để chỉ định đường liên kết sâu cho một sự kiện trực tiếp, hãy sử dụng thuộc tính `publishedOn` hoặc `potentialAction` trong `BroadcastEvent`.
`identifier`	PropertyValue	Lý do được đề xuất ở mức độ cao? - Mã nhận dạng bên ngoài hoặc mã nhận dạng khác xác định rõ ràng thực thể này. Cho phép nhiều giá trị nhận dạng. Hãy xem mục 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

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

Bảng thông số kỹ thuật của sự kiện MusicEvent

Tài sản	Loại dự kiến	Nội dung 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: Dành riêng trên toàn thế giới trong danh mục của bạn Tĩnh Ở dạng mã nhận dạng tài nguyên hợp nhất (URI) Vì `url` của pháp nhân đá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 pháp nhân làm `@id`. Hãy xem mục Giá trị nhận dạng để biết thêm 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 chỉ có một tên được hỗ trợ cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
`description`	Văn bản	Nội dung mô tả về sự kiện. 300 ký tự limist. Sử dụng mảng để thêm 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)	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 theo múi giờ.
`endDate`	Ngày	Thời gian kết thúc sự kiện ở định dạng ISO 8601 với múi giờ.
`composer`	Organization (Tổ chức) hoặc Person (Người)	Người hoặc tổ chức đã viết bản sáng tác hoặc là nhà soạn nhạc của 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 – Người biểu diễn tại sự kiện – ví dụ: người trình bày, nhạc sĩ, nhóm nhạc hoặc diễn viên.
`subEvent`	Sự kiện	Sự kiện là một phần của sự kiện này. Ví dụ: một sự kiện hội nghị bao gồm nhiều bài trình bày, mỗi bài trình bày là một sự kiện phụ của hội nghị truyền hình.
`superEvent`	Sự kiện	Một sự kiện chứa sự kiện này. Ví dụ: một nhóm 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 – Vị trí của 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 vị trí @type là Địa điểm – Địa chỉ của vị trí. Không nên sử dụng thuộc tính này nếu vị trí @type 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 điện của vị trí.
`location.address.addressCountry`	Văn bản	Các quốc gia ở định dạng ISO 3166.
`workPerformed`	CreativeWork	Một tác phẩm được biểu diễn trong một số sự kiện, chẳng hạn như một vở kịch được biểu diễn trong một sự kiện trong nhà hát.

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

Tài sản	Loại dự kiến	Nội dung 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: Dành riêng trên toàn thế giới trong danh mục của bạn Tĩnh Ở dạng mã nhận dạng tài nguyên hợp nhất (URI) Vì `url` của pháp nhân đá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 pháp nhân làm `@id`. Hãy xem mục Giá trị nhận dạng để biết thêm 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 chỉ có một tên được hỗ trợ cho mỗi ngôn ngữ (cặp ngôn ngữ-quốc gia).
`description`	Văn bản	Nội dung mô tả về sự kiện. 300 ký tự limist. Sử dụng mảng để thêm 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)	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 theo múi giờ.
`endDate`	Ngày	Thời gian kết thúc sự kiện ở định dạng ISO 8601 với múi giờ.
`subEvent`	Sự kiện	Sự kiện là một phần của sự kiện này. Ví dụ: một sự kiện hội nghị bao gồm nhiều bài trình bày, mỗi bài trình bày là một sự kiện phụ của hội nghị truyền hình.
`superEvent`	Sự kiện	Một sự kiện chứa sự kiện này. Ví dụ: một nhóm 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`	Lý do được đề xuất ở mức độ cao? – `PublicationEvent` dùng để chỉ định bản phát hành nội dung gốc (toàn cầu hoặc địa phương) của nhà xuất bản, chẳng hạn như ngày ra rạp ban đầu 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` nêu rõ rằng dịch vụ của bạn có quyền phân phối độc quyền cũng như địa điểm và thời điểm phát hành. 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 là 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 quan đến 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 mà nội dung này chỉ xuất hiện hoặc chỉ dành riêng cho trẻ. Sử dụng mã ISO 3166 cho các quốc gia. Để chỉ ra mọi nơi trên thế giới, hãy đặt thành `EARTH`.
`releasedEvent.startDate`	Date (Ngày) hoặc DateTime (Ngày giờ)	Đề xuất – Bắt buộc đối với `ExclusiveEvent` – Ngày bắt đầu xuất bản thực thể. Đối với `PublicationEvent`, ngày này biểu thị ngày phát hành đầu tiên của thực thể này, chẳng hạn như ngày phim được phát hành lần đầu tại rạp. Đối với `ExclusiveEvent` và `FeaturedEvent`, đây là ngày bắt đầu khi thực thể này là độc quyền hoặc nổi bật.
`releasedEvent.endDate`	Date (Ngày) hoặc DateTime (Ngày giờ)	Đề xuất – Bắt buộc đối với `ExclusiveEvent` – Trường hợp này chỉ áp dụng cho loại `ExclusiveEvent` và `FeaturedEvent`. Đối với `ExclusiveEvent`, đây là ngày mà quyền đối với nội dung hết hạn. Đối với `FeaturedEvent`, đây là ngày cuối cùng mà nhà cung cấp giới thiệu thực thể. Nếu nội dung vĩnh viễn được độc quyền hoặc nổi bật, 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 cá nhân đã xuất bản mục này.
`location`	Địa điểm HOẶC Thành phố	Bắt buộc – Vị trí của 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 vị trí @type là Địa điểm – Địa chỉ của vị trí. Không nên sử dụng thuộc tính này nếu vị trí @type 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 điện của vị trí.
`location.address.addressCountry`	Văn bản	Các quốc gia ở định dạng ISO 3166.
`workPerformed`	CreativeWork	Một tác phẩm được biểu diễn trong một số sự kiện, chẳng hạn như một vở kịch được biểu diễn trong một sự kiện trong nhà hát.

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