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

이 섹션에서는 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 필수 해당 스포츠의 위키백과 페이지 링크 (영어 버전 권장)
startDate DateTime 또는 Date 필수 - 시간대를 포함한 ISO 8601 형식의 이벤트 시작 시간입니다. 이 시간은 TV에서 이벤트가 방송되는 시간이 아니라 이벤트의 실제 시작 시간입니다.
endDate DateTime 또는 Date 시간대를 포함한 ISO 8601 형식의 이벤트 종료 시간입니다.
homeTeam SportsTeam 적극 권장됨 이유 이벤트의 홈팀입니다.
homeTeam.name 텍스트 필수 스포츠팀의 전체 이름입니다.
homeTeam.sport URL 필수 해당 스포츠의 위키백과 페이지 링크 (영어 버전 권장)
homeTeam.sameAs URL 적극 권장됨 이유 팀을 식별할 수 있는 참조 웹페이지의 URL입니다(예: 팀의 Wikipedia 페이지).
homeTeam.athlete 사람 팀의 개별 선수에 대한 주석입니다.
homeTeam.athlete.name 텍스트 선수의 전체 이름입니다.
homeTeam.parentOrganization.name SportsOrganization 필수 팀이 속한 스포츠 리그의 이름입니다. 예를 들어 NBA 또는 MLB가 있습니다. 이 필드는 팀 회의에 사용해서는 안 됩니다.
homeTeam.parentOrganization.sameAs URL 적극 권장됨 이유 팀의 리그를 식별할 수 있는 참조 웹페이지의 URL입니다(예: 리그의 Wikipedia 페이지).
awayTeam SportsTeam 적극 권장됨 이유 이벤트의 원정팀입니다. 속성은 SportsEvent.homeTeam와 동일합니다.
competitor SportsTeam 또는 Person 적극 권장됨 이유 홈팀 또는 원정팀이 적용되지 않는 경우 (예: 복싱 경기, 올림픽) 참가자를 경쟁자로 지정합니다. SportsTeam인 경우 속성은 SportsEvent.homeTeam와 동일합니다. Person인 경우 속성은 다른 Person 객체와 동일합니다(예: Movie의 행위자).
location 장소 또는 도시 이벤트의 위치입니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @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 예시

팀 스포츠 예시 

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

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": "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"
    }
  ]
  "potentialAction": [
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?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-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "eligibleRegion": {
          "@type": "Country",
          "name": "US"
        }
      }
    },
    {
      "@type": "WatchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "http://www.example.com/my_favorite_movie?autoplay=true",
        "inLanguage": "en",
        "actionPlatform": "http://schema.org/AndroidTVPlatform",
      },
      "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "subscription",
        "availabilityStarts": "2019-01-01T10:35:29Z",
        "availabilityEnds": "2020-05-31T10:35:29Z",
        "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"}]
로 설정
  • 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 장소 또는 도시 필수 - 이벤트의 위치입니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @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 장소 또는 도시 필수 - 이벤트의 위치입니다. City 수준에서 Place를 제공할 수 있습니다.
location.name 텍스트 필수 - 위치의 이름입니다.
location.address PostalAddress 위치 @type이 장소인 경우 필수 - 위치의 주소입니다. 위치 @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"
  }
}