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

시청 작업 일반 속성

이 섹션에서는 보기 작업의 일반적인 속성에 관해 자세히 설명합니다.

작업 마크업 속성

속성	예상 유형	설명
`@type`	텍스트	필수 - 항상 `WatchAction`로 설정됩니다.
`target`	진입점	필수 항목 - 딥 링크를 다양한 Google 플랫폼에 매핑하는 대상 객체입니다.
`target.@type`	텍스트	필수 - 항상 `EntryPoint`로 설정됩니다.
`target.urlTemplate`	URL	필수 - 사용자가 앱 또는 플랫폼으로 이동하여 콘텐츠 재생을 시작하는 딥 링크입니다.
`target.inLanguage`	텍스트	선택사항 - BCP 47 형식의 시리즈 원본 언어입니다.
`target.actionPlatform`	텍스트	필수 - `urlTemplate`에 매핑된 플랫폼입니다. 미디어 작업은 다음을 지원합니다. `http://schema.org/DesktopWebPlatform`: 데스크톱 웹브라우저의 검색 플랫폼입니다. `http://schema.org/MobileWebPlatform`: 모바일 웹브라우저의 검색 플랫폼입니다. `http://schema.org/AndroidPlatform`: Android 앱의 검색 및 PlayGuide 플랫폼 `http://schema.org/AndroidTVPlatform`: Android TV 앱의 Android TV 플랫폼입니다. `http://schema.org/IOSPlatform`: iOS 앱의 검색 플랫폼입니다. `http://schema.googleapis.com/GoogleVideoCast`: Chromecast 기기의 전송 및 홈 플랫폼입니다. `http://schema.googleapis.com/GoogleAudioCast`: Chromecast 기기의 전송 및 홈 플랫폼 (듣기 작업만 해당) 요건은 플랫폼 유형 섹션을 참고하세요.
`target.additionalProperty`	PropertyValue	필요 시 - 딥 링크의 추가 속성을 나타내는 속성-값 쌍 목록입니다. 여기에는 다음이 포함될 수 있습니다. `contentLanguage`: BCP 47 형식의 방송 언어 (더빙)입니다. 콘텐츠가 다른 언어로 더빙된 경우 이 속성은 필수입니다. 여러 언어 코드에 배열을 사용합니다. `subtitleLanguage`: BCP 47 형식의 자막 언어입니다. 여러 언어 코드에 배열을 사용합니다. `cameraAngle`: 콘텐츠의 카메라 각도. 예: 'Eye-Level' 및 'High-Angle'. 콘텐츠가 다양한 카메라 각도에서 제공되는 경우 이 속성은 필수입니다. 여러 카메라 각도에 배열을 사용합니다. `videoFormat`: 디지털 동영상 날짜를 저장하는 데 사용되는 파일 형식입니다. 예를 들어 표준 화질은 'SD'이고 고화질은 'HD'입니다. 유효한 동영상 형식으로는 SD, HD, 2K, 4K, 8K가 있습니다. 여러 동영상 형식에 배열을 사용합니다. additionalProperty 예를 참고하세요.
`actionAccessibilityRequirement`	ActionAccessSpec	필수 - 콘텐츠의 액세스 요구사항을 설명하는 작업 액세스 사양 객체입니다. 작업 액세스 사양 속성을 참조하세요.

액션 마크업 관련 페이지

이러한 속성과 관련된 주제를 알아보려면 다음 페이지를 참고하세요.

작업 액세스 사양 속성

속성	예상 유형	설명
`actionAccessibilityRequirement.@type`	텍스트	필수 - 항상 `ActionAccessSpecification`로 설정됩니다.
`actionAccessibilityRequirement.category`	텍스트	필수 - 콘텐츠에 대한 액세스 요구사항입니다. 자세한 내용은 페이월 유형을 참조하세요. 항목이 콘텐츠 그룹을 나타내는 경우 `category`를 콘텐츠의 가장 엄격한 액세스 요구사항으로 설정해야 합니다. 예를 들어 `TVSeries`에 `TVEpisode` 콘텐츠가 `nologinrequired`로 설정되어 있고 일부는 `subscription`로 설정된 경우 이 `TVSeries`를 `nologinrequired`로 설정합니다.
`actionAccessibilityRequirement.availabilityStarts`	날짜	필수 - 작업을 사용할 수 있는 날짜입니다. ISO 8601 형식(시간대 포함)으로 나타냅니다. 미래의 날짜를 설정할 수 있습니다. 해당 항목은 availabilityStarts 날짜보다 최소한 7일 전에 피드에 제공해야 합니다. 이렇게 하면 정시에 Google 플랫폼에 콘텐츠가 표시될 가능성이 높아집니다.
`actionAccessibilityRequirement.availabilityEnds`	날짜	필수 - 더 이상 사용할 수 없는 날짜입니다. ISO 8601 형식 (시간대 포함)으로 나타냅니다. `availabilityStarts` 이후 72시간 이상이어야 합니다. 게시 후 콘텐츠가 항상 제공되는 경우 현재 날짜로부터 20년으로 설정하세요. availabilityEnds 날짜에 대한 모든 업데이트는 availabilityEnds 날짜 7일 전에 피드에서 이루어져야 합니다. 이렇게 하면 해당 콘텐츠가 availabilityEnds 날짜에 Google 플랫폼에 표시되지 않을 가능성이 커집니다.
`actionAccessibilityRequirement.eligibleRegion`	국가, 도시, 주, GeoShape, 텍스트	필수사항 - 콘텐츠를 사용할 수 있는 리전입니다. 콘텐츠가 전역적으로 제공되는 경우 특수 문자열 `EARTH`를 사용합니다.
`actionAccessibilityRequirement.ineligibleRegion`	국가, 도시, 주 또는 GeoShape	필요한 경우 - 콘텐츠가 제한된 지역입니다. `eligibleRegion` 내의 모든 위치에서 콘텐츠를 사용할 수 있는 경우 이 속성을 제공할 필요가 없습니다.
`actionAccessibilityRequirement.requiresSubscription`	미디어 구독	필요한 경우 - 사용자가 콘텐츠에 액세스하기 위해 필요한 정기 결제의 세부정보입니다. 미디어 구독 속성을 참고하세요. `category`가 `subscription` 또는 `externalSubscription`인 경우 이 속성을 제공합니다.
`actionAccessibilityRequirement.expectsAcceptanceOf`	혜택	콘텐츠에 구매가 필요한 경우 필수 - 콘텐츠와 연결된 혜택의 세부정보입니다. 다음과 같은 경우 가격 정보를 제공하세요. 일회성 구매 콘텐츠(`rental` 또는 `purchase`) 정기 결제 이용자의 추가 구매가 필요한 정기 결제 기반 콘텐츠(`subscription` 또는 `externalsubscription`) 가격이 0.00이면 `Offer` 객체를 완전히 삭제하고 `category`을 `ActionAccessSpecification` 객체에서 `free`로 설정합니다. 혜택 속성을 참고하세요.

미디어 구독 속성

actionAccessibilityRequirement.category가 subscription 또는 externalSubscription인 경우 필수입니다.

속성	예상 유형	설명
`requiresSubscription.@type`	텍스트	필수 - 항상 `MediaSubscription`로 설정
`requiresSubscription.@id`	URL	필수 항목 - 정기 결제의 고유 ID입니다. 여러 정기 결제를 통해 콘텐츠에 액세스할 수 있는 경우 각 정기 결제에는 고유 ID가 있어야 합니다.
`requiresSubscription.name`	텍스트	필수 항목 - 구독의 이름입니다. 다음 내용을 참고하세요. 다른 정기 결제를 통해 콘텐츠에 액세스할 수 있는 경우 이 이름은 사용자 인증 시스템의 이름과 일치해야 합니다. 예를 들어 사용자가 패키지 1이라는 정기 결제를 기반으로 콘텐츠에 액세스할 수 있지만 인증 시스템은 PKG1a라는 이름을 사용하는 경우 PKG1을 사용합니다. TVE 제공업체의 경우 TVE 인증자에 등록된 인증자 이름입니다. TVE OTP로 서비스 이름을 고유하게 식별하는 문자열입니다.
`requiresSubscription.sameAs`	URL	정기 결제를 설명하는 페이지입니다.
`requiresSubscription.identifier`	텍스트	`category`이 `subscription`이고 `commonTier`이 `false`인 경우 필수입니다. - 미디어 카탈로그의 콘텐츠 그룹에 대한 액세스를 나타내는 이 구독의 고유 문자열입니다. 식별자에 다음 구문을 사용하는 것이 좋습니다. 도메인 이름 + 콜론 (:) + 콘텐츠 액세스 수준, 예: example.com:basic, example.com:premium, example.com:sports 사용 권한 API를 제공하는 경우 이 속성은 사용 권한 식별자와 동일합니다.
`requiresSubscription.authenticator`	조직	`category`가 `externalsubscription`인 경우 필수입니다. 외부 제공업체 인증자의 세부정보를 제공하는 컨테이너입니다.
`requiresSubscription.authenticator.@type`	텍스트	`category`가 `externalsubscription`인 경우 필수 - 항상 `Organization`로 설정됩니다.
`requiresSubscription.authenticator.name`	텍스트	`category`가 `externalsubscription`인 경우 필수 - 인증 서비스의 이름입니다. TVE 제공업체의 경우 TVE로 설정합니다.
`requiresSubscription.commonTier`	Boolean	필수 항목인 경우 - 카테고리가 정기 결제로 설정된 경우 필수입니다. 일반 등급 요구사항 문서에서 CommonTier에 대해 자세히 알아보세요.

Entitlement API 요구사항

actionAccessibilityRequirement.category가 subscription 또는 externalSubscription이고 정기 결제 제품에 여러 패키지 또는 등급이 포함되어 있거나 부가기능 지원이 있는 경우 사용 권한 API가 필요합니다. 정기 결제가 한 개의 등급이고 카탈로그의 모든 콘텐츠에 액세스할 수 있는 경우 이 속성을 포함하지 마세요.

회사 A에는 구독한 사용자에게 사용 가능한 모든 콘텐츠에 대한 액세스 권한을 제공하는 단일 구독 서비스가 있습니다. 사용 권한 식별자 / API는 필요하지 않습니다.
회사 B에는 일부 콘텐츠에 대한 액세스를 제공하는 기본 정기 결제와 프리미엄 콘텐츠에 대한 액세스를 제공하는 프리미엄 정기 결제가 있습니다. 사용 권한 식별자 / API는 필수 항목입니다.
회사 C에는 일부 콘텐츠에 대한 액세스를 제공하고 서드 파티 콘텐츠에 대한 액세스를 제공하는 패키지에 추가하는 기본 정기 결제가 있습니다. 사용 권한 식별자 / API는 필수 항목입니다.

미디어 구독 관련 페이지

이러한 속성과 관련된 주제를 알아보려면 다음 페이지를 참고하세요.

오퍼 속성

속성	예상 유형	설명
`expectsAcceptanceOf.@type`	텍스트	필수 - 항상 `Offer`로 설정됩니다.
`expectsAcceptanceOf.price`	Number	필수사항 - 콘텐츠의 구매 가격입니다. 가격은 0이 아닌 양수여야 합니다. 가격이 0.00인 항목의 경우 카테고리를 '무료'로 지정하세요.
`expectsAcceptanceOf.priceCurrency`	텍스트	필수 - 3글자의 ISO 4217 형식으로 나타낸 가격 통화입니다.
`expectsAcceptanceOf.seller`	조직	콘텐츠 구매를 제공하는 조직입니다.
`expectsAcceptanceOf.seller.@type`	텍스트	항상 `Organization`으로 설정합니다.
`expectsAcceptanceOf.seller.name`	텍스트	판매자의 이름입니다.
`expectsAcceptanceOf.seller.sameAs`	텍스트	판매자를 식별하는 웹페이지의 URL입니다(예: 판매자의 홈페이지).

혜택 관련 페이지

이러한 속성과 관련된 주제를 알아보려면 다음 페이지를 참고하세요.

식별자

미디어 작업 피드는 항목을 명확한 방식으로 식별하는 데 도움이 되는 다양한 식별자를 허용합니다. 이러한 식별자는 피드의 콘텐츠를 Google 데이터베이스의 콘텐츠와 조정하는 과정을 가속화하는 데 도움이 됩니다. 이러한 식별자의 대부분은 다양한 항목 유형에서 identifier 속성을 사용하여 피드에 추가할 수 있지만 EIDR에는 자체 대표 속성이 있습니다. 아래에서는 둘 다 설명합니다.

식별자 속성

속성	예상 유형	설명
`identifier`	텍스트	적극 권장 - 특정 항목을 명확하게 식별하는 식별자(일반적으로 외부 식별자) 여러 식별자를 사용할 수 있습니다. 이 속성은 모든 시청 작업 항목에 사용할 수 있습니다. 아래 표에는 `identifier` 속성에 허용되는 식별자와 하위 속성이 나와 있습니다. 시청 작업 피드 예시 섹션의 식별자/EIDR 예시를 참고하세요.

속성	예상 유형	설명
`@type`	텍스트	필수 - 항상 `PropertyValue`로 설정됩니다.
`propertyID`	텍스트	필수 항목 - 다음과 같은 ID 유형이 지원됩니다. `TMS_ROOT_ID`: Gracenote (TMS) 루트 ID (예: 15829) TMS_ID만 사용해야 하는 조직 및 BroadcastService 항목에는 적용되지 않습니다. `TMS_ID`: Gracenote (TMS) 변형 ID (예: MV000398520000) `WIKIDATA_ID`: WikiData ID입니다 (예: Q134773). `IMDB_ID`: IMDB ID (예: tt0109830) `OPTA_ID`: OPTA 스포츠 ID입니다. `STATS_ID`: STATS 공연 ID입니다. `VIP_TIMES_ID`: 일본의 재능을 위한 Japan VIPTimes (Nihon Tarento Meikan) ID `DMA_ID`: GeoShape 객체에 사용되는 미국 지정 마케팅 지역 코드입니다. `_PARTNER_ID_`: 이 속성에는 '_PARTNER_ID_' 문자열이 포함되어야 합니다. 값은 서비스 제공업체에서 내부 또는 외부에서 항목을 식별하기 위해 사용하는 고유 ID여야 합니다(예: 12345 또는 a5c604e2-e9e5-4ff3-b728-245799dc37f1).
`value`	텍스트	필수 - 지정된 ID 시스템의 값입니다.

EIDR 속성

EIDR(Entertainment Identifier Registry의 약자)은 영화 및 TV 프로그램을 비롯한 다양한 미디어 콘텐츠를 위한 글로벌 고유 식별자 시스템입니다. 식별 시스템은 식별자를 최상위 제목, 수정사항과 연결된 메타데이터 레코드로 확인합니다. 다음 표에는 EIDR과 연결된 속성 및 사용법이 나와 있습니다.

속성	예상 유형	설명
`titleEIDR`	텍스트	적극 권장 - EIDR (Entertainment Identifier Registry) 식별자는 가장 일반적이고 추상적인 수준에서 영화 또는 TV 작품을 나타냅니다. 이 속성은 TVSeries, TVSeason, TVEpisode, 영화 항목 사양 페이지에서 사용할 수 있습니다. 예를 들어 'Ghostbusters'로 알려진 영화의 titleEIDR은 '10.5240/7EC7-228A-510A-053E-CBB8-J'입니다. 식별자/EIDR의 예시 섹션 보기{/1
`editEIDR`	텍스트	적극 권장 - EIDR (Entertainment Identifier Registry) 식별자는 영화나 TV 프로그램의 특정 편집/판본을 나타냅니다. 이 속성은 TVEpisode 및 영화 항목 사양 페이지에서 사용할 수 있습니다. 예를 들어 'Ghostbusters'라는 제목의 영화가 '

콘텐츠 등급 부여 기관

BroadcastService.contentRating, Movie.contentRating, TVSeries.contentRating에 대해 이 표의 값을 사용합니다. 등급 기관은 등급 값 앞에 추가해야 합니다. 예:

미국에서 'R' 등급의 영화는 Movie.contentRating 값이 'MPAA R'이어야 합니다.
미국에서 'TV-MA' 등급 TV 값은 'TVPG TV-MA' TVSeries.contentRating 값이 있어야 합니다.

국가	TV 등급 분류 기관	영화 등급 부여 기관
알바니아 (AL)	사용 불가능	사용 불가능
앙골라 (AO)	사용 불가능	참조
앤티가 바부다 (AG)	사용 불가능	MPAA
아르헨티나 (AR)	포함	포함
아르메니아 (AM)	사용 불가능	러시아(MKRF)
아루바 (AW)	사용 불가능	사용 불가능
오스트레일리아(AU)	ACB TV	ACB 영화
오스트리아(AT)	FSK	FSK
아제르바이잔 (AZ)	사용 불가능	러시아(MKRF)
바레인 (BH)	사용 불가능	MPAA
벨라루스 (BY)	사용 불가능	러시아(MKRF)
벨기에(BE)	사용 불가능	MPAA
벨리즈 (BZ)	사용 불가능	사용 불가능
베냉 (BJ)	사용 불가능	CNC
볼리비아 (BO)	사용 불가능	MPAA
보스니아 헤르체고비나 (BA)	사용 불가능	MPAA
보츠와나 (BW)	사용 불가능	MPAA
브라질(BR)	클래스	클래스
부르키나파소 (BF)	사용 불가능	CNC
캄보디아 (KH)	사용 불가능	사용 불가능
캐나다(CA)	캐나다_TV	CHVR
카보베르데 (CV)	사용 불가능	참조
칠레 (CL)	사용 불가능	MPAA
콜롬비아 (CO)	사용 불가능	MPAA
코스타리카 (CR)	사용 불가능	MPAA
크로아티아 (HR)	사용 불가능	사용 불가능
사이프러스 (CY)	사용 불가능	GRFILM
체코 (CZ)	사용 불가능	CZFILM
덴마크(DK)	사용 불가능	MCCYP
에콰도르 (EC)	사용 불가능	MPAA
이집트 (EG)	사용 불가능	MPAA
엘살바도르 (SV)	사용 불가능	MPAA
에스토니아 (EE)	사용 불가능	EEFILM
피지 (FJ)	사용 불가능	사용 불가능
핀란드 (FI)	사용 불가능	MEKU
프랑스(FR)	CSA	CSA
가봉 (GA)	사용 불가능	CNC
독일(DE)	FSK	FSK
그리스 (GR)	ESR	GRFILM
과테말라 (GT)	사용 불가능	MPAA
아이티 (HT)	사용 불가능	사용 불가능
온두라스 (HN)	사용 불가능	MPAA
홍콩(HK)	CA	FCO
헝가리 (HU)	사용 불가능	MPAA
아이슬란드 (IS)	사용 불가능	키즈위저
인도(IN)	CBFC	CBFC
인도네시아 (ID)	KPI	LSF
아일랜드(IE)	사용 불가능	IFCO
이탈리아(IT)	애그리게이터	애그리게이터
코트디부아르 (CI)	사용 불가능	CNC
자메이카 (JM)	사용 불가능	MPAA
일본(JP)	북미	아이린
요르단 (JO)	사용 불가능	MPAA
카자흐스탄 (KZ)	사용 불가능	MRKF
대한민국(KR)	KMRB	KMRB
쿠웨이트 (KW)	사용 불가능	MPAA
키르기스스탄 (KG)	사용 불가능	러시아(MKRF)
라오스 (LA)	사용 불가능	사용 불가능
라트비아 (LV)	사용 불가능	NKCLV
레바논 (LB)	사용 불가능	MPAA
리투아니아 (LT)	사용 불가능	사용 불가능
룩셈부르크 (LU)	사용 불가능	키즈위저
마케도니아 (MK)	사용 불가능	MPAA
말레이시아 (MY)	사용 불가능	FCBM
말리 (ML)	사용 불가능	CNC
몰타 (MT)	사용 불가능	MCCAA
모리셔스 (MU)	사용 불가능	BBFC
멕시코(MX)	RTC	RTC
몰도바 (MD)	사용 불가능	사용 불가능
나미비아 (NA)	사용 불가능	사용 불가능
네팔 (NP)	사용 불가능	MPAA
네덜란드(NL)	키즈위저	키즈위저
뉴질랜드(NZ)	BSA : BSA : BSA	OFLC
니카라과 (NI)	사용 불가능	MPAA
니제르 (NE)	사용 불가능	CNC
노르웨이(NO)	사용 불가능	보통
오만 (OM)	사용 불가능	MPAA
파나마 (PA)	사용 불가능	MPAA
파푸아뉴기니 (PG)	사용 불가능	MPAA
파라과이 (PY)	사용 불가능	MPAA
페루 (PE)	사용 불가능	MPAA
필리핀 (PH)	MTRCB	MTRCB
폴란드 (PL)	사용 불가능	MPAA
포르투갈(PT)	사용 불가능	참조
카타르 (QA)	사용 불가능	MPAA
러시아 (RU)	러시아(MKRF)	러시아(MKRF)
르완다 (RW)	사용 불가능	CNC
사우디아라비아 (SA)	사용 불가능	MPAA
세네갈 (SN)	사용 불가능	MPAA
싱가포르(SG)	사용 불가능	MDA
슬로바키아 (SK)	사용 불가능	MPAA
슬로베니아 (SI)	사용 불가능	MPAA
남아프리카 공화국 (ZA)	FPB	FPB
스페인(ES)	세트	ICAA
스리랑카 (LK)	사용 불가능	사용 불가능
스웨덴(SE)	사용 불가능	SMSA
스위스(CH)	FSK	FSK
타이완(TW)	사용 불가능	모스크바
타지키스탄 (TJ)	사용 불가능	러시아(MKRF)
탄자니아 (TZ)	사용 불가능	MPAA
태국 (TH)	사용 불가능	BFVC
토고 (TG)	사용 불가능	CNC
트리니다드 토바고 (TT)	사용 불가능	사용 불가능
터키 (TR)	RTK	ECBMCT
투르크메니스탄 (TM)	사용 불가능	러시아(MKRF)
우간다 (UG)	사용 불가능	MPAA
우크라이나 (UA)	사용 불가능	사용 불가능
아랍에미리트 (AE)	사용 불가능	MPAA
영국(GB)	BBFC	BBFC
미국(US)	TV_PG	MPAA
우루과이 (UY)	사용 불가능	MPAA
우즈베키스탄 (UZ)	사용 불가능	러시아(MKRF)
베네수엘라 (VE)	사용 불가능	레소비올렌시아
베트남 (VN)	사용 불가능	MCST
잠비아 (ZM)	사용 불가능	MPAA
짐바브웨 (ZW)	사용 불가능	MPAA

GeoShape 속성

GeoShape 객체에는 다음 데이터 유형 중 하나가 포함됩니다.

우편번호 목록(예: 미국, 캐나다 또는 기타 우편번호)
캐나다 순방향 정렬 영역 목록
지정 시장 지역 (Designated Market Area, DMA) ID - 같은 텔레비전 채널과 프로그램을 수신하는 미국의 지역 식별자입니다.

속성	예상 유형	설명
`@id`	URL	필수사항 - URI 형식의 지역 식별자
`@type`	텍스트	필수 - 항상 `GeoShape`로 설정됩니다.
`addressCountry`	텍스트	필수 - 두 글자로 된 ISO 3166-1 alpha-2 국가 코드입니다.
`postalCode`	텍스트	선택사항 - 하나 이상의 우편번호 또는 FSA (순방향 정렬 지역)의 목록입니다.
`identifier`	PropertyValue	선택사항 - 같은 텔레비전 채널과 프로그램을 수신하는 미국의 지역 식별자인 Designated Market Area (DMA) ID.
`identifier.@type`	텍스트	필수 - 항상 `PropertyValue`로 설정됩니다.
`identifier.propertyID`	텍스트	필수 - 항상 `DMA_ID`로 설정됩니다.
`identifier.value`	텍스트	필수 - 지역의 DMA 코드입니다.

우편번호 목록이 포함된 GeoShape 객체의 예:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

FSA (순방향 정렬 영역)와 우편번호의 조합이 포함된 GeoShape 객체의 예:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

DMA ID가 포함된 GeoShape 객체의 예:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}