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 nắm bắt cấu hình để tích hợp Hành động với nội dung đa phương tiện.
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 cho thương hiệu của bạn; ví dụ: Giá trị nhận dạng 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 riêng của khu vực, hãy liệt kê trong một mảng. Để tham khảo ví dụ về nội dung này, hãy tham khảo ví dụ về MediaService. |
brandIcon
|
ImageObject |
Bắt buộc đối với tất cả Hành động xem và Hành động nghe – Tệp hình ảnh của biểu tượng thương hiệu, lặp lại, cho từng kích thước. Trên kết quả Hành động xem/Nghe, Google sẽ liên kết các đườ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:
Bạn phải sử dụng lại thuộc tính này bởi vì bạn phải cung cấp 5 hình ảnh, mỗi hình ảnh cho một các kích thước sau:
Yêu cầu bổ sung để tích hợp GoogleTV – Những hình ảnh về biểu tượng thương hiệu của bạn sẽ hiển thị ở đầu Hướng dẫn lập trình, trên các nút Hành động xem và trong phần cài đặt Google TV. Cung cấp ba biểu tượng đáp ứng các yêu cầu sau:
Đảm bảo hình ảnh được khử bí danh và không bị méo/ảnh. |
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 mục đích sử dụng của hình ảnh. |
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 với nền tảng. Để hợp lệ, hãy đặt thành ít nhất một trong các giá trị sau:
|
application
|
Ứng dụng Sotfware |
Bắt buộc nếu ứng dụng iOS, Android, Cast hoặc AndroidTV được cung cấp - Danh sách các ứng dụng thương hiệu của bạn trong các ứng dụng sau:
|
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 tùy chọn sau:
|
application.downloadUrl
|
URL |
Bắt buộc nếu có – Đối với các nền tảng Android, AndroidTV và iOS, bạn phải chỉ định thuộc tính này làm đường liên kết đến ứng dụng của mình trong App Store và Cửa hàng Play. Đối với tất 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 cho phép phát nội dung nghe nhìn thông qua ứng dụng AndroidTV, thì bạn phải chỉ định nội dung 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 lại AndroidTV thì đây không phải là thuộc tính 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 giá trị sau, hãy đặt giá trị tương ứng. Ngoài ra, thuộc tính này không bắt buộc:
|
|
parentOrganization
|
Tổ chức |
Bắt buộc – Nhà cung cấp dịch vụ chính. |
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
|
MediaGói thuê bao |
Không bắt buộc – Danh sách các |
baseSubscriptionTier
|
MediaGói thuê bao |
Bắt buộc nếu có – Nếu một nhà cung cấp đồng hồ và nhà cung cấp đó có gói thuê bao cơ sở, thì bạn phải thiết lập gói này thành thực thể của gói thuê bao đối với nội dung được cung cấp cho tất cả người đăng ký. Ngoài ra, thuộc tính này không bắt buộc. |
userRequestsFulfilledBy
|
Văn bản |
Không bắt buộc – Đặt cho một trong hai bên đáp ứng yêu cầu của người dùng sau đây:
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 các loại nội dung trong danh mục của bạn được bao gồm trong 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"
}
}
]
}