이 섹션에서는 Watch Actions의 일반적인 속성에 관한 세부정보를 제공합니다.
작업 마크업 속성
속성 | 예상 유형 | 설명 |
---|---|---|
@type |
텍스트 | 필수 - 항상 WatchAction 로 설정합니다. |
target |
EntryPoint | 필수 - 다양한 Google 플랫폼에 딥 링크의 매핑을 제공하는 타겟 객체입니다. |
target.@type |
텍스트 | 필수 - 항상 EntryPoint 로 설정합니다. |
target.urlTemplate |
URL | 필수 - 사용자를 앱 또는 플랫폼으로 연결하고 콘텐츠 재생을 시작하는 딥 링크입니다. |
target.inLanguage |
텍스트 | 선택사항 - 시리즈의 원본 언어입니다. BCP 47 형식입니다. |
target.actionPlatform |
텍스트 | 필수 - urlTemplate 에 매핑된 플랫폼입니다. 미디어 작업은 다음을 지원합니다.
|
target.additionalProperty |
PropertyValue | 해당하는 경우 필수 - 딥 링크의 추가 속성을 나타내는 속성-값 쌍 목록입니다. 여기에는 다음이 포함될 수 있습니다.
|
actionAccessibilityRequirement |
ActionAccessSpecification | 필수 - 콘텐츠의 액세스 요구사항을 설명하는 작업 액세스 사양 객체입니다. 작업 액세스 사양 속성을 참고하세요. |
작업 마크업 관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.
작업 액세스 사양 속성
속성 | 예상 유형 | 설명 |
---|---|---|
actionAccessibilityRequirement.@type |
텍스트 | 필수 - 항상 ActionAccessSpecification 로 설정합니다. |
actionAccessibilityRequirement.category |
텍스트 | 필수 - 콘텐츠의 액세스 요구사항입니다. 자세한 내용은 페이월 유형을 참고하세요. 엔티티가 콘텐츠 그룹을 나타내는 경우
|
actionAccessibilityRequirement.availabilityStarts |
날짜 | 필수 - 작업이 제공되는 날짜입니다. ISO 8601 형식 (시간대 포함)으로 나타냅니다.
해당 항목은 사용 가능 시작일로부터 최소 7일 전에 피드에 제공되어야 합니다. 이렇게 하면 콘텐츠가 Google 표시 경로에 제때 표시될 가능성이 높아집니다. |
actionAccessibilityRequirement.availabilityEnds |
날짜 | 필수 - 작업이 더 이상 제공되지 않는 날짜입니다. ISO 8601 형식 (시간대 포함)으로 나타냅니다.
availabilityEnds 날짜에 대한 업데이트는 availabilityEnds 날짜 최소 7일 전에 피드에서 이루어져야 합니다. 이렇게 하면 availabilityEnds 날짜에 콘텐츠가 Google 표시 경로에 표시되지 않을 가능성이 높아집니다. |
actionAccessibilityRequirement.eligibleRegion |
국가, 도시, 주, GeoShape 또는 Text | 필수 - 콘텐츠를 사용할 수 있는 지역입니다. 콘텐츠를 전 세계에서 사용할 수 있는 경우 EARTH 특수 문자열을 사용합니다. |
actionAccessibilityRequirement.ineligibleRegion |
국가, 도시, 주 또는 GeoShape | 해당하는 경우 필수 - 콘텐츠가 제한되는 지역입니다. 콘텐츠가 eligibleRegion 내의 모든 지역에서 제공되는 경우 이 속성을 제공하지 않아도 됩니다. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | 해당하는 경우 필수 - 사용자가 콘텐츠에 액세스하는 데 필요한 구독의 세부정보입니다. 미디어 구독 속성을 참고하세요.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
혜택 | 콘텐츠에 구매가 필요한 경우 필수사항 - 콘텐츠와 연결된 혜택의 세부정보입니다. 다음 사례의 가격 정보를 제공하세요.
Offer 객체를 완전히 삭제하고 ActionAccessSpecification 객체의 category 를 free 로 설정합니다. 혜택 속성을 참고하세요.
|
actionAccessibilityRequirement.additionalProperty |
PropertyValue | 해당하는 경우 필수 - 환경에 표시될 정기 결제 패키지에 대한 참조입니다. |
actionAccessibilityRequirement.additionalProperty.name |
텍스트 | 필수 - 항상 'DisplaySubscriptionIdentifier'로 설정 |
actionAccessibilityRequirement.additionalProperty.value |
텍스트 | 필수 - 항목에 표시될 requiresSubscription.@id 입니다.
|
미디어 구독 속성
actionAccessibilityRequirement.category
이 subscription
또는 externalSubscription
인 경우에 필요합니다.
속성 | 예상 유형 | 설명 |
---|---|---|
requiresSubscription.@type |
텍스트 | 필수 - 항상 MediaSubscription 로 설정 |
requiresSubscription.@id |
URL | 필수 - 정기 결제의 고유 ID입니다. 콘텐츠에 여러 구독을 통해 액세스할 수 있는 경우 각 구독에는 고유한 ID가 있어야 합니다. |
requiresSubscription.name |
텍스트 | 필수 - 정기 결제의 이름입니다. 다음 사항에 유의하세요.
|
requiresSubscription.sameAs |
URL | 구독을 설명하는 페이지입니다. |
requiresSubscription.identifier |
텍스트 | category 이 subscription 이고 commonTier 이 false 인 경우 필수
- 미디어 카탈로그의 콘텐츠 그룹에 대한 액세스를 나타내는 이 정기 결제의 고유한 문자열입니다.
|
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 |
숫자 | 필수사항 - 콘텐츠의 구매 가격입니다. 가격은 0이 아닌 양수여야 합니다. 가격이 0.00인 항목의 경우 카테고리를 `free`로 지정하세요. |
expectsAcceptanceOf.priceCurrency |
텍스트 | 필수 - 가격에 사용된 통화로, 3글자 ISO 4217 형식으로 나타냅니다. |
expectsAcceptanceOf.seller |
조직 | 콘텐츠 구매를 제공하는 조직입니다. |
expectsAcceptanceOf.seller.@type |
텍스트 | 항상 Organization 로 설정합니다. |
expectsAcceptanceOf.seller.name |
텍스트 | 판매자 이름입니다. |
expectsAcceptanceOf.seller.sameAs |
텍스트 | 판매자를 식별하는 웹페이지의 URL입니다(예: 판매자의 홈페이지). |
혜택 관련 페이지
이러한 속성과 관련된 주제는 다음 페이지를 참고하세요.
식별자
미디어 작업 피드는 엔티티를 명확하게 식별하는 데 도움이 되는 다양한 식별자를 허용합니다. 이러한 식별자를 사용하면 피드의 콘텐츠와 Google 데이터베이스의 콘텐츠를 조정하는 프로세스를 가속화할 수 있습니다. 이러한 식별자 대부분은 다양한 항목 유형의 identifier
속성을 사용하여 피드에 추가할 수 있지만 EIDR에는 자체 대표 속성이 있습니다. 두 가지 모두 아래에서 설명합니다.
식별자 속성
속성 | 예상 유형 | 설명 |
---|---|---|
identifier |
텍스트 | 매우 권장 - 지정된 항목을 명확하게 식별하는 식별자입니다(일반적으로 외부 식별자). 여러 식별자가 허용됩니다. 이 속성은 모든 Watch Action 항목 유형에서 사용할 수 있습니다. 아래 표에는 identifier 속성의 허용되는 식별자와 하위 속성이 나열되어 있습니다. 시청 작업 피드 예시 섹션의 식별자/EIDR 예시를 참고하세요. |
속성 | 예상 유형 | 설명 |
---|---|---|
@type |
텍스트 | 필수 - 항상 PropertyValue 로 설정합니다. |
propertyID |
텍스트 | 필수 - 다음 신분증 유형이 지원됩니다.
|
value |
텍스트 | 필수 - 지정된 ID 시스템의 값입니다. |
EIDR 속성
EIDR (Entertainment Identifier Registry의 약자)은 영화, TV 프로그램 등 다양한 미디어 콘텐츠를 위한 전역 고유 식별자 시스템입니다. 식별 시스템은 식별자를 최상위 제목, 수정사항 등과 연결된 메타데이터 레코드로 확인합니다. 다음 표에는 EIDR과 관련된 속성과 사용법이 나와 있습니다.
속성 | 예상 유형 | 설명 |
---|---|---|
titleEIDR |
텍스트 | 매우 권장 - EIDR (Entertainment Identifier Registry) 식별자는 가장 일반적/추상적인 수준에서 영화 또는 TV 작품을 나타냅니다. 이 속성은 TVSeries, TVSeason, TVEpisode, Movie 항목 사양 페이지에서 사용할 수 있습니다. 예를 들어 '고스트버스터즈'라는 영화의 titleEIDR은 '10.5240/7EC7-228A-510A-053E-CBB8-J'입니다. '동영상 시청 작업' 피드 예시 섹션의 식별자/EIDR 예시를 참고하세요. |
editEIDR |
텍스트 | 매우 권장 - EIDR (Entertainment Identifier Registry) 식별자는 영화 또는 TV 작품의 특정 편집/버전을 나타냅니다. 이 속성은 TVEpisode 및 Movie 항목 사양 페이지에서 사용할 수 있습니다. 예를 들어 제목EIDR이 '10.5240/7EC7-228A-510A-053E-CBB8-J'인 영화 '고스트버스터즈'에는 '10.5240/1F2A-E1C5-680A-14C6-E76B-I' 및 '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
값은 '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 객체에는 다음 데이터 유형 중 하나가 포함됩니다.
- 우편번호 목록(예: 미국, 캐나다 또는 기타 우편번호)
- 캐나다 우편번호 목록
- 지정 시장 지역 (DMA) ID - 사람들이 동일한 텔레비전 채널과 프로그램을 수신하는 미국의 지역 식별자입니다.
속성 | 예상 유형 | 설명 |
---|---|---|
@id |
URL | 필수 - URI 형식의 지리적 지역 식별자입니다. |
@type |
텍스트 | 필수 - 항상 GeoShape 로 설정합니다. |
addressCountry |
텍스트 | 필수 - 두 글자로 된 ISO 3166-1 alpha-2 국가 코드입니다. |
postalCode |
텍스트 | 선택사항 - 하나 이상의 우편번호 및/또는 FSA (forward sortation area) 코드 목록입니다. |
identifier |
PropertyValue | 선택사항 - 지정 시장 지역 (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"
}
]
}