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

W tej sekcji znajdziesz szczegółowe informacje o właściwościach znaczników treści w przypadku typu encji MediaService, która rejestruje konfigurację integracji z Media Action.

Tabela specyfikacji

Właściwość Oczekiwany typ Opis
@type tekstowy.

Wymagane – zawsze ma wartość MediaService.

@context tekstowy.

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

@id Adres URL

Wymagany – unikalny identyfikator marki, np. https://example.com.

Identyfikator musi spełniać te wymagania:

  • Jest on unikalny globalnie w Twoim katalogu.
  • Jest statyczny. Ten identyfikator musi być stały i nie może zmieniać się w czasie.
  • Jest on zapisany w formacie ujednoliconego identyfikatora zasobów (URI).
  • Domena musi należeć do Twojej organizacji.
name tekstowy.

Wymagane – nazwa dostawcy.

Jeśli Twoja marka ma nazwy w określonych językach, wypisz je w tablicy. Przykład znajdziesz w przykładzie MediaService.

brandIcon ImageObject

Wymagany dla wszystkich działań odtwarzania i słuchania – plik obrazu ikony Twojej marki, powtarzany dla każdego rozmiaru. W wynikach działania odtwarzania/odtwarzania Google wiąże precyzyjne linki do Twoich treści z ikoną Twojej marki.

Plik graficzny z ikoną marki musi spełniać następujące wymagania:

  • Jest to plik PNG.
  • Tło jest przezroczyste.
  • Ma okrągły charakter.
  • Upewnij się, że zdjęcia są antyaliasowane i nie są zniekształcone.

Ta właściwość musi się powtarzać, ponieważ musisz podać 5 obrazów, po jednym dla każdego z tych wymiarów:

  • 16 x 16 pikseli, rozmiar pliku nie większy niż 1 KB
  • 20 x 20 pikseli, rozmiar pliku nie większy niż 1 KB
  • 40 x 40 pikseli, rozmiar pliku nie większy niż 1 KB
  • 44 x 44 piksele, rozmiar pliku nie większy niż 1 KB
  • 112 x 112 pikseli, plik o rozmiarze nieprzekraczającym 3 KB

Dodatkowe wymaganie dotyczące integracji Google TV – obrazy ikony Twojej marki będą wyświetlane u góry przewodnika po programach, w przyciskach odtwarzania i w ustawieniach Google TV. Podaj 3 ikony spełniające te wymagania:

  • 1 kwadratowa ikona w formacie PNG. (rozdzielczość 512 x 512 pikseli, współczynnik proporcji 1:1)
  • Jedna ikona białego logo w formacie pliku PNG. (najwyższa dostępna rozdzielczość, brak preferencji dotyczących formatu obrazu)
  • 1 kolorowa ikona słownego logo w formacie PNG. (najwyższa dostępna rozdzielczość, brak preferencji dotyczących formatu obrazu)

Upewnij się, że zdjęcia są antyaliasowane i nie są zniekształcone.

brandIcon.contentURL Adres URL

Wymagany – adres URL obrazu.

brandIcon.height Number

Wymagany – wysokość obrazu w pikselach.

brandIcon.width Number

Wymagany – szerokość obrazu w pikselach.

brandIcon.additionalProperty PropertyValue

Wymagany – dodatkowa właściwość służąca do opisywania typu obrazu i określania jego przeznaczenia.

brandIcon.additionalProperty.@type tekstowy.

Wymagane – ustaw wartość PropertyValue.

brandIcon.additionalProperty.name tekstowy.

Wymagane – ustaw wartość contentAttributes.

brandIcon.additionalProperty.value tekstowy.

Wymagane – dopasowanie tła.

Ustaw prawidłową wartość co najmniej jednej z tych wartości:

  • forDarkBackground: obraz, zwykle przezroczysta ikona, odpowiedni do używania na ciemnym tle.
  • forLightBackground: obraz, zwykle przezroczysta ikona, odpowiedni do jasnego tła.
application SotfwareApplication.

Wymagany w przypadku aplikacji na iOS, Androida, Cast lub Androida TV – listę aplikacji marki w tych obszarach:

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

Wymagane – zawsze ma wartość SoftwareApplication.

application.operatingSystem tekstowy.

Wymagane – ustaw jedną z tych opcji:

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

Wymagany (w stosownych przypadkach) – w przypadku platform Android, Android TV i iOS musisz określić tę wartość jako link do aplikacji w App Store i Sklepie Play.

W przypadku wszystkich innych platform nie jest to wymagane.

application.installUrl Adres URL

Wymagany, jeśli ma to zastosowanie – jeśli dostawca umożliwia odtwarzanie multimediów za pomocą aplikacji na Androida TV, musisz określić tę wartość jako link do pliku APK na Androida TV.

Jeśli dostawca nie oferuje odtwarzania na Androidzie TV, właściwość nie jest wymagana.

application.identifier

tekstowy.

Wymagany, jeśli ma zastosowanie – w przypadku platform, które odpowiadają jednej z tych wartości, odpowiednio je ustaw. W przeciwnym razie ta właściwość nie jest wymagana:

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

Wymagane – dostawca usług nadrzędnych.

parentOrganization.@type tekstowy.

Wymagane – zawsze ma wartość Organization.

parentOrganization.name tekstowy.

Wymagane – nazwa organizacji.

subscriptions Subskrypcja mediów

Opcjonalnie – lista dostępnych MediaSubscriptions obsługiwanych przez dostawcę zegarka.

baseSubscriptionTier Subskrypcja mediów

Wymagany, jeśli ma to zastosowanie – jeśli dostawca zegarka i dostawca usług mają podstawowy pakiet subskrypcji, musisz ustawić tę instancję na subskrypcję dla treści dostępnych dla wszystkich subskrybentów. W przeciwnym razie ta właściwość nie jest wymagana.

userRequestsFulfilledBy tekstowy.

Opcjonalny – wybierz jedną z tych osób, która spełnia żądania użytkownika:

  • Google: wszystkie żądania są realizowane przez Google. Zasadniczo Google zwraca precyzyjny link z żądaną treścią.
  • Provider: wszystkie żądania są realizowane przez dostawcę treści – dostawcę Cloud. Zasadniczo dostawca zwraca precyzyjny link do żądanej treści lub inicjuje odtwarzanie bezpośrednio na urządzeniu.

Domyślnie ta właściwość ma wartość Google.

mediaOffered tekstowy.

Wymagane – ustaw jedną z tych opcji zgodnie z typami treści w katalogu, które są uwzględnione w pliku danych:

  • ["VoD"] – dostawca uwzględnia w pliku danych tylko treści wideo na żądanie (VoD). Obejmuje to filmy i programy telewizyjne.
  • ["LiveTV"] – dostawca uwzględnia w kanale tylko telewizję na żywo, która obejmuje treści z kanałów i BroadcastEvent.
  • ["VoD", "LiveTV"] – dostawca uwzględnia w pliku danych zarówno treści VoD, jak i telewizję na żywo.
  • ["Music"] – dostawca uwzględnia w pliku danych tylko elementy muzyczne. Obejmuje to treści albumu, wykonawców, utworów i playlist.
  • ["Radio"] – dostawca uwzględnia w kanale tylko elementy Radio.
  • ["Music", "Radio"] – dostawca uwzględnia w kanale muzykę i radio. Dotyczy to treści albumu, wykonawców, utworów, playlisty i stacji radiowej.

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