이 섹션에서는 보기 작업의 공통 속성을 자세히 설명합니다.
작업 마크업 속성
속성 | 예상 유형 | 설명 |
---|---|---|
@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 또는 텍스트 | 필수 - 콘텐츠를 사용할 수 있는 지역입니다. 콘텐츠를 전 세계에서 사용할 수 있는 경우 특수 문자열 EARTH 를 사용합니다. |
actionAccessibilityRequirement.ineligibleRegion |
국가, 도시, 주 또는 GeoShape | 해당하는 경우 필수 - 콘텐츠가 제한된 지역입니다. 콘텐츠가 eligibleRegion 내 모든 위치에서 사용할 수 있는 경우 이 속성을 제공할 필요가 없습니다. |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | 해당하는 경우 필요 - 사용자가 콘텐츠에 액세스하는 데 필요한 구독의 세부정보입니다. 미디어 구독 속성을 참고하세요.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
혜택 | 콘텐츠 구매가 필요한 경우 필수 - 콘텐츠와 연결된 혜택의 세부정보입니다. 다음 케이스의 가격 정보를 제공합니다.
Offer 객체를 완전히 삭제하고 ActionAccessSpecification 객체의 category 를 free 로 설정합니다. 제품 속성을 참고하세요.
|
미디어 구독 속성
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에 관한 자세한 내용은 공통 등급 요구사항 문서를 참고하세요. |
Entitlements API 요구사항
actionAccessibilityRequirement.category
이 subscription
또는 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 |
텍스트 | 필수 - 다음 신분증 유형이 지원됩니다.
|
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 저작물의 특정 수정본/버전을 나타냅니다. 이 속성은 TVEpisode 및 Movie 항목 사양 페이지에서 사용할 수 있습니다. 예를 들어 '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 객체에는 다음 데이터 유형 중 하나가 포함됩니다.
- 우편번호 목록(예: 미국, 캐나다 또는 기타 우편번호)
- 캐나다 전달 분류 지역 목록
- 지정 시장 지역 (DMA) ID: 미국 내에서 사람들이 동일한 TV 채널과 프로그램을 시청하는 지역의 식별자입니다.
속성 | 예상 유형 | 설명 |
---|---|---|
@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"
}
]
}