이 페이지는 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	필수 해당 스포츠의 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"
  }
}