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 tính năng Hành động xem.
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 |
PointPoint | Bắt buộc – Đối tượng mục tiêu cung cấp bản đồ ánh xạ đườ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ộ sách ở đị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 . Media Actions hỗ trợ các thao tác sau:
|
target.additionalProperty |
PropertyValue | Bắt buộc nếu có – Danh sách các cặp giá trị thuộc tính để thể hiện 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 |
Thông số kỹ thuật về quyền truy cập hành động | Bắt buộc – Đối tượng quy cách truy cập vào hành động mô tả yêu cầu về quyền truy cập vào nội dung. Xem Các thuộc tính thông số kỹ thuật về quyền 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 tài sản này:
- Tổng quan về mã đánh dấu hành động
- Xác định các đường liên kết sâu dành riêng cho nền tảng dành cho nội dung của bạn
Thuộc tính thông số kỹ thuật của quyền truy cập 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 sau đó, hành động có thể áp dụng, ở đị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 Bắt đầu. Điều này sẽ giúp tăng xác suất nội dung xuất hiện đúng lúc 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 áp dụng, ở định dạng ISO 8601 (bao gồm cả múi giờ).
Mọi nội dung cập nhật về ngày có hàng Ends phải được cập nhật trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngàyNgày kết thúc. Điều này sẽ làm tăng khả năng nội dung bị ngừng xuất hiện trên các nền tảng của Google vào ngày EndEnds. |
actionAccessibilityRequirement.eligibleRegion |
Quốc gia, Thành phố, Trạng thái, Địa hình hoặc Văn bản | Bắt buộc – Khu vực mà nội dung được cung cấp. Sử dụng chuỗi đặc biệt EARTH nếu nội dung được cung cấp 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ó – Khu vực mà nội dung bị hạn chế. Bạn không cần phải cung cấp thuộc tính này nếu nội dung có ở mọi nơi trong eligibleRegion . |
actionAccessibilityRequirement.requiresSubscription |
Gói thuê bao nội dung đa phương tiện | 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 nội dung. Xem Thuộc tính đăng ký 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 khỏi đối tượng ActionAccessSpecification thành free . Xem Các thuộc tính của ưu đãi.
|
Thuộc tính đăng ký phương tiệ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. Xin 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
–
Một 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 đa phương tiệ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ị thành TVE |
requiresSubscription.commonTier |
Boolean | Bắt buộc nếu có – Đây là yêu cầu bắt buộc nếu bạn đặt danh mục thành gói thuê bao. Hãy đọc thêm về CommonTier trong tài liệu về các yêu cầu chung của cấp. |
Các yêu cầu về API quyền
Cần 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ác cấp hoặc có hỗ trợ bổ sung. Đừng đưa mục này vào gói thuê bao của bạn nếu ứng dụng đó có một cấp và cung 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 có một gói thuê bao duy nhất cấp cho người dùng đã đăng ký quyền truy cập vào tất cả nội dung có sẵn: Giá trị nhận dạng / API quyền không được yêu cầu
- Công ty B 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à gói thuê bao cao cấp cung cấp quyền truy cập vào nội dung trả phí: Phải có mã nhận dạng quyền/API
- Công ty C có gói thuê bao cơ sở cấp quyền truy cập vào một số nội dung và thêm các gói 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 đa phương tiện
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:
- 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 của ư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á bán có 3 chữ cái theo định dạng ISO 4217. |
expectsAcceptanceOf.seller |
Tổ chức | Tổ chức cung cấp giao dịch mua nội dung. |
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 xác định người bán, ví dụ như 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 đối với nội dung đa phương tiệ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ể theo cách không 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 bằng 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 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 các loại thực thể khác nhau, nhưng EIDR có các thuộc tính đại diện riêng. Cả hai loại này đều được thảo luận bên dưới.
Thuộc tính nhận dạng
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
identifier |
Văn bản | Rất nên – 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. Cho phép nhiều giá trị nhận dạng. Thuộc tính này có sẵn trên tất cả các loại thực thể Thao tác xem. Bảng bên dưới liệt kê các giá trị nhận dạng được chấp nhận và thuộc tính phụ của thuộc tính identifier . Xem Ví dụ về giá trị nhận dạng/EIDR trong mục ví dụ về nguồn cấp dữ liệu trên Hành động xem. |
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 mã sau:
|
value |
Văn bản | Bắt buộc – Giá trị của hệ thống mã nhận dạng cụ thể. |
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 mảng nội dung đa phương tiện, bao gồm ảnh chuyển động 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 bản ghi siêu dữ liệu liên kết với các tiêu đề cấp cao nhất, nội dung chỉnh sửa và các thông tin khác. Bảng sau đây liệt kê những thuộc tính liên quan đến EIDR và mức sử dụng của các thuộc tính đó.
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
titleEIDR |
Văn bản | Rất nên dùng - Mã nhận dạng EIDR (Hệ thống đăng ký mã nhận dạng giải trí) đại diện cho một tác phẩm phim hoặc chương trình truyền hình ở cấp độ tổng quát/trừu tượng nhất. Thuộc tính này có sẵn trên các trang thông số kỹ thuật của thực thể TVSeries, TVseason, TVEpisode và Phim. Ví dụ: tiêu đề EIDR cho hình ảnh chuyển động được gọi là "Ghosthosts" là "10.5240/7EC7-228A-510A-053E-CBB8-J". Xem phần Ví dụ về mã nhận dạng/EIDR. |
editEIDR |
Văn bản | Đặc biệt nên dùng – Mã nhận dạng EIDR (Hệ thống đăng ký mã nhận dạng giải trí) biểu thị một bản chỉnh sửa/phiê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 trang đặc điểm của thực thể TVShow và Movie. Ví dụ: Hình ảnh chuyển động có tên là "Ghosthàngs" có tiêu đề là "10.5240/7EC7-228A-510A-053E-CBB8-J", "Có một số bản chỉnh sửa" " phong phú |
Công ty 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
. Cơ quan phân loại phải được thêm vào trước giá trị xếp hạng. Ví dụ:
- Một bộ phim được xếp hạng "R" ở Hoa Kỳ phải có giá trị là
Movie.contentRating
"MPAA R". - Một chương trình truyền hình dài tập được xếp hạng "TV-MA" ở Hoa Kỳ phải có giá trị
TVSeries.contentRating
là "TVPG TV-MA".
Quốc gia | Công ty phân loại chương trình truyền hình | Công ty phân loại phim |
---|---|---|
Albani (AL) | Không có | Không có |
Angola (AO)) | Không có | Giám đốc |
Antigua và Barbuda (AG) | Không có | MPAA |
Argentina (AR) | INAA | INAA |
Armenia (AM) | Không có | MKRF/RUSSIA |
Aruba (AW) | Không có | Không có |
Úc (AU) | ACB TV | Phim ACB |
Áo (AT) | FSK | FSK |
Azerbaijan (AZ) | Không có | MKRF/RUSSIA |
Bahrain (BH) | Không có | MPAA |
Belarus (BY) | Không có | MKRF/RUSSIA |
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 (Brazil) | PHÂN LOẠI | PHÂN LOẠI |
Burkina Fasco (BF) | Không có | CNC |
Campuchia (KH) | Không có | Không có |
Canada (CA) | Canada_TV | CHVR |
Mũi Verde (CV) | Không có | Giám đốc |
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 |
Séc (CZ) | Không có | CZFILM |
Đan Mạch (DK) | Không có | MCCY |
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 (Pháp) | CSA | CSA |
Gabon (Google Analytics) | Không có | CNC |
Đức (DE) | FSK | FSK |
Hy Lạp (GR) | Serbia | GRFILM |
Guatemala (GT) | Không có | MPAA |
Tiếng Haiti (HH) | Không có | Không có |
Honduras (HN) | Không có | MPAA |
Hồng Kông (HK) | California | FCO |
Hungary (HU) | Không có | MPAA |
Iceland (IS) | Không có | KIJKWIJZER |
Ấn Độ (IN) | CBFC | CBFC |
Indonesia (Mã nhận dạng) | KPI | LSF |
Ireland (IE) | Không có | IFCO |
Ý (Ý) | AGCOM | AGCOM |
Bờ Biển Ngà (CI) | Không có | CNC |
Jamaica (JM) | Không có | MPAA |
Nhật Bản (JP) | Không áp dụng | 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/RUSSIA |
Lào (LA) | Không có | Không có |
Tiếng 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 |
Mêhicô (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 (Cục Quảng cáo tương tác) | 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 (Panama) | 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ó | Giám đốc |
Qatar (QA) | Không có | MPAA |
Nga (RU) | MKRF/RUSSIA | MKRF/RUSSIA |
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) | CHUỖI | Hàm ICAA |
Sri Lanka (LK) | Không có | Không có |
Thuỵ Điển (SE) | Không có | SMSA |
Thụy Sĩ (CH) | FSK | FSK |
Đài Loan (TW) | Không có | THÁNG 10 |
Tajikistan (TJ) | Không có | MKRF/RUSSIA |
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) | Xác minh RTRT | ECBMCT |
Turkmenistan (TM) | Không có | MKRF/RUSSIA |
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 (Uruguay) | Không có | MPAA |
Uzbekistan (UZ) | Không có | MKRF/RUSSIA |
Venezuela (VE) | Không có | PHÂN BỔI KHOÁ |
Việt Nam (VN) | Không có | MCST |
Zambia (ZM) | Không có | MPAA |
Zimbabwe (WF) | 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ụ: Hoa Kỳ, Canada hoặc(các) mã bưu chính khác)
- Danh sách các khu vực sắp xếp chuyển tiếp Canada
- Mã thị trường được chỉ định (DMA) – Mã nhận dạng của một khu vực ở Hoa Kỳ nơi mọi người nhận được các kênh và chương trình truyền hình giống nhau.
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 gồm hai chữ cái theo định dạng ISO 3166-1 alpha-2. |
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 (vùng sắp xếp chuyển tiếp). |
identifier |
PropertyValue | Không bắt buộc – Mã khu vực thị trường được chỉ định (DMA), là 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 kênh và chương trì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 của 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 (vùng sắp xếp 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"
}
]
}