이벤트의 콘텐츠 마크업 속성

이 섹션에서는 Event 관련 항목 유형의 콘텐츠 마크업 속성을 자세히 설명합니다.

SportsEvent 사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
    로 설정
  • xx를 BCP 47 형식의 항목 언어 코드(예: 'en')로 바꿉니다.
@type 텍스트 필수: 항상 SportsEvent로 설정됩니다.
@id URL 필수: URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전체에서 전 세계적으로 독특함
  • 정적: ID는 안정적이어야 하며 시간이 지남에 따라 변경되지 않아야 합니다 (프로그램의 URL 속성이 변경되더라도). 불투명 문자열로 취급되며 작동하는 링크가 아니어도 됩니다.
  • 통합 리소스 식별자 (URI) 형식
  • @id 값에 사용되는 도메인은 조직에서 소유한 것이어야 합니다.
항목의 url가 모든 식별자 요구사항을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
name 텍스트 필수 - 이 이벤트의 이름입니다.
  • 배열을 사용하여 이름을 여러 언어로 나열합니다. 여러 지역 및 언어 예를 참고하세요.
  • 언어당 하나의 이름 (언어-국가 쌍)만 지원됩니다.
description 텍스트 이 이벤트의 설명입니다. 300자(영문 기준)의 리미스트입니다. 배열을 사용하여 여러 언어 및 길이로 설명을 포함합니다.
sport URL 필수 해당 스포츠의 Wikipedia 페이지 링크 (영어 버전 권장)
startDate DateTime 또는 Date 필수 - 시간대가 포함된 ISO 8601 형식으로 된 이벤트 시작 시간입니다. 이 시간은 TV로 방송되는 시간이 아닌 실제 시작 시간입니다.
endDate DateTime 또는 Date 이벤트 종료 시간입니다. ISO 8601 형식으로 나타냅니다(시간대 포함).
homeTeam SportsTeam 추천 이유 이벤트의 홈팀입니다.
homeTeam.name 텍스트 필수사항: 스포츠팀의 전체 이름입니다.
homeTeam.sport URL 필수 해당 스포츠의 Wikipedia 페이지 링크 (영어 버전 권장)
homeTeam.sameAs URL 추천 이유 팀을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 팀의 Wikipedia 페이지).
homeTeam.athlete 사람 팀의 개별 선수에 대한 주석입니다.
homeTeam.athlete.name 텍스트 선수의 전체 이름입니다.
homeTeam.parentOrganization.name SportsOrganization 필수: 팀이 속한 스포츠 리그의 이름입니다. (예: 전미농구협회 또는 메이저리그 야구). 팀의 회의에는 이 필드를 사용해서는 안 됩니다.
homeTeam.parentOrganization.sameAs URL 추천 이유 팀의 리그를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 리그의 위키백과 페이지).
awayTeam SportsTeam 추천 이유 이벤트의 원정팀 속성은 SportsEvent.homeTeam와 동일합니다.
competitor SportsTeam 또는 Person 추천 이유 홈팀 또는 원정팀 (예: 복싱 경기, 올림픽)이 해당되지 않는 경우 참가자를 경쟁자로 지정합니다. SportsTeam인 경우 속성은 SportsEvent.homeTeam과 동일합니다. Person인 경우 속성은 다른 Person 객체(예: Movie의 배우)와 동일합니다.
location Place 또는 City 이벤트의 위치입니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress location @type이 Place인 경우 필수 - 위치의 주소입니다. 위치 @type이 도시인 경우 사용하면 안 됩니다.
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에서 이 스포츠 이벤트 녹화본을 재생하는 딥 링크입니다. 실시간 이벤트의 딥 링크를 지정하려면 BroadcastEvent에서 publishedOn 또는 potentialAction 속성을 대신 사용하세요.
identifier PropertyValue 추천 이유 - 이 항목을 명확하게 식별하는 외부 또는 기타 ID. 여러 식별자가 허용됩니다. 자세한 내용은 식별자 속성 섹션을 참고하세요.

SportsEvent 예

예시 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"
    }
  ]
}

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

MusicEvent 사양 표

속성 예상 유형 설명
@context 텍스트 필수 - 항상 ["http://schema.org", {"@language": "xx"}]
    로 설정
  • xx를 BCP 47 형식의 항목 언어 코드(예: 'en')로 바꿉니다.
@type 텍스트 필수: 항상 MusicEvent로 설정됩니다.
@id URL 필수: URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전체에서 전 세계적으로 독특함
  • 정적
  • 통합 리소스 식별자 (URI) 형식
항목의 url가 모든 식별자 요구사항을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
name 텍스트 필수 - 이 이벤트의 이름입니다.
  • 배열을 사용하여 이름을 여러 언어로 나열합니다. 여러 지역 및 언어 예를 참고하세요.
  • 언어당 하나의 이름 (언어-국가 쌍)만 지원됩니다.
description 텍스트 이벤트 설명입니다. 300자(영문 기준)의 리미스트입니다. 배열을 사용하여 여러 언어 및 길이로 설명을 포함합니다.
attendee Organization 또는 Person 이벤트에 참석하는 사람 또는 조직입니다.
startDate 날짜 필수 - 시간대가 포함된 ISO 8601 형식으로 된 이벤트 시작 시간입니다.
endDate 날짜 이벤트 종료 시간입니다. ISO 8601 형식으로 나타냅니다(시간대 포함).
composer Organization 또는 Person 음악작품을 작곡했거나 특정 행사에 공연한 작품의 작곡가인 개인 또는 조직입니다.
performer Organization 또는 Person 필수: 이벤트 출연자(예: 발표자, 뮤지션, 음악 그룹, 배우).
subEvent 이벤트 이벤트에 포함된 이벤트입니다. 예를 들어 회의 일정에는 프레젠테이션이 여러 개 포함되어 있으며, 각 프레젠테이션은 해당 회의의 하위 이벤트에 해당합니다.
superEvent 이벤트 이 이벤트가 속한 이벤트입니다. 예를 들어 개별 음악 공연 컬렉션은 각각 superEvent로 음악 페스티벌을 열 수 있습니다.
location Place 또는 City 필수 - 이벤트의 위치입니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress location @type이 Place인 경우 필수 - 위치의 주소입니다. 위치 @type이 도시인 경우 사용하면 안 됩니다.
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"}]
    로 설정
  • xx를 BCP 47 형식의 항목 언어 코드(예: 'en')로 바꿉니다.
@type 텍스트 필수: 항상 Event로 설정됩니다.
@id URL 필수: URI 형식의 콘텐츠 식별자입니다(예: https://example.com/1234abc).
@id는 다음 요구사항을 충족해야 합니다.
  • 카탈로그 전체에서 전 세계적으로 독특함
  • 정적
  • 통합 리소스 식별자 (URI) 형식
항목의 url가 모든 식별자 요구사항을 충족하므로 항목의 url를 @id로 사용하는 것이 좋습니다. 자세한 내용은 식별자 섹션을 참고하세요.
name 텍스트 필수 - 이 이벤트의 이름입니다.
  • 배열을 사용하여 이름을 여러 언어로 나열합니다. 여러 지역 및 언어 예를 참고하세요.
  • 언어당 하나의 이름 (언어-국가 쌍)만 지원됩니다.
description 텍스트 이벤트 설명입니다. 300자(영문 기준)의 리미스트입니다. 배열을 사용하여 여러 언어 및 길이로 설명을 포함합니다.
attendee Organization 또는 Person 이벤트에 참석하는 사람 또는 조직입니다.
startDate 날짜 필수 - 시간대가 포함된 ISO 8601 형식으로 된 이벤트 시작 시간입니다.
endDate 날짜 이벤트 종료 시간입니다. ISO 8601 형식으로 나타냅니다(시간대 포함).
subEvent 이벤트 이벤트에 포함된 이벤트입니다. 예를 들어 회의 일정에는 프레젠테이션이 여러 개 포함되어 있으며, 각 프레젠테이션은 해당 회의의 하위 이벤트에 해당합니다.
superEvent 이벤트 이 이벤트가 속한 이벤트입니다. 예를 들어 개별 음악 공연 컬렉션은 각각 superEvent로 음악 페스티벌을 열 수 있습니다.
releasedEvent PublicationEvent, FeaturedEvent 또는 ExclusiveEvent 추천 이유 - PublicationEvent은 영화의 원래 극장 개봉일과 같이 게시자의 콘텐츠 원본(전 세계 또는 현지)을 지정하는 데 사용됩니다.

또한 FeaturedEvent를 사용하여 서비스에서 이 콘텐츠를 원본, 추천, 특별 등으로 마케팅한다는 것을 표시할 수 있습니다.

ExclusiveEvent은(는) 귀하의 서비스에 독점 배포 권한이 있으며 제공 시기와 시점을 포함합니다.

자세한 내용과 예는 예시 섹션을 참고하세요.
releasedEvent.@type 텍스트 필수 - 이 속성은 항상 다음 중 하나로 설정해야 합니다.
  • PublicationEvent
  • ExclusiveEvent
  • FeaturedEvent
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 Place 또는 City 필수 - 이벤트의 위치입니다. City 수준에서 Place를 제공할 수 있습니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress location @type이 Place인 경우 필수 - 위치의 주소입니다. 위치 @type이 도시인 경우 사용하면 안 됩니다.
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"
  }
}