Phần này cung cấp thông tin chi tiết về các thuộc tính phổ biến của Hành động trên đồng hồ.
Thuộc tính đánh dấu hành động
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
@type |
Văn bản | Bắt buộc – Luôn đặt thành WatchAction . |
target |
EntryPoint | Bắt buộc – Một đối tượng mục tiêu cung cấp bản đồ của đường liên kết sâu đến nhiều nền tảng của Google. |
target.@type |
Văn bản | Bắt buộc – Luôn đặt thành EntryPoint . |
target.urlTemplate |
URL | Bắt buộc – Một đường liên kết sâu đưa người dùng đến ứng dụng hoặc nền tảng của bạn và bắt đầu phát nội dung. |
target.inLanguage |
Văn bản | Không bắt buộc – Ngôn ngữ gốc của bộ phim theo định dạng BCP 47. |
target.actionPlatform |
Văn bản | Bắt buộc – Các nền tảng được liên kết với urlTemplate . Thao tác đối với nội dung nghe nhìn hỗ trợ những tính năng sau:
|
target.additionalProperty |
PropertyValue | Bắt buộc nếu có – Danh sách các cặp thuộc tính-giá trị để đại diện cho các thuộc tính bổ sung của đường liên kết sâu. Nội dung này có thể bao gồm:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Bắt buộc – Đối tượng quy cách truy cập Hành động mô tả yêu cầu truy cập của nội dung. Xem Thuộc tính quy cách truy cập hành động. |
Các trang liên quan đến mã đánh dấu hành động
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những thuộc tính này:
- Tổng quan về mã đánh dấu hành động
- Xác định đường liên kết sâu dành riêng cho nền tảng cho nội dung của bạn
Thuộc tính quy cách quyền truy cập vào hành động
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
actionAccessibilityRequirement.@type |
Văn bản | Bắt buộc – Luôn đặt thành ActionAccessSpecification . |
actionAccessibilityRequirement.category |
Văn bản | Bắt buộc – Yêu cầu về quyền truy cập vào nội dung. Để biết thêm thông tin, hãy xem phần Loại tường phí. Nếu một thực thể đại diện cho một nhóm nội dung, bạn cần đặt
|
actionAccessibilityRequirement.availabilityStarts |
Ngày | Bắt buộc – Ngày mà sau đó hành động này có hiệu lực, ở định dạng ISO 8601 (bao gồm cả múi giờ).
Bạn phải cung cấp thực thể tương ứng trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày availabilityStarts. Việc này sẽ tăng khả năng nội dung xuất hiện đúng hạn trên các nền tảng của Google. |
actionAccessibilityRequirement.availabilityEnds |
Ngày | Bắt buộc – Ngày mà sau đó hành động này không còn được cung cấp nữa, ở định dạng ISO 8601 (bao gồm cả múi giờ).
Bạn phải cập nhật ngày availabilityEnds trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày availabilityEnds. Việc này sẽ làm tăng khả năng nội dung ngừng xuất hiện trên các nền tảng của Google vào ngày availabilityEnds. |
actionAccessibilityRequirement.eligibleRegion |
Country (Quốc gia), City (Thành phố), State (Tiểu bang), GeoShape (Hình dạng địa lý) hoặc Text (Văn bản) | Bắt buộc – Các khu vực nơi nội dung được cung cấp. Sử dụng chuỗi đặc biệt EARTH nếu nội dung có trên toàn cầu. |
actionAccessibilityRequirement.ineligibleRegion |
Quốc gia, Thành phố, Tiểu bang hoặc GeoShape | Bắt buộc (nếu có) – Các khu vực mà nội dung bị hạn chế. Bạn không cần cung cấp thuộc tính này nếu nội dung có sẵn ở mọi nơi trong eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
MediaSubscription | Bắt buộc nếu có – Thông tin chi tiết về gói thuê bao mà người dùng cần để truy cập vào nội dung. Xem Tài sản thuê bao nội dung nghe nhìn.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Ưu đãi | Bắt buộc nếu nội dung yêu cầu mua hàng – Thông tin chi tiết về ưu đãi liên kết với nội dung. Cung cấp thông tin về giá cho các trường hợp sau:
Offer và đặt category từ đối tượng ActionAccessSpecification thành free . Xem Thuộc tính ưu đãi.
|
Tài sản của gói thuê bao nội dung nghe nhìn
Bắt buộc nếu actionAccessibilityRequirement.category
là subscription
hoặc externalSubscription
.
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
requiresSubscription.@type |
Văn bản | Bắt buộc – Luôn đặt thành MediaSubscription |
requiresSubscription.@id |
URL | Bắt buộc – Mã nhận dạng duy nhất của gói thuê bao. Nếu có thể truy cập nội dung qua nhiều gói thuê bao, thì mỗi gói thuê bao phải có một mã nhận dạng duy nhất. |
requiresSubscription.name |
Văn bản | Bắt buộc – Tên của gói thuê bao. Lưu ý những điều sau:
|
requiresSubscription.sameAs |
URL | Trang mô tả gói thuê bao. |
requiresSubscription.identifier |
Văn bản | Bắt buộc nếu category là subscription VÀ
commonTier là false
–
Chuỗi duy nhất cho gói thuê bao này, đại diện cho quyền truy cập vào một nhóm nội dung trong danh mục nội dung nghe nhìn của bạn.
|
requiresSubscription.authenticator |
Tổ chức | Bắt buộc nếu category là externalsubscription – Một vùng chứa cung cấp thông tin chi tiết về trình xác thực của nhà cung cấp bên ngoài. |
requiresSubscription.authenticator.@type |
Văn bản | Bắt buộc nếu category là externalsubscription – Luôn đặt thành Organization . |
requiresSubscription.authenticator.name |
Văn bản | Bắt buộc nếu category là
externalsubscription – Tên của dịch vụ
xác thực. Đối với nhà cung cấp TVE, hãy đặt giá trị này thành TVE |
requiresSubscription.commonTier |
Boolean | Bắt buộc nếu áp dụng – Bạn phải cung cấp thông tin này nếu danh mục được đặt thành gói thuê bao. Đọc thêm về commonTier trong tài liệu về các yêu cầu về cấp độ chung. |
Yêu cầu về Entitlements API
Bạn bắt buộc phải có API quyền nếu actionAccessibilityRequirement.category
là subscription
hoặc externalSubscription
và gói thuê bao của bạn bao gồm nhiều gói hoặc cấp hoặc có hỗ trợ tiện ích bổ sung. Đừng đưa thông tin này vào nếu gói thuê bao của bạn có một cấp và cấp quyền truy cập vào tất cả nội dung trong danh mục của bạn.
- Công ty A cung cấp một gói thuê bao duy nhất cho phép người dùng đã đăng ký truy cập vào tất cả nội dung hiện có: Không bắt buộc phải có Giá trị nhận dạng quyền / API
- Công ty B có một gói thuê bao cơ bản cung cấp quyền truy cập vào một số nội dung và một gói thuê bao cao cấp cung cấp quyền truy cập vào nội dung cao cấp: Bạn phải có Mã nhận dạng quyền / API
- Công ty C có gói thuê bao cơ bản cung cấp quyền truy cập vào một số nội dung và các gói bổ sung cung cấp quyền truy cập vào nội dung của bên thứ ba: Mã nhận dạng quyền / API là bắt buộc
Các trang liên quan đến gói thuê bao nội dung nghe nhìn
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những thuộc tính này:
- Tổng quan về gói thuê bao nội dung nghe nhìn
- Xác định yêu cầu về quyền truy cập vào nội dung của bạn
Thuộc tính ưu đãi
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
expectsAcceptanceOf.@type |
Văn bản | Bắt buộc – Luôn đặt thành Offer . |
expectsAcceptanceOf.price |
Number | Bắt buộc – Giá mua nội dung. Giá phải là một giá trị dương khác 0. Đối với các thực thể có giá 0,00, vui lòng chỉ định danh mục là "miễn phí". |
expectsAcceptanceOf.priceCurrency |
Văn bản | Bắt buộc – Đơn vị tiền tệ của giá ở định dạng ISO 4217 gồm 3 chữ cái. |
expectsAcceptanceOf.seller |
Tổ chức | Tổ chức cung cấp nội dung để mua. |
expectsAcceptanceOf.seller.@type |
Văn bản | Luôn đặt thành Organization . |
expectsAcceptanceOf.seller.name |
Văn bản | Tên của người bán. |
expectsAcceptanceOf.seller.sameAs |
Văn bản | URL của một trang web giúp xác định người bán; ví dụ: trang chủ của người bán. |
Trang liên quan đến ưu đãi
Hãy xem các trang sau đây để biết các chủ đề liên quan đến những tài sản này:
Giá trị nhận dạng
Nguồn cấp dữ liệu Hành động trong nội dung nghe nhìn chấp nhận nhiều giá trị nhận dạng có thể giúp xác định một thực thể một cách rõ ràng. Các giá trị nhận dạng này có thể giúp đẩy nhanh quá trình điều chỉnh nội dung trong nguồn cấp dữ liệu của bạn sao cho khớp với nội dung trong cơ sở dữ liệu của Google. Mặc dù hầu hết các giá trị nhận dạng này đều có thể được thêm vào nguồn cấp dữ liệu bằng cách sử dụng thuộc tính identifier
trên nhiều loại thực thể, nhưng EIDR có thuộc tính đại diện riêng. Cả hai cách này đều được thảo luận bên dưới.
Thuộc tính giá trị nhận dạng
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
identifier |
Văn bản | Nên dùng – Giá trị nhận dạng, thường là giá trị nhận dạng bên ngoài, giúp xác định rõ ràng một thực thể nhất định. Bạn có thể sử dụng nhiều giá trị nhận dạng. Thuộc tính này có trên tất cả các loại thực thể Hành động trên YouTube. Bảng bên dưới liệt kê các giá trị nhận dạng và thuộc tính phụ được chấp nhận của thuộc tính identifier . Xem Ví dụ về Giá trị nhận dạng/EIDR trong phần Ví dụ về nguồn cấp dữ liệu Hành động trên YouTube. |
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
@type |
Văn bản | Bắt buộc – Luôn đặt thành PropertyValue . |
propertyID |
Văn bản | Bắt buộc – Chúng tôi hỗ trợ các loại giấy tờ tuỳ thân sau:
|
value |
Văn bản | Bắt buộc – Giá trị cho hệ thống mã nhận dạng đã chỉ định. |
Thuộc tính EIDR
EIDR (viết tắt của The Entertainment Identifier Registry) là một hệ thống giá trị nhận dạng duy nhất trên toàn cầu cho nhiều loại nội dung nghe nhìn, bao gồm cả phim điện ảnh và chương trình truyền hình. Hệ thống nhận dạng phân giải giá trị nhận dạng thành một bản ghi siêu dữ liệu được liên kết với các tiêu đề, bản chỉnh sửa cấp cao nhất, v.v. Bảng sau đây liệt kê các thuộc tính liên kết với EIDR và cách sử dụng các thuộc tính đó.
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
titleEIDR |
Văn bản | Nên dùng – Mã nhận dạng EIDR (Entertainment Identifier Registry) đại diện cho một tác phẩm điện ảnh hoặc truyền hình ở cấp độ chung nhất/trừu tượng. Thuộc tính này có trên các trang thông số kỹ thuật của thực thể TVSeries, TVSeason, TVEpisode và Movie. Ví dụ: titleEIDR của phim điện ảnh có tên "Ghostbusters" là "10.5240/7EC7-228A-510A-053E-CBB8-J". Xem Ví dụ về Giá trị nhận dạng/EIDR trong phần Ví dụ về nguồn cấp dữ liệu Hành động xem. |
editEIDR |
Văn bản | Nên dùng – Giá trị nhận dạng EIDR (Mã đăng ký nhận dạng nội dung giải trí) đại diện cho một bản chỉnh sửa/ấn bản cụ thể của một tác phẩm điện ảnh hoặc truyền hình. Thuộc tính này có trên các trang thông số kỹ thuật của thực thể TVEpisode và Movie. Ví dụ: phim điện ảnh có tên "Ghostbusters" có mã EIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số bản chỉnh sửa, ví dụ: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3". Thuộc tính titleEIDR là bắt buộc khi bạn cung cấp editEIDR .Xem ví dụ về Giá trị nhận dạng/EIDR trong phần ví dụ về nguồn cấp dữ liệu Hành động trên YouTube. |
Cơ quan phân loại nội dung
Sử dụng các giá trị trong bảng này cho BroadcastService.contentRating
, Movie.contentRating
và TVSeries.contentRating
. Bạn phải thêm tổ chức xếp hạng vào đầu giá trị xếp hạng. Ví dụ:
- Một bộ phim được phân loại "R" ở Hoa Kỳ phải có giá trị
Movie.contentRating
là "MPAA R". - Một chương trình truyền hình được phân loại là "TV-MA" ở Hoa Kỳ phải có giá trị
TVSeries.contentRating
là "TV_PG TV-MA".
Quốc gia | Cơ quan phân loại chương trình truyền hình | Cơ quan phân loại phim |
---|---|---|
Albania (AL) | Không có | Không có |
Angola (AO) | Không có | CCE |
Antigua và Barbuda (AG) | Không có | MPAA |
Argentina (AR) | INCAA | INCAA |
Armenia (AM) | Không có | MKRF/NGA |
Aruba (AW) | Không có | Không có |
Úc (AU) | ACB TV | ACB Movies |
Áo (AT) | FSK | FSK |
Azerbaijan (AZ) | Không có | MKRF/NGA |
Bahrain (BH) | Không có | MPAA |
Belarus (BY) | Không có | MKRF/NGA |
Bỉ (BE) | Không có | MPAA |
Belize (BZ) | Không có | Không có |
Benin (BJ) | Không có | CNC |
Bolivia (BO) | Không có | MPAA |
Bosnia và Herzegovina (BA) | Không có | MPAA |
Botswana (BW) | Không có | MPAA |
Brazil (BR) | CLASSIND | CLASSIND |
Burkina Faso (BF) | Không có | CNC |
Campuchia (KH) | Không có | Không có |
Canada (CA) | CA_TV | CHVRS |
Cape Verde (CV) | Không có | CCE |
Chile (CL) | Không có | MPAA |
Colombia (CO) | Không có | MPAA |
Costa Rica (CR) | Không có | MPAA |
Croatia (HR) | Không có | Không có |
Síp (CY) | Không có | GRFILM |
Cộng hoà Séc (CZ) | Không có | CZFILM |
Đan Mạch (DK) | Không có | MCCYP |
Ecuador (EC) | Không có | MPAA |
Ai Cập (EG) | Không có | MPAA |
El Salvador (SV) | Không có | MPAA |
Estonia (EE) | Không có | EEFILM |
Fiji (FJ) | Không có | Không có |
Phần Lan (FI) | Không có | MEKU |
Pháp (FR) | CSA | CSA |
Gabon (GA) | Không có | CNC |
Đức (DE) | FSK | FSK |
Hy Lạp (GR) | ESR | GRFILM |
Guatemala (GT) | Không có | MPAA |
Haiti (HT) | Không có | Không có |
Honduras (HN) | Không có | MPAA |
Hồng Kông (HK) | CA | FCO |
Hungary (HU) | Không có | MPAA |
Iceland (IS) | Không có | KIJKWIJZER |
Ấn Độ (IN) | CBFC | CBFC |
Indonesia (ID) | KPI | LSF |
Ireland (IE) | Không có | IFCO |
Ý (IT) | AGCOM | AGCOM |
Bờ Biển Ngà (CI) | Không có | CNC |
Jamaica (JM) | Không có | MPAA |
Nhật Bản (JP) | NA | EIRIN |
Jordan (JO) | Không có | MPAA |
Kazakhstan (KZ) | Không có | MRKF |
Hàn Quốc (KR) | KMRB | KMRB |
Kuwait (KW) | Không có | MPAA |
Kyrgyzstan (KG) | Không có | MKRF/NGA |
Lào (LA) | Không có | Không có |
Latvia (LV) | Không có | NKCLV |
Liban (LB) | Không có | MPAA |
Lithuania (LT) | Không có | Không có |
Luxembourg (LU) | Không có | KIJKWIJZER |
Macedonia (MK) | Không có | MPAA |
Malaysia (MY) | Không có | FCBM |
Mali (ML) | Không có | CNC |
Malta (MT) | Không có | MCCAA |
Mauritius (MU) | Không có | BBFC |
Mexico (MX) | RTC | RTC |
Moldova (MD) | Không có | Không có |
Namibia (Bắc Mỹ) | Không có | Không có |
Nepal (NP) | Không có | MPAA |
Hà Lan (NL) | KIJKWIJZER | KIJKWIJZER |
New Zealand (NZ) | BSA | OFLC |
Nicaragua (NI) | Không có | MPAA |
Niger (NE) | Không có | CNC |
Na Uy (NO) | Không có | MEDIETILSYNET |
Oman (OM) | Không có | MPAA |
Panama (PA) | Không có | MPAA |
Papua New Guinea (PG) | Không có | MPAA |
Paraguay (PY) | Không có | MPAA |
Peru (PE) | Không có | MPAA |
Philippines (PH) | MTRCB | MTRCB |
Ba Lan (PL) | Không có | MPAA |
Bồ Đào Nha (PT) | Không có | CCE |
Qatar (QA) | Không có | MPAA |
Nga (RU) | MKRF/NGA | MKRF/NGA |
Rwanda (RW) | Không có | CNC |
Ả Rập Xê Út (SA) | Không có | MPAA |
Senegal (SN) | Không có | MPAA |
Singapore (SG) | Không có | MDA |
Slovakia (SK) | Không có | MPAA |
Slovenia (SI) | Không có | MPAA |
Nam Phi (ZA) | FPB | FPB |
Tây Ban Nha (ES) | SETSI | ICAA |
Sri Lanka (LK) | Không có | Không có |
Thuỵ Điển (SE) | Không có | SMSA |
Thuỵ Sĩ (CH) | FSK | FSK |
Đài Loan (TW) | Không có | MOCTW |
Tajikistan (TJ) | Không có | MKRF/NGA |
Tanzania (TZ) | Không có | MPAA |
Thái Lan (TH) | Không có | BFVC |
Togo (TG) | Không có | CNC |
Trinidad và Tobago (TT) | Không có | Không có |
Thổ Nhĩ Kỳ (TR) | RTÜK | ECBMCT |
Turkmenistan (TM) | Không có | MKRF/NGA |
Uganda (UG) | Không có | MPAA |
Ukraina (UA) | Không có | Không có |
Các Tiểu vương quốc Ả Rập Thống nhất (AE) | Không có | MPAA |
Vương Quốc Anh (GB) | BBFC | BBFC |
Hoa Kỳ (US) | TV_PG | MPAA |
Uruguay (UY) | Không có | MPAA |
Uzbekistan (UZ) | Không có | MKRF/NGA |
Venezuela (VE) | Không có | RESORTEVIOLENCIA |
Việt Nam (VN) | Không có | MCST |
Zambia (ZM) | Không có | MPAA |
Zimbabwe (ZW) | Không có | MPAA |
Thuộc tính GeoShape
Đối tượng GeoShape chứa một trong các loại dữ liệu sau:
- Danh sách mã bưu chính (ví dụ: mã zip của Hoa Kỳ, Canada hoặc các mã zip khác)
- Danh sách khu vực phân loại trước của Canada
- Mã khu vực thị trường được chỉ định (DMA) – Giá trị nhận dạng của một khu vực ở Hoa Kỳ, nơi mọi người nhận được cùng một số kênh và chương trình truyền hình.
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
@id |
URL | Bắt buộc – Giá trị nhận dạng của khu vực địa lý ở định dạng URI. |
@type |
Văn bản | Bắt buộc – Luôn đặt thành GeoShape . |
addressCountry |
Văn bản | Bắt buộc – Mã quốc gia theo tiêu chuẩn ISO 3166-1 alpha-2 gồm hai chữ cái. |
postalCode |
Văn bản | Không bắt buộc – Danh sách một hoặc nhiều mã bưu chính và/hoặc mã FSA (khu vực phân loại chuyển tiếp). |
identifier |
PropertyValue | Không bắt buộc – Mã khu vực thị trường được chỉ định (DMA). Đây là mã nhận dạng của một khu vực ở Hoa Kỳ, nơi mọi người nhận được cùng một chương trình và kênh truyền hình. |
identifier.@type |
Văn bản | Bắt buộc – Luôn đặt thành PropertyValue . |
identifier.propertyID |
Văn bản | Bắt buộc – Luôn đặt thành DMA_ID . |
identifier.value |
Văn bản | Bắt buộc – Mã DMA cho khu vực. |
Ví dụ về đối tượng GeoShape
chứa danh sách mã zip:
{
"@type": "GeoShape",
"@id": "http://example.com/area1",
"addressCountry": "US",
"postalCode": [
"94118",
"94119"
]
}
Ví dụ về đối tượng GeoShape
chứa tổ hợp FSA (khu vực phân loại chuyển tiếp) và mã bưu chính:
{
"@type": "GeoShape",
"@id": "http://example.com/area2",
"addressCountry": "CA",
"postalCode": [
"1A1",
"K1A",
"K1AOB1"
]
}
Ví dụ về đối tượng GeoShape
chứa mã DMA:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}