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

이 섹션에서는 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 Person 팀의 개별 운동선수에 대한 주석입니다.
homeTeam.athlete.name 텍스트 선수의 전체 이름입니다.
homeTeam.parentOrganization.name SportsOrganization 필수 팀이 속한 스포츠 리그의 이름입니다. 예를 들어 National Basketball Association 또는 Major League Baseball이 있습니다. 이 필드는 팀의 회의에 사용하면 안 됩니다.
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이 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에서 이 스포츠 경기의 녹화 영상을 재생하는 딥 링크입니다. 라이브 이벤트의 딥 링크를 지정하려면 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 이벤트 이 이벤트에 포함된 이벤트입니다. 예를 들어 회의 이벤트에는 여러 프레젠테이션이 포함되며 각 프레젠테이션은 회의의 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"}]
로 설정
  • 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 이벤트 이 이벤트에 포함된 이벤트입니다. 예를 들어 회의 이벤트에는 여러 프레젠테이션이 포함되며 각 프레젠테이션은 회의의 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이 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"
  }
}