Właściwości znaczników treści MediaService (wymagane)

Ta sekcja zawiera szczegółowe informacje o właściwościach znaczników treści dla typu jednostki MediaService, który zawiera konfigurację integracji z działaniem dotyczącym multimediów.

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@type Text

Wymagany – zawsze ma wartość MediaService.
@context Text

Wymagany – zawsze ma wartość ["http://schema.org", {"@language": "xx"}].
@id Adres URL

Wymagany – niepowtarzalny identyfikator Twojej marki, na przykład:https://example.com.

Identyfikator musi spełniać te wymagania:

  • Musi być unikalna w całym katalogu.
  • Jest statyczny. Ten identyfikator musi być stały i nie może zmieniać się w czasie.
  • Ma format identyfikatora Unified Resource Identifier (URI).
  • Domena musi należeć do Twojej organizacji.
name Text

Wymagany – nazwa dostawcy.

Jeśli Twoja marka ma nazwy specyficzne dla danego regionu, podaj je w tablicy. Przykładem jest MediaService.
brandIcon ImageObject

Wymagany w przypadku wszystkich działań związanych z oglądaniem i słuchaniem – plik obrazu z ikoną Twojej marki, powtórzony dla każdego rozmiaru. W wyniku działania „Oglądaj” lub „Słuchaj” Google łączy precyzyjne linki do treści z ikoną Twojej marki.

Plik z ikoną marki musi spełniać te wymagania:

  • Jest to plik PNG.
  • Tło jest przezroczyste.
  • Ma okrągły kształt.
  • Upewnij się, że obrazy są wygładzone i nie są zniekształcone ani nie mają ziarnistej struktury.

Ta właściwość musi być powtarzana, ponieważ musisz przesłać 5 obrazów: po jednym dla każdego z tych wymiarów:

  • 16 x 16 pikseli, plik nie może zajmować więcej niż 1 KB
  • 20 x 20 pikseli, plik nie może zajmować więcej niż 1 KB
  • 40 x 40 pikseli, plik nie może być większy niż 1 KB
  • 44 x 44 piksele, plik nie może być większy niż 1 KB
  • 112 x 112 pikseli, plik nie może zajmować więcej niż 3 KB

Dodatkowy wymóg integracji z Google TV – te obrazy ikony Twojej marki będą wyświetlane u góry przewodnika po programach, na przyciskach akcji oglądania oraz w ustawieniach Google TV. Prześlij 3 ikony spełniające te wymagania:

  • Jedna kwadratowa ikona w formacie pliku PNG. (w rozdzielczości 512 x 512 pikseli, format obrazu 1:1)
  • Jedna biała ikona logotypu w formacie PNG. (najwyższa dostępna rozdzielczość, bez preferencji dotyczących formatu obrazu)
  • Jedna kolorowa ikona logotypu w formacie pliku PNG. (najwyższa dostępna rozdzielczość, bez preferencji dotyczących formatu obrazu)

Upewnij się, że obrazy są wygładzone i nie są zniekształcone ani nie mają ziarnistej struktury.

brandIcon.contentURL Adres URL

Wymagany – adres URL obrazu.
brandIcon.height Number

Wymagane – wysokość obrazu w pikselach.
brandIcon.width Number

Wymagany – szerokość obrazu w pikselach.
brandIcon.additionalProperty PropertyValue

Wymagany – dodatkowa właściwość używana do opisu typu obrazu i określająca jego przeznaczenie.
brandIcon.additionalProperty.@type Text

Wymagany – ustaw na PropertyValue.
brandIcon.additionalProperty.name Text

Wymagany – ustaw na contentAttributes.
brandIcon.additionalProperty.value Text

Wymagany: odpowiedniość tła.

Aby była prawidłowa, musi mieć co najmniej jedną z tych wartości:

  • forDarkBackground: obraz, zwykle przezroczysta ikona, odpowiedni do użycia na ciemnym tle.
  • forLightBackground: obraz, zwykle przezroczysta ikona, odpowiedni do użycia na jasnym tle.
application SotfwareApplication

Wymagany, jeśli udostępniane są aplikacje na iOS, Androida, Google Cast lub Androida TV – lista aplikacji Twojej marki w tych usługach:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.@type Text

Wymagany – zawsze ma wartość SoftwareApplication.
application.operatingSystem Text

Wymagany – ustaw jedną z tych opcji:

  • iOS
  • Android
  • Cast
  • AndroidTV
application.downloadUrl Adres URL

Wymagany w odpowiednich przypadkach – w przypadku platform Android, AndroidTV i iOS musisz podać ten link jako link do aplikacji w App Store i Sklepie Play.

W przypadku wszystkich innych platform ta właściwość nie jest wymagana.
application.installUrl Adres URL

Wymagane w odpowiednich przypadkach – jeśli dostawca oferuje odtwarzanie multimediów za pomocą aplikacji na Androida TV, musisz podać link do pliku APK Androida TV.

Jeśli dostawca nie oferuje odtwarzania na AndroidTV, ta właściwość nie jest wymagana.
application.identifier

Text

Wymagany w odpowiednich przypadkach – w przypadku platform, które odpowiadają jednej z tych wartości, ustaw odpowiednią wartość. Właściwość ta nie jest wymagana w tych przypadkach:

  • iOS: identyfikator aplikacji w App Store. Na przykład: 967093455.
  • Android: nazwa pakietu na Androida w Sklepie Play. Na przykład:com.abc.media.android.
  • Cast: identyfikator aplikacji Cast. Na przykład: ACDA4FDE.
  • AndroidTV: nazwa pakietu AndroidTV w Sklepie Play. Na przykład:com.abc.media.atv.android.
parentOrganization Organizacja

Wymagane – dostawca nadrzędny usługi.
parentOrganization.@type Text

Wymagany – zawsze ma wartość Organization.
parentOrganization.name Text

Wymagane – nazwa organizacji.
subscriptions MediaSubscription

Opcjonalnie – lista dostępnych MediaSubscriptionsobsługiwanych przez dostawcę zegarka.
baseSubscriptionTier MediaSubscription

Wymagany w stosownych przypadkach – jeśli dostawca treści ma podstawowy pakiet subskrypcji, musisz ustawić tę wartość jako instancję subskrypcji dla treści dostępnych dla wszystkich subskrybentów. W przeciwnym razie ta właściwość nie jest wymagana.
userRequestsFulfilledBy Text

Opcjonalnie – ustaw jedną z tych stron, które realizują prośby użytkownika:

  • Google: Google spełnia wszystkie prośby. Google zwraca precyzyjny link do żądanych treści.
  • Provider: wszystkie żądania są realizowane przez dostawcę treści, czyli dostawcę usług w chmurze. W podstawie dostawca zwraca link do żądanych treści lub inicjuje odtwarzanie bezpośrednio na urządzeniu.

Domyślnie ta właściwość jest ustawiona na Google.
mediaOffered Text

Wymagany – ustaw jedną z tych opcji odpowiadającą typom treści w katalogu, które są uwzględnione w pliku danych:

Przykład usługi 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"
      }
    }
  ]
}