이 섹션에서는 보기 작업의 일반적인 속성에 관해 자세히 설명합니다.
작업 마크업 속성
속성 | 예상 유형 | 설명 |
---|---|---|
@type |
텍스트 | 필수 - 항상 WatchAction 로 설정됩니다. |
target |
진입점 | 필수 항목 - 딥 링크를 다양한 Google 플랫폼에 매핑하는 대상 객체입니다. |
target.@type |
텍스트 | 필수 - 항상 EntryPoint 로 설정됩니다. |
target.urlTemplate |
URL | 필수 - 사용자가 앱 또는 플랫폼으로 이동하여 콘텐츠 재생을 시작하는 딥 링크입니다. |
target.inLanguage |
텍스트 | 선택사항 - BCP 47 형식의 시리즈 원본 언어입니다. |
target.actionPlatform |
텍스트 | 필수 - urlTemplate 에 매핑된 플랫폼입니다. 미디어 작업은 다음을 지원합니다.
|
target.additionalProperty |
PropertyValue | 필요 시 - 딥 링크의 추가 속성을 나타내는 속성-값 쌍 목록입니다. 여기에는 다음이 포함될 수 있습니다.
|
actionAccessibilityRequirement |
ActionAccessSpec | 필수 - 콘텐츠의 액세스 요구사항을 설명하는 작업 액세스 사양 객체입니다. 작업 액세스 사양 속성을 참조하세요. |
액션 마크업 관련 페이지
이러한 속성과 관련된 주제를 알아보려면 다음 페이지를 참고하세요.
작업 액세스 사양 속성
속성 | 예상 유형 | 설명 |
---|---|---|
actionAccessibilityRequirement.@type |
텍스트 | 필수 - 항상 ActionAccessSpecification 로 설정됩니다. |
actionAccessibilityRequirement.category |
텍스트 | 필수 - 콘텐츠에 대한 액세스 요구사항입니다. 자세한 내용은 페이월 유형을 참조하세요. 항목이 콘텐츠 그룹을 나타내는 경우
|
actionAccessibilityRequirement.availabilityStarts |
날짜 | 필수 - 작업을 사용할 수 있는 날짜입니다. ISO 8601 형식(시간대 포함)으로 나타냅니다.
해당 항목은 availabilityStarts 날짜보다 최소한 7일 전에 피드에 제공해야 합니다. 이렇게 하면 정시에 Google 플랫폼에 콘텐츠가 표시될 가능성이 높아집니다. |
actionAccessibilityRequirement.availabilityEnds |
날짜 | 필수 - 더 이상 사용할 수 없는 날짜입니다. ISO 8601 형식 (시간대 포함)으로 나타냅니다.
availabilityEnds 날짜에 대한 모든 업데이트는 availabilityEnds 날짜 7일 전에 피드에서 이루어져야 합니다. 이렇게 하면 해당 콘텐츠가 availabilityEnds 날짜에 Google 플랫폼에 표시되지 않을 가능성이 커집니다. |
actionAccessibilityRequirement.eligibleRegion |
국가, 도시, 주, GeoShape, 텍스트 | 필수사항 - 콘텐츠를 사용할 수 있는 리전입니다. 콘텐츠가 전역적으로 제공되는 경우 특수 문자열 EARTH 를 사용합니다. |
actionAccessibilityRequirement.ineligibleRegion |
국가, 도시, 주 또는 GeoShape | 필요한 경우 - 콘텐츠가 제한된 지역입니다. eligibleRegion 내의 모든 위치에서 콘텐츠를 사용할 수 있는 경우 이 속성을 제공할 필요가 없습니다. |
actionAccessibilityRequirement.requiresSubscription |
미디어 구독 | 필요한 경우 - 사용자가 콘텐츠에 액세스하기 위해 필요한 정기 결제의 세부정보입니다. 미디어 구독 속성을 참고하세요.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
혜택 | 콘텐츠에 구매가 필요한 경우 필수 - 콘텐츠와 연결된 혜택의 세부정보입니다. 다음과 같은 경우 가격 정보를 제공하세요.
Offer 객체를 완전히 삭제하고 category 을 ActionAccessSpecification 객체에서 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에 대해 자세히 알아보세요. |
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 유형이 지원됩니다.
|
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"
}
]
}