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 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 |
EntryPoint | Bắt buộc – Đối tượng mục tiêu cung cấp bản đồ ánh xạ của sâu đường liên kết đế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 – A 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 bằng BCP 47 . |
target.actionPlatform |
Văn bản | Bắt buộc – Các nền tảng được liên kết tới
urlTemplate . Hành động đối với nội dung đa phương tiệ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ị để
thể hiện các thuộc tính bổ sung của đường liên kết sâu. Điều này có thể bao gồm
sau:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Bắt buộc - Hành động đối tượng thông số truy cập mô tả yêu cầu truy cập vào nội dung. Xem Hành động Truy cập vào các thuộc tính thông số kỹ thuật. |
Các trang liên quan đến đánh dấu hành động
Hãy xem các trang sau để biết những 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 cho nội dung của bạn
Thuộc tính thông số kỹ thuật về 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, xem 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 có sẵn, theo ISO Định dạng 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ại ít nhất 7 ngày trước ngày bắt đầu. Điều này sẽ cải thiện khả năng nội dung xuất hiện trên các nền tảng của Google đúng thời điểm. |
actionAccessibilityRequirement.availabilityEnds |
Ngày | Bắt buộc – Ngày mà sau đó hành động này không còn thực hiện được nữa,
trong ISO
Định dạng 8601 (bao gồm cả múi giờ).
Bạn phải cập nhật tình trạng còn hàng (Kết thúc) trong nguồn cấp dữ liệu ít nhất 7 ngày trước ngày kết thúc lịch phát sóng. Chiến dịch này sẽ nâng cao cơ hội nội dung bị ngừng xuất hiện trên Google các nền tảng về tình trạng còn hàng. |
actionAccessibilityRequirement.eligibleRegion |
Quốc gia, Thành phố, Tiểu bang, GeoShape hoặc Văn bản | Bắt buộc – Những 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ó sẵn 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 nơi nội dung được đề cập
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ề mà người dùng cần để truy cập vào nội dung. Xem Thuộc tính gói 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 – Thông tin chi tiết về
ưu đãi có liên quan đến nội dung. Cung cấp thông tin về giá cho
các trường hợp sau:
Offer rồi đặt category từ đối tượng ActionAccessSpecification thành free . Xem
Thuộc tính ưu đãi.
|
Thuộc tính 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 nội dung có thể truy cập qua các thuê bao khác nhau, mỗ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. Hãy 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 – 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 phương thức xác thực
. Đối với nhà cung cấp dịch vụ TVE, hãy đặt chế độ này 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 danh mục được đặt thành của bạn. Đọc thêm vềcommonTier trong phổ biến tài liệu về yêu cầu về cấp. |
Các yêu cầu về Entitlement API (API Quyền)
API Quyền là
bắt buộc 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/cấp hoặc có dịch vụ hỗ trợ tiện ích bổ sung. Đừng thêm mã này nếu
gói thuê bao có một cấp độ và cho phép 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 dịch vụ thuê bao duy nhất mang lại cho người dùng đã đăng ký quyền truy cập vào tất cả nội dung hiện có: Giá trị nhận dạng quyền / API không bắt buộc
- Công ty B có một gói thuê bao cơ bản, cấp quyền truy cập vào một số nội dung và gói thuê bao trả phí cho phép bạn truy cập vào nội dung trả phí: Cần có Mã nhận dạng quyền / API
- Công ty C có một gói thuê bao cơ bản, cấp quyền truy cập vào một số nội dung và thêm vào các gói cung cấp quyền truy cập vào nội dung của bên thứ ba: Cần có Mã nhận dạng quyền / API
Các trang liên quan đến gói thuê bao nội dung nghe nhìn
Hãy xem các trang sau để biết những 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
Cơ sở lưu trú ư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á bằng 0, 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á ở dạng 3 chữ cái ISO Định dạng 4217. |
expectsAcceptanceOf.seller |
Tổ chức | Tổ chức cho phép 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ụ: trang chủ của người bán. |
Trang liên quan đến ưu đãi
Hãy xem các trang sau để biết những 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
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 với nội dung trong
cơ sở dữ liệu. Mặc dù bạn có thể thêm hầu hết các giá trị nhận dạng này 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ể, EIDR có thuộc tính riêng
tài sản đại diện. Cả hai phương pháp này sẽ được thảo luận dưới đây.
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. Được phép sử dụng nhiều giá trị nhận dạng. Tài sản này dùng được cho mọi loại thực thể Hành động theo dõi. Bảng dưới đây liệt kê các giá trị nhận dạng và thuộc tính phụ được chấp nhận của tài sản identifier . Hãy 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. |
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ã nhận dạng sau đây:
|
value |
Văn bản | Bắt buộc – Giá trị cho hệ thống mã nhận dạng được chỉ định. |
Thuộc tính EIDR
EIDR (viết tắt của The Entertainment nhận Registry) là một hệ thống nhận dạng duy nhất trên toàn cầu cho một loạt nội dung đa phương tiện, bao gồm cả ảnh động và chương trình truyền hình. Hệ thống nhận dạng sẽ phân giải giá trị nhận dạng cho một 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à những nội dung khác. Bảng sau đây liệt kê các tài sản được liên kết với EIDR và cách sử dụng các tài sản đó.
Thuộc tính | Loại dự kiến | Mô tả |
---|---|---|
titleEIDR |
Văn bản | Được đề xuất ở mức độ cao – Giá trị nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện một tác phẩm phim hoặc chương trình truyền hình ở cấp độ chung/trừu tượng nhất. Thuộc tính này có trên các trang thông số kỹ thuật thực thể TVSeries, TVSeason, TVEpisode và Phim. Ví dụ: phim EIDR cho phim điện ảnh có tên là "Ghosthosts" là "10.5240/7EC7-228A-510A-053E-CBB8-J". Hãy xem Ví dụ về mã 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 | Được đề xuất cao - Giá trị nhận dạng EIDR (Sổ đăng ký mã nhận dạng nội dung giải trí) thể hiện bản chỉnh sửa/ấn bản cụ thể cho tác phẩm phim hoặc chương trình 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 ảnh chuyển động có tên là "Phim ma" có tiêu đềEIDR là "10.5240/7EC7-228A-510A-053E-CBB8-J", có một số nội dung chỉnh sửa, ví dụ: "10.5240/1F2A-E1C5-680A-14C6-E76B-I" và "10.5240/8A35-3BEE-6497-5D12-9E4F-3". titleEIDR thuộc tính bắt buộc khi editEIDR được cung cấp.Hãy xem Ví dụ về mã nhận dạng/EIDR trong phần ví dụ về nguồn cấp dữ liệu Hành động xem. |
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
. Giá trị xếp hạng phải được thêm vào trước cơ quan xếp hạng. Ví dụ:
- Một bộ phim được xếp hạng "R" ở Hoa Kỳ phải có giá trị
Movie.contentRating
là "MPAA R". - Một bộ phim 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ơ quan xếp hạng phim |
---|---|---|
Albani (AL) | Không có | Không có |
Angola (AO) | Không có | CCE |
Antigua và Barbuda (AG) | Không có | MPAA |
Argentina (Argentina) | INCAA | INCAA |
Armenia (AM) | Không có | MKRF/RUSSIA |
Tiếng Aruba (AW) | Không có | Không có |
Úc (AU) | TV ACB | Phim của 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 (Tây Ban Nha) | Không có | MPAA |
Brazil (BR) | PHÂN LOẠI | PHÂN LOẠI |
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 |
Tiếng 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 (Mã nhận dạng) | 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/RUSSIA |
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 |
Philipin (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/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) | 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 (Đài Loan) | Không có | MOCTW |
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) | RTÜK | ECBMCT |
Tiếng 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 (UY) | Không có | MPAA |
Uzbekistan (UZ) | Không có | MKRF/RUSSIA |
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 hình dạng địa lý
Đố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 của Canada
- Mã nhận dạng 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 xem cùng 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 - Bao gồm hai chữ cái ISO 3166-1 alpha-2 Mã quốc gia. |
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 sắp xếp chuyển tiếp). |
identifier |
PropertyValue | Không bắt buộc – A Mã nhận dạng khu vực thị trường được chỉ định (DMA), là giá trị nhận dạng của khu vực tại Hoa Kỳ nơi mọi người nhận được cùng các 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ã bưu chính:
{
"@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 sắp xếp tiến) 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ã nhận dạng DMA:
{
"@type": "GeoShape",
"@id": "http://example.com/area3",
"addressCountry": "US",
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "DMA_ID",
"value": "501"
}
]
}