Phần này cung cấp thông tin chi tiết về các thuộc tính đánh dấu nội dung cho
Loại thực thể MediaService
thu thập cấu hình cho Hành động đối với nội dung đa phương tiện của bạn
tích hợp
Bảng thông số kỹ thuật
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 |
@context
|
Văn bản |
Bắt buộc – Luôn đặt thành |
@id
|
URL |
Bắt buộc – Giá trị nhận dạng duy nhất của thương hiệu; ví dụ:
Giá trị nhận dạng này phải tuân thủ các yêu cầu sau:
|
name
|
Văn bản |
Bắt buộc – Tên của nhà cung cấp. Nếu thương hiệu của bạn có tên dành riêng cho từng ngôn ngữ, hãy liệt kê các tên đó trong một mảng. Ví dụ: hãy tham khảo ví dụ về MediaService. |
brandIcon
|
ImageObject (Đối tượng hình ảnh) |
Bắt buộc đối với tất cả Hành động xem và Hành động nghe – Tệp hình ảnh thương hiệu của bạn biểu tượng, lặp lại, cho từng kích thước. Trong kết quả Hành động xem/Nghe, Google liên kết đường liên kết sâu của nội dung đến biểu tượng thương hiệu của bạn. Tệp hình ảnh biểu tượng thương hiệu của bạn phải tuân thủ các yêu cầu sau:
Thuộc tính này phải lặp lại vì bạn phải cung cấp 5 hình ảnh, mỗi hình ảnh cho một các phương diện sau:
Yêu cầu bổ sung cho việc tích hợp GoogleTV – Những hình ảnh này về thương hiệu của bạn sẽ được hiển thị ở đầu Hướng dẫn lập trình, trên các nút Tác vụ xem và trong phần cài đặt Google TV. Cung cấp 3 biểu tượng đáp ứng các yêu cầu sau:
Hãy đảm bảo hình ảnh đã được khử răng cưa và không bị méo/pixel. |
brandIcon.contentURL
|
URL |
Bắt buộc – URL của hình ảnh. |
brandIcon.height
|
Number |
Bắt buộc – Chiều cao của hình ảnh, tính bằng pixel. |
brandIcon.width
|
Number |
Bắt buộc – Chiều rộng của hình ảnh, tính bằng pixel. |
brandIcon.additionalProperty
|
PropertyValue |
Bắt buộc – Thuộc tính bổ sung dùng để mô tả loại hình ảnh và xác định loại hình ảnh mục đích sử dụng. |
brandIcon.additionalProperty.@type
|
Văn bản |
Bắt buộc – Đặt thành |
brandIcon.additionalProperty.name
|
Văn bản |
Bắt buộc – Đặt thành |
brandIcon.additionalProperty.value
|
Văn bản |
Bắt buộc – Mức độ phù hợp khi ở chế độ nền. Để hợp lệ, hãy đặt thành ít nhất một trong các giá trị sau:
|
application
|
SotfwareApplication |
Bắt buộc nếu bạn cung cấp các ứng dụng iOS, Android, Cast hoặc AndroidTV – Danh sách các ứng dụng thương hiệu của bạn sau đây:
|
application.@type
|
Văn bản |
Bắt buộc – Luôn đặt thành |
application.operatingSystem
|
Văn bản |
Bắt buộc – Đặt thành một trong các giá trị sau:
|
application.downloadUrl
|
URL |
Bắt buộc nếu có – Đối với nền tảng Android, Android TV và iOS, bạn phải chỉ định URL này làm đường liên kết đến ứng dụng của bạn trong App Store và Cửa hàng Play. Đối với tất cả các nền tảng khác, đây không phải là thuộc tính bắt buộc. |
application.installUrl
|
URL |
Bắt buộc nếu có – Nếu nhà cung cấp cung cấp tính năng phát nội dung nghe nhìn thông qua Bạn phải chỉ định tệp này làm đường liên kết đến tệp APK AndroidTV. Nếu nhà cung cấp không cung cấp tính năng phát cho Android TV thì đây không phải là tài sản bắt buộc. |
application.identifier
|
Bắt buộc nếu có – Đối với các nền tảng tương ứng với một trong các tiêu chí sau giá trị, hãy thiết lập nó sao cho phù hợp. Thuộc tính này là không bắt buộc:
|
|
parentOrganization
|
Tổ chức |
Bắt buộc – Nhà cung cấp mẹ của dịch vụ. |
parentOrganization.@type
|
Văn bản |
Bắt buộc – Luôn đặt thành |
parentOrganization.name
|
Văn bản |
Bắt buộc – Tên tổ chức. |
subscriptions
|
MediaSubscription |
Không bắt buộc – Danh sách |
baseSubscriptionTier
|
MediaSubscription |
Bắt buộc nếu có – Nếu nhà cung cấp đồng hồ và nhà cung cấp đó có cơ sở gói thuê bao, bạn phải đặt giá trị này thành phiên bản gói thuê bao cho nội dung có sẵn cho tất cả người đăng ký. Thuộc tính này là không bắt buộc. |
userRequestsFulfilledBy
|
Văn bản |
Không bắt buộc – Đặt thành một trong các bên sau đây sẽ đáp ứng nhu cầu của người dùng yêu cầu:
Theo mặc định, thuộc tính này được đặt thành |
mediaOffered
|
Văn bản |
Bắt buộc – Đặt thành một trong các giá trị sau, tương ứng với loại nội dung trong danh mục của bạn được đưa vào nguồn cấp dữ liệu:
|
Ví dụ về MediaService
{ "@context": "http://schema.org", "@type": "DataFeed", "dateModified": "2018-07-20T00:44:51Z", "dataFeedElement": [ { "@context": [ "http://schema.org", { "@language": "en" } ], "@type": "MediaService", "@id": "https://abcmedia.com", "name": [ { "@language": "en-us", "@value": "ABC Media" }, { "@language": "en-gb", "@value": "ABC" } ], "userRequestsFulfilledBy": "Google", "mediaOffered": [ "LiveTV", "VoD" ], "brandIcon": [ { "@type": "ImageObject", "contentURL": "https://abcmedia.com/path_to_logo_16x16.png", "width": 16, "height": 16, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "forDarkBackground", "forLightBackground" ] } ] }, { "@type": "ImageObject", "contentURL": "https://abcmedia.com/path_to_logo_20x20.png", "width": 20, "height": 20, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "forDarkBackground", "forLightBackground" ] } ] }, { "@type": "ImageObject", "contentURL": "https://abcmedia.com/path_to_logo_40x40.png", "width": 40, "height": 40, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "forDarkBackground", "forLightBackground" ] } ] }, { "@type": "ImageObject", "contentURL": "https://abcmedia.com/path_to_logo_44x44.png", "width": 44, "height": 44, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "forDarkBackground", "forLightBackground" ] } ] }, { "@type": "ImageObject", "contentURL": "https://abcmedia.com/path_to_logo_112x112.png", "width": 112, "height": 112, "additionalProperty": [ { "@type": "PropertyValue", "name": "contentAttributes", "value": [ "forDarkBackground", "forLightBackground" ] } ] } ], "application": [ { "@type": "SoftwareApplication", "operatingSystem": "Android", "downloadUrl": "https://google.play.store/com.abc.media.android", "identifier": "com.abc.media.android" }, { "@type": "SoftwareApplication", "operatingSystem": "iOS", "downloadUrl": "https://apple.app.store/967093455", "identifier": "967093455" }, { "@type": "SoftwareApplication", "operatingSystem": "AndroidTV", "downloadUrl": "https://google.play.store/com.abc.media.atv.android", "installUrl": "https://abcmedia.com/path_to_apkfile.apk", "identifier": "com.abc.media.atv.android" }, { "@type": "SoftwareApplication", "operatingSystem": "Cast", "identifier": "ACDA4FDE" } ], "subscriptions": [ { "@type": "MediaSubscription", "name": "Basic Package", "@id": "[partner determined string]", "identifier": "abcmedia.com:basic" }, { "@type": "MediaSubscription", "name": "Premium Package", "@id": "[partner determined string]", "identifier": "abcmedia.com:premium" } ], "baseSubscriptionTier": { "@type": "MediaSubscription", "name": "Basic Package", "@id": "[partner determined string]", "identifier": "abcmedia.com:basic" }, "parentOrganization": { "@type": "Organization", "name": "ABC Media" } } ] }