시청 작업 공통 속성

이 섹션에서는 보기 작업의 공통 속성을 자세히 설명합니다.

작업 마크업 속성

속성 예상 유형 설명
@type 텍스트 필수 - 항상 WatchAction로 설정합니다.
target EntryPoint 필수 - 다양한 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 기기의 전송 및 Home 플랫폼
  • http://schema.googleapis.com/GoogleAudioCast: Chromecast 기기의 Cast 및 Home 플랫폼 (듣기 작업만 해당)
요구사항은 플랫폼 유형 섹션을 참고하세요.
target.additionalProperty PropertyValue 해당하는 경우 필수 - 딥 링크의 추가 속성을 나타내는 속성-값 쌍 목록입니다. 여기에는 다음이 포함될 수 있습니다.
  • contentLanguage: 방송 언어 (더빙)로, BCP 47 형식입니다. 콘텐츠가 다른 언어로 더빙된 경우 이 속성이 필요합니다. 여러 언어 코드에 배열을 사용합니다.
  • subtitleLanguage: 자막 또는 자막의 언어로, BCP 47 형식입니다. 여러 언어 코드에 배열을 사용합니다.
  • cameraAngle: 콘텐츠의 카메라 각도입니다(예: '눈높이', '높은 각도'). 콘텐츠를 다양한 카메라 각도에서 사용할 수 있는 경우 이 속성이 필요합니다. 여러 카메라 각도에는 배열을 사용합니다.
  • videoFormat: 디지털 동영상 날짜를 저장하는 데 사용되는 파일 형식입니다. 예를 들어 표준 화질의 경우 'SD', 고화질의 경우 'HD'입니다. 유효한 동영상 형식은 SD, HD, 2K, 4K, 8K입니다. 여러 동영상 형식에 배열을 사용합니다.
additionalProperty 예시를 참고하세요.
actionAccessibilityRequirement ActionAccessSpecification 필수 - 콘텐츠의 액세스 요구사항을 설명하는 작업 액세스 사양 객체입니다. 작업 액세스 사양 속성을 참고하세요.

이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.

작업 액세스 사양 속성

속성 예상 유형 설명
actionAccessibilityRequirement.@type 텍스트 필수 - 항상 ActionAccessSpecification로 설정합니다.
actionAccessibilityRequirement.category 텍스트

필수 - 콘텐츠에 대한 액세스 요구사항입니다. 자세한 내용은 유료 회원 전용 콘텐츠 유형을 참고하세요.

항목이 콘텐츠 그룹을 나타내는 경우 category를 콘텐츠의 가장 제한적인 액세스 요구사항으로 설정해야 합니다. 예를 들어 TVSeriesnologinrequired로 설정된 TVEpisode 콘텐츠가 일부 있고 subscription로 설정된 콘텐츠가 일부 있는 경우 이 TVSeriesnologinrequired로 설정합니다.

actionAccessibilityRequirement.availabilityStarts 날짜

필수 - 이 날짜 이후에 작업을 사용할 수 있습니다. ISO 8601 형식 (시간대 포함)으로 입력합니다.

  • 날짜는 미래로 설정할 수 있습니다.

해당 항목은 사용 가능 시작일로부터 최소 7일 전에 피드에 제공되어야 합니다. 이렇게 하면 콘텐츠가 Google 플랫폼에 제때 표시될 가능성이 높아집니다.

actionAccessibilityRequirement.availabilityEnds 날짜 필수 - 이 날짜 이후에는 더 이상 액션을 사용할 수 없습니다. ISO 8601 형식 (시간대 포함)으로 입력합니다.
  • availabilityStarts 후 72시간 이상이어야 합니다.
  • 콘텐츠가 게시된 후 항상 사용할 수 있는 경우 이 날짜를 현재 날짜로부터 20년으로 설정합니다.

availabilityEnds 날짜는 availabilityEnds 날짜로부터 최소 7일 전에 피드에서 업데이트해야 합니다. 이렇게 하면 availabilityEnds 날짜에 콘텐츠가 Google 표시 경로에 더 이상 표시되지 않을 가능성이 높아집니다.

actionAccessibilityRequirement.eligibleRegion 국가, 도시, , GeoShape 또는 텍스트 필수 - 콘텐츠를 사용할 수 있는 지역입니다. 콘텐츠를 전 세계에서 사용할 수 있는 경우 특수 문자열 EARTH를 사용합니다.
actionAccessibilityRequirement.ineligibleRegion 국가, 도시, 또는 GeoShape 해당하는 경우 필수 - 콘텐츠가 제한된 지역입니다. 콘텐츠가 eligibleRegion 내 모든 위치에서 사용할 수 있는 경우 이 속성을 제공할 필요가 없습니다.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

해당하는 경우 필요 - 사용자가 콘텐츠에 액세스하는 데 필요한 구독의 세부정보입니다. 미디어 구독 속성을 참고하세요.

  • categorysubscription 또는 externalSubscription인 경우 이 속성을 제공합니다.
actionAccessibilityRequirement.expectsAcceptanceOf 혜택 콘텐츠 구매가 필요한 경우 필수 - 콘텐츠와 연결된 혜택의 세부정보입니다. 다음 케이스의 가격 정보를 제공합니다.
  • 일회성 구매 콘텐츠 (rental 또는 purchase)
  • 구독자가 추가로 구매해야 하는 정기 결제 기반 콘텐츠 (subscription 또는 externalsubscription)
가격이 0.00이면 Offer 객체를 완전히 삭제하고 ActionAccessSpecification 객체의 categoryfree로 설정합니다. 제품 속성을 참고하세요.

미디어 구독 속성

actionAccessibilityRequirement.categorysubscription 또는 externalSubscription인 경우에 필요합니다.

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

Entitlements API 요구사항

actionAccessibilityRequirement.categorysubscription 또는 externalSubscription이고 구독 제품에 여러 패키지 또는 등급이 포함되어 있거나 부가기능이 지원되는 경우 entitlement API가 필요합니다. 구독 등급이 하나이고 카탈로그의 모든 콘텐츠에 액세스할 수 있는 경우 이 항목을 포함하지 마세요.

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

이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.

혜택 속성

속성 예상 유형 설명
expectsAcceptanceOf.@type 텍스트 필수 - 항상 Offer로 설정합니다.
expectsAcceptanceOf.price 숫자 필수 - 콘텐츠의 구매 가격입니다. 가격은 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 텍스트 필수 - 다음 신분증 유형이 지원됩니다.
  • TMS_ROOT_ID: Gracenote (TMS) 루트 ID입니다 (예: 15829).
  • . 이는 TMS_ID만 사용해야 하는 Organization 및 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, Movie 항목 사양 페이지에서 사용할 수 있습니다.

예를 들어 'Ghostbusters'라는 영화의 titleEIDR은 '10.5240/7EC7-228A-510A-053E-CBB8-J'입니다.

시청 액션 피드 예시 섹션의 식별자/EIDR 예시를 참고하세요.
editEIDR 텍스트 적극 권장 - EIDR (Entertainment Identifier Registry) 식별자는 영화 또는 TV 저작물의 특정 수정본/버전을 나타냅니다.

이 속성은 TVEpisodeMovie 항목 사양 페이지에서 사용할 수 있습니다.

예를 들어 'Ghostbusters'라는 영화의 titleEIDR이 '10.5240/7EC7-228A-510A-053E-CBB8-J'인 경우 여러 수정본(예: '10.5240/1F2A-E1C5-680A-14C6-E76B-I', '10.5240/8A35-3BEE-6497-5D12-9E4F-3')이 있습니다.

titleEIDR 속성은 editEIDR이 제공된 경우 필수입니다.

시청 액션 피드 예시 섹션의 식별자/EIDR 예시를 참고하세요.

콘텐츠 등급 기관

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

  • 미국에서 'R' 등급을 받은 영화의 Movie.contentRating 값은 'MPAA R'이어야 합니다.
  • 미국에서 'TV-MA' 등급이 지정된 TV 시리즈의 TVSeries.contentRating 값은 'TV_PG TV-MA'여야 합니다.

국가 TV 등급 기관 영화 등급 기관
알바니아(AL) 사용할 수 없음 사용할 수 없음
앙골라(AO) 사용할 수 없음 CCE
앤티가 바부다(AG) 사용할 수 없음 MPAA
아르헨티나(AR) INCAA INCAA
아르메니아(AM) 사용할 수 없음 MKRF/러시아
아루바(AW) 사용할 수 없음 사용할 수 없음
오스트레일리아(AU) ACB TV ACB Movies
오스트리아(AT) FSK FSK
아제르바이잔(AZ) 사용할 수 없음 MKRF/러시아
바레인(BH) 사용할 수 없음 MPAA
벨라루스(BY) 사용할 수 없음 MKRF/러시아
벨기에(BE) 사용할 수 없음 MPAA
벨리즈(BZ) 사용할 수 없음 사용할 수 없음
베냉(BJ) 사용할 수 없음 CNC
볼리비아(BO) 사용할 수 없음 MPAA
보스니아·헤르체고비나(BA) 사용할 수 없음 MPAA
보츠와나(BW) 사용할 수 없음 MPAA
브라질(BR) CLASSIND CLASSIND
부르키나파소(BF) 사용할 수 없음 CNC
캄보디아(KH) 사용할 수 없음 사용할 수 없음
캐나다(CA) CA_TV CHVRS
카보베르데 (CV) 사용할 수 없음 CCE
칠레(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) 사용할 수 없음 KIJKWIJZER
인도(IN) CBFC CBFC
인도네시아(ID) KPI LSF
아일랜드(IE) 사용할 수 없음 IFCO
이탈리아(IT) AGCOM AGCOM
코트디부아르 (CI) 사용할 수 없음 CNC
자메이카(JM) 사용할 수 없음 MPAA
일본(JP) 해당 사항 없음 EIRIN
요르단(JO) 사용할 수 없음 MPAA
카자흐스탄(KZ) 사용할 수 없음 MRKF
대한민국(KR) KMRB KMRB
쿠웨이트(KW) 사용할 수 없음 MPAA
키르기스스탄(KG) 사용할 수 없음 MKRF/러시아
라오스 (LA) 사용할 수 없음 사용할 수 없음
라트비아(LV) 사용할 수 없음 NKCLV
레바논(LB) 사용할 수 없음 MPAA
리투아니아(LT) 사용할 수 없음 사용할 수 없음
룩셈부르크(LU) 사용할 수 없음 KIJKWIJZER
북마케도니아(MK) 사용할 수 없음 MPAA
말레이시아(MY) 사용할 수 없음 FCBM
말리(ML) 사용할 수 없음 CNC
몰타(MT) 사용할 수 없음 MCCAA
모리셔스(MU) 사용할 수 없음 BBFC
멕시코(MX) RTC RTC
몰도바 (MD) 사용할 수 없음 사용할 수 없음
나미비아(NA) 사용할 수 없음 사용할 수 없음
네팔(NP) 사용할 수 없음 MPAA
네덜란드(NL) KIJKWIJZER KIJKWIJZER
뉴질랜드(NZ) BSA OFLC
니카라과(NI) 사용할 수 없음 MPAA
니제르(NE) 사용할 수 없음 CNC
노르웨이(NO) 사용할 수 없음 MEDIETILSYNET
오만(OM) 사용할 수 없음 MPAA
파나마(PA) 사용할 수 없음 MPAA
파푸아뉴기니(PG) 사용할 수 없음 MPAA
파라과이(PY) 사용할 수 없음 MPAA
페루(PE) 사용할 수 없음 MPAA
필리핀(PH) MTRCB MTRCB
폴란드(PL) 사용할 수 없음 MPAA
포르투갈(PT) 사용할 수 없음 CCE
카타르(QA) 사용할 수 없음 MPAA
러시아(RU) MKRF/러시아 MKRF/러시아
르완다(RW) 사용할 수 없음 CNC
사우디아라비아(SA) 사용할 수 없음 MPAA
세네갈(SN) 사용할 수 없음 MPAA
싱가포르(SG) 사용할 수 없음 MDA
슬로바키아(SK) 사용할 수 없음 MPAA
슬로베니아(SI) 사용할 수 없음 MPAA
남아프리카 공화국(ZA) FPB FPB
스페인(ES) SETSI ICAA
스리랑카(LK) 사용할 수 없음 사용할 수 없음
스웨덴(SE) 사용할 수 없음 SMSA
스위스(CH) FSK FSK
타이완(TW) 사용할 수 없음 MOCTW
타지키스탄(TJ) 사용할 수 없음 MKRF/러시아
탄자니아 (TZ) 사용할 수 없음 MPAA
태국(TH) 사용할 수 없음 BFVC
토고(TG) 사용할 수 없음 CNC
트리니다드 토바고(TT) 사용할 수 없음 사용할 수 없음
튀르키예(TR) RTÜK ECBMCT
투르크메니스탄(TM) 사용할 수 없음 MKRF/러시아
우간다(UG) 사용할 수 없음 MPAA
우크라이나(UA) 사용할 수 없음 사용할 수 없음
아랍에미리트(AE) 사용할 수 없음 MPAA
영국(GB) BBFC BBFC
미국(US) TV_PG MPAA
우루과이(UY) 사용할 수 없음 MPAA
우즈베키스탄(UZ) 사용할 수 없음 MKRF/러시아
베네수엘라 (VE) 사용할 수 없음 RESORTEVIOLENCIA
베트남(VN) 사용할 수 없음 MCST
잠비아(ZM) 사용할 수 없음 MPAA
짐바브웨(ZW) 사용할 수 없음 MPAA

GeoShape 속성

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

속성 예상 유형 설명
@id URL 필수 - URI 형식의 지역 식별자입니다.
@type 텍스트 필수 - 항상 GeoShape로 설정합니다.
addressCountry 텍스트 필수 - 두 글자로 된 ISO 3166-1 alpha-2 국가 코드입니다.
postalCode 텍스트 선택사항 - 하나 이상의 우편번호 또는 FSA (전달 분류 지역) 코드 목록입니다.
identifier PropertyValue 선택사항 - 지정 시장 지역 (DMA) ID: 미국 내에서 동일한 TV 채널과 프로그램을 시청하는 지역을 식별하는 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"
    }
  ]
}