Thuộc tính đánh dấu nội dung của MediaService (Bắt buộc)

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 MediaService.

@context Văn bản

Bắt buộc – Luôn đặt thành ["http://schema.org", {"@language": "xx"}].

@id URL

Bắt buộc – Giá trị nhận dạng duy nhất của thương hiệu; ví dụ: https://example.com.

Giá trị nhận dạng này phải tuân thủ các yêu cầu sau:

  • Đây là sản phẩm duy nhất trong danh mục của bạn trên toàn cầu.
  • Không gian tĩnh. Giá trị này cũng phải ổn định và không thay đổi theo thời gian.
  • Tệp ở định dạng Giá trị nhận dạng tài nguyên hợp nhất (URI).
  • Miền của ứng dụng phải thuộc sở hữu của tổ chức của bạn.
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:

  • Đó là tệp PNG.
  • Nền trong suốt.
  • Hình dạng của nó có hình tròn.
  • Đảm bảo hình ảnh được khử răng cưa và không bị méo/có hiệu ứng pixel

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:

  • 16x16 pixel, với tệp không lớn hơn 1 KB
  • 20x20 pixel, với tệp không quá 1 KB
  • 40x40 pixel, với tệp không lớn hơn 1 KB
  • 44x44 pixel, với tệp không lớn hơn 1 KB
  • 112x112 pixel, với tệp không lớn hơn 3 KB

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:

  • Một biểu tượng hình vuông ở định dạng tệp PNG. (độ phân giải 512x512 px, tỷ lệ khung hình 1:1)
  • Một biểu tượng nhãn từ màu trắng ở định dạng tệp PNG. (độ phân giải cao nhất hiện có, không có lựa chọn ưu tiên cho tỷ lệ khung hình)
  • Một biểu tượng nhãn hiệu dạng chữ có màu ở định dạng tệp PNG. (độ phân giải cao nhất hiện có, không có lựa chọn ưu tiên cho tỷ lệ khung hình)

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 PropertyValue.

brandIcon.additionalProperty.name Văn bản

Bắt buộc – Đặt thành contentAttributes.

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:

  • forDarkBackground: Một hình ảnh (thường là biểu tượng trong suốt) phù hợp để sử dụng trên nền tối.
  • forLightBackground: Một hình ảnh (thường là biểu tượng trong suốt) phù hợp để sử dụng trên nền sáng.
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:

  • iOS
  • Android
  • Truyền
  • AndroidTV
application.@type Văn bản

Bắt buộc – Luôn đặt thành SoftwareApplication.

application.operatingSystem Văn bản

Bắt buộc – Đặt thành một trong các giá trị sau:

  • iOS
  • Android
  • Cast
  • AndroidTV
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

Văn bản

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:

  • iOS: Giá trị nhận dạng ứng dụng trong App Store. Ví dụ: 967093455.
  • Android::Tên gói Android trên Cửa hàng Play. Ví dụ: com.abc.media.android.
  • Truyền: Mã ứng dụng Truyền. Ví dụ: ACDA4FDE.
  • AndroidTV: Tên gói Android TV trên Cửa hàng Play. Ví dụ: com.abc.media.atv.android.
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 Organization.

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 MediaSubscriptions hiện có được nhà cung cấp đồng hồ hỗ trợ.

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:

  • Google: Google sẽ thực hiện tất cả các yêu cầu. Về cơ bản, Google sẽ trả về đường liên kết sâu đến nội dung được yêu cầu.
  • Provider: Tất cả các yêu cầu đều được nhà cung cấp nội dung thực hiện – Nhà cung cấp dịch vụ đám mây. Về cơ bản, trình cung cấp trả về đường liên kết sâu cho nội dung được yêu cầu hoặc bắt đầu phát trực tiếp trên thiết bị của họ.

Theo mặc định, thuộc tính này được đặt thành Google.

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:

  • ["VoD"] – Nhà cung cấp chỉ thêm nội dung Video theo yêu cầu (VoD) trong nguồn cấp dữ liệu. Nội dung VoD bao gồm Phim ảnhChương trình truyền hình.
  • ["LiveTV"] – Nhà cung cấp chỉ bao gồm Truyền hình trực tuyến, bao gồm KênhBroadcastEvent trong nguồn cấp dữ liệu.
  • ["VoD", "LiveTV"] – Nhà cung cấp bao gồm cả nội dung VoD và Truyền hình trực tuyến bằng nguồn cấp dữ liệu.
  • ["Music"] – Nhà cung cấp chỉ thêm các thực thể âm nhạc vào nguồn cấp dữ liệu. Chiến dịch này bao gồm Đĩa nhạc, nghệ sĩ, bài hátDanh sách phát nội dung.
  • ["Radio"] – Nhà cung cấp chỉ bao gồm các thực thể Radio trong nguồn cấp dữ liệu.
  • ["Music", "Radio"] – Nhà cung cấp bao gồm các thực thể âm nhạc và đài trong nguồn cấp dữ liệu. Chiến dịch này bao gồm Đĩa nhạc, nghệ sĩ, bài hát, Danh sách phát, và Đài phát thanh nội dung.

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"
      }
    }
  ]
}