이 섹션에서는 Event 관련 항목 유형의 콘텐츠 마크업 속성에 관한 세부정보를 제공합니다.
SportsEvent 사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.org", {"@language": "xx"}]로 설정
|
@type |
텍스트 | 필수 - 항상 SportsEvent로 설정됩니다. |
@id |
URL | 필수 - URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).@id은 다음 요구사항을 충족해야 합니다.
SportsEvent 또는 BroadcastEvent에 url 속성을 포함하지 마세요. SportsEvent.potentialAction를 사용하여 재생 링크를 제공합니다. 자세한 내용은 식별자 섹션을 참고하세요. |
name |
텍스트 | 필수 - 이 이벤트의 이름입니다.
|
description |
텍스트 | 이 이벤트에 대한 설명입니다. 글자 수 제한은 300자(영문 기준)입니다. 배열을 사용하여 여러 언어로 설명을 포함합니다(언어당 하나). |
sport |
URL | 필수 스포츠의 Wikipedia 페이지(영어 버전 권장) 링크입니다. |
startDate |
DateTime 또는 Date | 필수 - 시간대가 포함된 ISO 8601 형식의 이벤트 시작 시간입니다. 이벤트가 TV에서 방송되는 시간이 아니라 실제 이벤트 시작 시간입니다. |
endDate |
DateTime 또는 Date | 권장사항 - 이벤트의 예약된 종료 시간입니다. 시간대가 포함된 ISO 8601 형식으로 나타냅니다. 예정된 종료 시간을 알고 있는 경우 이를 제공합니다. 종료 시간을 알 수 없는 경우 예상 자리표시자를 제공하는 대신 이 속성을 생략합니다. |
homeTeam |
SportsTeam | 적극 권장 이유 이벤트의 홈팀입니다. |
homeTeam.name |
텍스트 | 필수 스포츠팀의 전체 이름입니다. |
homeTeam.sport |
URL | 필수 스포츠의 위키백과 페이지(영어 버전 권장) 링크입니다. |
homeTeam.sameAs |
URL | 적극 권장 이유 팀을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 팀의 위키피디아 페이지). |
homeTeam.athlete |
Person | 팀의 개별 선수에 대한 주석입니다. |
homeTeam.athlete.name |
텍스트 | 선수의 전체 이름입니다. |
homeTeam.parentOrganization |
SportsOrganization | 필수 - 팀이 속한 스포츠 리그 또는 주관 단체입니다. 두 팀이 모두 제공되는 경우 homeTeam 및 awayTeam에 모두 parentOrganization를 포함합니다. |
homeTeam.parentOrganization.name |
텍스트 | 필수 - 팀이 속한 스포츠 리그의 이름입니다. 예를 들어 전미 농구 협회(NBA) 또는 메이저 리그 야구(MLB)가 있습니다. 이 필드는 팀 회의에 사용해서는 안 됩니다. |
homeTeam.parentOrganization.sameAs |
URL | 적극 권장 이유 - 팀의 리그를 식별하는 Wikipedia 페이지(영어 버전 선호) 링크(예: https://en.wikipedia.org/wiki/National_Basketball_Association). 자리표시자 example.com URL을 사용하지 마세요. |
awayTeam |
SportsTeam | 적극 권장 이유 - 이벤트의 원정팀입니다. 속성 및 요구사항(parentOrganization 포함)은 SportsEvent.homeTeam와 동일합니다. |
competitor |
SportsTeam 또는 Person | 적극 권장 이유 홈팀 또는 원정팀이 해당하지 않는 경우(예: 권투 경기, 올림픽) 참가자를 경쟁자로 지정합니다. SportsTeam인 경우 속성은 SportsEvent.homeTeam와 동일합니다. Person인 경우 속성은 다른 Person 객체와 동일합니다(예: Movie의 배우). |
location |
장소 또는 도시 | 이벤트의 위치입니다. |
location.name |
텍스트 | 필수 - 위치의 이름입니다. |
location.address |
PostalAddress | 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @type이 City인 경우 사용하면 안 됩니다. |
location.address.streetAddress |
텍스트 | 위치의 상세 주소입니다. |
location.address.addressLocality |
텍스트 | 위치의 도시입니다. |
location.address.addressRegion |
텍스트 | 위치의 상태입니다. |
location.address.postalCode |
텍스트 | 위치의 우편번호입니다. |
location.address.addressCountry |
텍스트 | ISO 3166 형식의 국가입니다. |
image |
ImageObject | Google TV에 필수 - 이벤트와 관련된 이미지입니다. 이벤트의 공식 포스터 또는 배너 아트에 권장됩니다. image에 포함할 필수 및 선택 속성에 관한 자세한 내용은 이미지 속성을 참고하세요. |
potentialAction |
WatchAction | 해당하는 경우 필수 - 스포츠 이벤트를 재생하는 딥 링크로, 채널 없는 라이브 스트림과 VOD 다시보기에 모두 사용됩니다. 모든 스포츠 이벤트 딥 링크는 SportsEvent.potentialAction에 있어야 합니다. SportsEvent를 참조하는 BroadcastEvent에 potentialAction를 배치해서는 안 됩니다(직접 이벤트 딥 링크가 없는 일반 TV 채널 방송의 경우 BroadcastService.potentialAction에 채널 딥 링크를 제공). 여러 스트림(예: 지역, 홈 또는 어웨이 피드, 다국어 방송) 또는 별도의 라이브 및 VOD 다시보기 기간을 제공하는 경우 WatchAction 객체의 배열을 제공합니다. |
potentialAction.actionAccessibilityRequirement |
ActionAccessSpecification | potentialAction가 제공되는 경우 필수 - 각 WatchAction의 사용 권한 및 클릭 가능한 서비스 일정(availabilityStarts 및 availabilityEnds)을 정의합니다.
|
identifier |
PropertyValue | 적극 권장 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID입니다. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요. |
SportsEvent 예시
팀 스포츠 예시
{
"@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"
}
]
}
개인 스포츠 예시
{
"@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"
}
}
}
GeoShape 제한이 있는 SportsEvent
{
"@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"
]
}
]
}
}
]
}
MusicEvent 사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.org", {"@language": "xx"}]로 설정
|
@type |
텍스트 | 필수 - 항상 MusicEvent로 설정됩니다. |
@id |
URL | 필수 - URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).@id은 다음 요구사항을 충족해야 합니다.
url는 식별자로서의 모든 요구사항을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
name |
텍스트 | 필수 - 이 이벤트의 이름입니다.
|
description |
텍스트 | 이벤트에 대한 설명입니다. 최대 300자(영문 기준)까지 입력할 수 있습니다. 배열을 사용하여 여러 언어와 길이의 설명을 포함합니다. |
attendee |
Organization 또는 Person | 이벤트에 참석하는 사람 또는 조직입니다. |
startDate |
날짜 | 필수 - 시간대가 포함된 ISO 8601 형식의 이벤트 시작 시간입니다. |
endDate |
날짜 | 시간대가 포함된 ISO 8601 형식의 이벤트 종료 시간입니다. |
composer |
Organization 또는 Person | 음악작품을 작성한 사람 또는 조직, 또는 특정 이벤트에서 공연된 작품의 작곡가입니다. |
performer |
Organization 또는 Person | 필수 - 이벤트의 공연자입니다(예: 발표자, 뮤지션, 음악 그룹, 배우). |
subEvent |
이벤트 | 이 이벤트의 일부인 이벤트입니다. 예를 들어 컨퍼런스 이벤트에는 여러 프레젠테이션이 포함되며, 각 프레젠테이션은 컨퍼런스의 subEvent입니다. |
superEvent |
이벤트 | 이 이벤트가 포함된 이벤트입니다. 예를 들어 개별 음악 공연 모음에는 각각 음악 축제가 superEvent로 포함될 수 있습니다. |
location |
장소 또는 도시 | 필수 - 이벤트의 위치입니다. |
location.name |
텍스트 | 필수 - 위치의 이름입니다. |
location.address |
PostalAddress | 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @type이 City인 경우 이 속성을 사용하면 안 됩니다. |
location.address.streetAddress |
텍스트 | 위치의 상세 주소입니다. |
location.address.addressLocality |
텍스트 | 위치의 도시입니다. |
location.address.addressRegion |
텍스트 | 위치의 상태입니다. |
location.address.postalCode |
텍스트 | 위치의 우편번호입니다. |
location.address.addressCountry |
텍스트 | ISO 3166 형식의 국가입니다. |
workPerformed |
CreativeWork | 이벤트에서 수행되는 작업입니다(예: TheaterEvent에서 수행되는 연극). |
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"
}
}
이벤트 사양 표
| 속성 | 예상 유형 | 설명 |
|---|---|---|
@context |
텍스트 | 필수 - 항상 ["http://schema.org", {"@language": "xx"}]로 설정
|
@type |
텍스트 | 필수 - 항상 Event로 설정됩니다. |
@id |
URL | 필수 - URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).@id은 다음 요구사항을 충족해야 합니다.
url는 식별자로서의 모든 요구사항을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요. |
name |
텍스트 | 필수 - 이 이벤트의 이름입니다.
|
description |
텍스트 | 이벤트에 대한 설명입니다. 최대 300자(영문 기준)까지 입력할 수 있습니다. 배열을 사용하여 여러 언어와 길이의 설명을 포함합니다. |
attendee |
Organization 또는 Person | 이벤트에 참석하는 사람 또는 조직입니다. |
startDate |
날짜 | 필수 - 시간대가 포함된 ISO 8601 형식의 이벤트 시작 시간입니다. |
endDate |
날짜 | 시간대가 포함된 ISO 8601 형식의 이벤트 종료 시간입니다. |
subEvent |
이벤트 | 이 이벤트의 일부인 이벤트입니다. 예를 들어 컨퍼런스 이벤트에는 여러 프레젠테이션이 포함되며, 각 프레젠테이션은 컨퍼런스의 subEvent입니다. |
superEvent |
이벤트 | 이 이벤트가 포함된 이벤트입니다. 예를 들어 개별 음악 공연 모음에는 각각 음악 축제가 superEvent로 포함될 수 있습니다. |
releasedEvent |
PublicationEvent, FeaturedEvent 또는 ExclusiveEvent |
적극 권장 이유 - PublicationEvent는 게시자가 콘텐츠를 원본(전 세계 또는 현지)으로 출시한 날짜를 지정하는 데 사용됩니다(예: 영화의 원본 극장 개봉일).또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 원본, 추천, 특별 등으로 마케팅하고 있음을 나타냅니다.ExclusiveEvent는 서비스에 독점 배포권이 있음을 지정하고 위치와 시기를 포함합니다.자세한 내용과 예시는 예시 섹션을 참고하세요. |
releasedEvent.@type |
텍스트 | 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
|
releasedEvent.location |
국가 | 필수 - 이 이벤트와 연결된 지역입니다.PublicationEvent의 경우 콘텐츠가 게시된 지역입니다.FeaturedEvent 및 ExclusiveEvent의 경우 콘텐츠가 추천되거나 독점 제공되는 지역입니다.국가에는 ISO 3166 코드를 사용합니다. 전 세계를 나타내려면 EARTH로 설정합니다. |
releasedEvent.startDate |
Date 또는 DateTime | 권장 - ExclusiveEvent에 필수 - 항목의 게시 시작일입니다.PublicationEvent의 경우 이 항목의 최초 출시일(예: 영화가 극장에서 처음 개봉된 날짜)을 나타냅니다.ExclusiveEvent 및 FeaturedEvent의 경우 항목이 독점 또는 추천되는 시작일을 나타냅니다. |
releasedEvent.endDate |
Date 또는 DateTime | 권장 - ExclusiveEvent에 필요 - ExclusiveEvent 및 FeaturedEvent 유형에만 적용됩니다.ExclusiveEvent의 경우 콘텐츠 권리가 만료되는 날짜를 나타냅니다.FeaturedEvent의 경우 제공업체가 항목을 추천하는 마지막 날짜를 나타냅니다.콘텐츠가 영구적으로 독점 또는 추천되는 경우 endDate를 현재 날짜로부터 20년으로 설정합니다. |
releasedEvent.publishedBy |
Organization 또는 Person | 선택사항 - 이 항목을 게시한 조직 또는 개인입니다. |
location |
장소 또는 도시 | 필수 - 이벤트의 위치입니다. City 수준에서 Place를 제공할 수 있습니다. |
location.name |
텍스트 | 필수 - 위치의 이름입니다. |
location.address |
PostalAddress | 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @type이 City인 경우 사용해서는 안 됩니다. |
location.address.streetAddress |
텍스트 | 위치의 상세 주소입니다. |
location.address.addressLocality |
텍스트 | 위치의 도시입니다. |
location.address.addressRegion |
텍스트 | 위치의 상태입니다. |
location.address.postalCode |
텍스트 | 위치의 우편번호입니다. |
location.address.addressCountry |
텍스트 | ISO 3166 형식의 국가입니다. |
workPerformed |
CreativeWork | 이벤트에서 수행되는 작업입니다(예: TheaterEvent에서 수행되는 연극). |
이벤트 예
이벤트
{
"@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"
}
}