이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

이 섹션에서는 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 예시

예시 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`	장소 또는 도시	필수 - 이벤트의 위치입니다.
`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"
  }
}