시청 작업 공통 속성

이 섹션에서는 시청 작업의 일반적인 속성을 자세히 설명합니다.

작업 마크업 속성

속성 예상 유형 설명
@type 텍스트 필수: 항상 WatchAction로 설정합니다.
target EntryPoint 필수: 다음과 같은 타겟 객체입니다. 인코더-디코더 아키텍처를 심도 링크를 여러 Google 플랫폼으로 연결해 줍니다
target.@type 텍스트 필수: 항상 EntryPoint로 설정합니다.
target.urlTemplate URL 필수 - A 심도 링크는 사용자를 앱 또는 플랫폼으로 연결하고 발생합니다.
target.inLanguage 텍스트 선택사항 - 시리즈의 원문 언어 BCP 47 형식으로 입력합니다.
target.actionPlatform 텍스트 필수 - urlTemplate입니다. 미디어 작업은 다음을 지원합니다. <ph type="x-smartling-placeholder">
    </ph>
  • http://schema.org/DesktopWebPlatform: 검색 플랫폼 웹 브라우저에서 볼 수 있습니다.
  • http://schema.org/MobileWebPlatform: 검색 플랫폼 사용 모바일 웹 브라우저를 사용할 수 있습니다.
  • http://schema.org/AndroidPlatform: 검색 및 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 해당되는 경우 필수사항 - 딥 링크의 추가 속성을 나타냅니다. 여기에는 있습니다. <ph type="x-smartling-placeholder">
    </ph>
  • contentLanguage: 방송 언어 (더빙)입니다. BCP 47 형식을 참고하세요. 콘텐츠가 다른 언어로 더빙된 경우 속성은 필수 항목입니다. 여러 언어 코드에 배열을 사용합니다.
  • subtitleLanguage: 자막이 자막, BCP 47 형식을 참고하세요. 여러 언어 코드에 배열을 사용합니다.
  • cameraAngle: 콘텐츠의 카메라 각도입니다. 대상: 예: '눈높이' 'High-Angle'이 포함됩니다. 콘텐츠가 이 지역에서 제공되는 경우 이 속성은 필수입니다. 다음에 배열 사용 촬영할 수 있습니다.
  • videoFormat: 디지털 파일을 저장하는 데 사용되는 파일 형식입니다. 동영상 날짜 예: 'SD' 표준 화질 및 'HD'의 경우 대상: 고화질입니다. 유효한 동영상 형식은 SD, HD, 2K, 4K, 8K입니다. 여러 동영상 형식에 배열을 사용합니다.
자세한 내용은 additionalProperty 예로 들 수 있습니다
actionAccessibilityRequirement ActionAccessSpecification 필수 - 작업 액세스 사양 객체를 참조하세요. 있습니다. 조치 보기 사양 속성에 액세스합니다.

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

작업 액세스 사양 속성

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

필수사항: 콘텐츠 액세스 요구사항 자세히 알아보기 자세한 내용은 페이월 유형.

항목이 콘텐츠 그룹을 나타내는 경우 category 있습니다. 예를 들어 TVSeries에 TVEpisode 콘텐츠가 nologinrequired(으)로 설정됨 subscription로 설정된 일부 애플리케이션이 있는 경우 이를 TVSeries~nologinrequired
actionAccessibilityRequirement.availabilityStarts 날짜

필수 - 액션을 취할 수 있는 이후의 날짜입니다. ISO 8601 형식 (시간대 포함)

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

해당 항목은 이용 가능 시작일보다 최소 7일 전입니다. 이렇게 하면 콘텐츠가 제때에 Google 플랫폼에 표시될 확률이 높아집니다.

actionAccessibilityRequirement.availabilityEnds 날짜 필수 - 작업을 더 이상 사용할 수 없게 되는 날짜입니다. ISO 8601 형식 (시간대 포함)
  • 72시간 이후여야 합니다. availabilityStarts
  • 콘텐츠를 게시한 후 항상 사용할 수 있는 경우 이를 설정합니다. 현재 날짜로부터 20년 후의 날짜를 선택합니다.

availableEnds 날짜를 업데이트해야 합니다. availableEnds 날짜로부터 최소 7일 전에 피드에 표시합니다. 이 콘텐츠가 Google에 표시될 가능성이 높아질 것입니다. availableEnds 날짜에 표시됩니다.

actionAccessibilityRequirement.eligibleRegion 국가, 도시, 주, GeoShape 또는 텍스트 필수사항: 콘텐츠를 사용할 수 있는 지역 사용 콘텐츠를 전역으로 사용할 수 있는 경우 특수 문자열 EARTH입니다.
actionAccessibilityRequirement.ineligibleRegion 국가, 도시, 주 또는 GeoShape 해당하는 경우 필수: 콘텐츠가 제공되는 지역 제한됩니다. 콘텐츠가 다음과 같은 경우 이 속성을 제공할 필요가 없습니다. eligibleRegion의 모든 곳에서 사용할 수 있습니다.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

해당되는 경우 필수사항 - 사용자가 콘텐츠에 액세스하기 위해 필요한 정기 결제 상품입니다. 자세한 내용은 미디어 구독 속성.

  • category가 다음과 같은 경우 이 속성을 제공합니다. subscription 또는 externalSubscription입니다.
actionAccessibilityRequirement.expectsAcceptanceOf 혜택 구매해야 하는 콘텐츠인 경우 필수: 콘텐츠와 관련된 혜택입니다. 다음에 대한 가격 정보를 제공하세요. 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • 일회성 구매 콘텐츠 (rental 또는 purchase)
  • 다른 유료 서비스를 이용해야 하는 구독 기반 콘텐츠 구독자 수 (subscription 또는 externalsubscription)
가격이 0.00이면 Offer 객체를 완전히 삭제하고 ActionAccessSpecification 객체의 category를 free로 설정합니다. 자세한 내용은 혜택 속성.

미디어 구독 속성

actionAccessibilityRequirement.category가 다음에 해당하는 경우 필수 subscription 또는 externalSubscription입니다.

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

Entitlement API 요구사항

Entitlement API는 actionAccessibilityRequirement.category이 subscription인 경우 필수 항목입니다. externalSubscription 및 구독 서비스에는 여러 부가기능 지원이 있는지 여부를 확인할 수 있습니다 다음과 같은 경우 포함하지 마세요. 정기 결제는 한 등급으로 분류되며 카탈로그의 모든 콘텐츠에 대한 액세스를 제공합니다.

  • 회사 A는 정기 결제 사용자에게 제공하는 단일 정기 결제 서비스를 제공합니다. 사용 가능한 모든 콘텐츠에 대한 액세스: 사용 권한 식별자 / API가 아닙니다. 필수
  • 회사 B는 일부 콘텐츠 및 프리미엄 콘텐츠에 대한 액세스를 제공하는 프리미엄 구독: Entitlement Identifier / API는 필수 항목입니다.
  • 회사 C는 일부 콘텐츠 및 서드 파티 콘텐츠에 대한 액세스를 제공하는 부가기능 패키지: Entitlement Identifier / API는 필수 항목입니다.

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

혜택 속성

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

혜택 관련 페이지

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

식별자

미디어 작업 피드는 콘텐츠를 식별하는 데 도움이 되는 다양한 식별자를 엔티티를 명확하게 표시합니다. 이러한 식별자는 피드 콘텐츠와 Google 살펴보겠습니다 이러한 식별자의 대부분은 identifier 속성이 있는 경우, EIDR에는 자체적인 나타냅니다. 이 두 가지 방법은 아래에 설명되어 있습니다.

식별자 속성

속성 예상 유형 설명
identifier 텍스트 적극 권장 - 특정 항목을 명확하게 식별하는 식별자(일반적으로 외부 식별자)입니다. 여러 식별자가 허용됩니다.

이 속성은 모든 시청 작업 항목 유형에서 사용할 수 있습니다.

아래 표에는 identifier 속성의 허용되는 식별자와 하위 속성이 나와 있습니다. 시청 작업 피드 예시 섹션에서 식별자/EIDR 예를 참조하세요.
속성 예상 유형 설명
@type 텍스트 필수: 항상 PropertyValue로 설정합니다.
propertyID 텍스트 필수 - 지원되는 ID 유형은 다음과 같습니다. <ph type="x-smartling-placeholder">
    </ph>
  • 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: 일본 VIPTimes (Nihon Tarento Meikan)의 ID입니다.
  • DMA_ID: 미국 지정 마케팅 지역 번호로, 다음에서 사용됩니다. GeoShape 객체입니다.
  • _PARTNER_ID_: 이 속성에는 문자열이 포함되어야 합니다. '_PARTNER_ID_'인 경우 값은 엔티티를 식별하기 위해 내부 또는 외부에서 (예: 12345 또는 a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value 텍스트 필수 - 지정된 ID 시스템의 값입니다.

EIDR 속성

EIDR (The 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 작품의 특정 편집본/에디션을 나타냅니다.

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

예를 들어 '고스트 버스터즈'라는 영화는 제목 EIDR이 '10.5240/7EC7-228A-510A-053E-CBB8-J'이며 &quot;10.5240/1F2A-E1C5-680A-14C6-E76B-I&quot; 및 '10.5240/8A35-3BEE-6497-5D12-9E4F-3'이 포함됩니다. editEIDR이 제공된 경우

titleEIDR 속성은 필수입니다.

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

콘텐츠 등급 기관

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

  • 'R' 등급의 영화 Movie.contentRating 값은 'MPAA R'이어야 합니다.
  • 'TV-MA' 등급의 TV 시리즈 TVSeries.contentRating 값은 'TVPG TV-MA'여야 합니다.

국가 TV 프로그램 등급 기관 영화 등급 기관
알바니아(AL) 사용할 수 없음 사용할 수 없음
앙골라(AO) 사용할 수 없음 CCE
앤티가 바부다(AG) 사용할 수 없음 MPAA
아르헨티나(AR) INCAA INCAA
아르메니아(AM) 사용할 수 없음 MKRF/RUSSIA
아루바(AW) 사용할 수 없음 사용할 수 없음
오스트레일리아(AU) ACB TV ACB 영화
오스트리아(AT) FSK FSK
아제르바이잔(AZ) 사용할 수 없음 MKRF/RUSSIA
바레인(BH) 사용할 수 없음 MPAA
벨라루스(BY) 사용할 수 없음 MKRF/RUSSIA
벨기에(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) 사용할 수 없음 메쿠
프랑스(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/RUSSIA
라오스 (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/RUSSIA MKRF/RUSSIA
르완다(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/RUSSIA
탄자니아 (TZ) 사용할 수 없음 MPAA
태국(TH) 사용할 수 없음 BFVC
토고(TG) 사용할 수 없음 CNC
트리니다드 토바고(TT) 사용할 수 없음 사용할 수 없음
튀르키예(TR) RTÜK ECBMCT
투르크메니스탄(TM) 사용할 수 없음 MKRF/RUSSIA
우간다(UG) 사용할 수 없음 MPAA
우크라이나(UA) 사용할 수 없음 사용할 수 없음
아랍에미리트(AE) 사용할 수 없음 MPAA
영국(GB) BBFC BBFC
미국(US) TV_PG MPAA
우루과이(UY) 사용할 수 없음 MPAA
우즈베키스탄(UZ) 사용할 수 없음 MKRF/RUSSIA
베네수엘라 (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 선택사항: A DMA (Designated Market Area, 지정 시장 지역)는 미국 내 지역의 식별자로 동일한 TV 채널 및 프로그램을 사용할 수 있습니다.
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"
    }
  ]
}