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

Ta sekcja zawiera szczegółowe informacje na temat właściwości znaczników treści dla Typ encji MediaService rejestrujący konfigurację akcji związanej z multimediami integracja

Tabela specyfikacji

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

Wymagane – zawsze ma wartość MediaService.

@context Tekst

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 unikalny globalnie w całym Twoim katalogu.
  • Statyczna. Ten identyfikator musi być stały i nie może zmieniać się w czasie.
  • Jest ona w formacie Unified Resource Identifier (URI).
  • Domena musi należeć do Twojej organizacji.
name Tekst

Wymagane – nazwa dostawcy.

Jeśli Twoja marka ma nazwy zależne od języka, wymień je w tablicy. Oto przykład: zapoznaj się z przykładem usługi MediaService.

brandIcon ImageObject

Wymagany w przypadku wszystkich działań związanych z oglądaniem i słuchaniem – plik obrazu Twojej marki dla każdego rozmiaru. Z wynikiem oglądania/słuchania Google wiąże precyzyjne linki do ikony Twojej marki.

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

  • Jest to plik PNG.
  • Jego tło jest przezroczyste.
  • Ma okrągły kształt.
  • Upewnij się, że obrazy są poddane wygładzeniu oraz nie mogą być zniekształcone lub pikselizowane.

Tę właściwość trzeba powtórzyć, ponieważ musisz dodać 5 obrazów, po jednym dla każdego następujące wymiary:

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

Dodatkowe wymagania dotyczące integracji z Google TV – te obrazy Twojej marki będzie się wyświetlać na górze Przewodnika po programowaniu, na przyciskach akcji zegarka i w ustawieniach Google TV. Dodaj 3 ikony spełniające te wymagania:

  • Jedna kwadratowa ikona w formacie PNG. (rozdzielczość 512 x 512 pikseli, format obrazu 1:1)
  • Jedna biała ikona znaku słownego w formacie pliku PNG. (najwyższa dostępna rozdzielczość, brak preferencji w formacie obrazu)
  • Jedna kolorowa ikona logo w formacie pliku PNG. (najwyższa dostępna rozdzielczość, brak preferencji w formacie obrazu)

Upewnij się, że obrazy są poddane wygładzeniu oraz nie mają zniekształceń/pikseli.

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

Wymagane – dodatkowa właściwość służąca do opisania typu obrazu i określa, zamierzonych zastosowaniach.

brandIcon.additionalProperty.@type Tekst

Wymagane – ustaw na PropertyValue.

brandIcon.additionalProperty.name Tekst

Wymagane – ustaw na contentAttributes.

brandIcon.additionalProperty.value Tekst

Wymagane – dopasowanie w tle.

Aby był prawidłowy, ustaw co najmniej jedną z tych wartości:

  • forDarkBackground: obraz, zwykle przezroczysta ikona, Do użytku na ciemnym tle.
  • forLightBackground: obraz, zwykle przezroczysta ikona, Do użytku na jasnym tle.
application SotfwareApplication

Wymagany, jeśli dostępne są aplikacje na iOS, Android, Cast lub AndroidTV – lista aplikacji marki w tych usługach:

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

Wymagane – zawsze ma wartość SoftwareApplication.

application.operatingSystem Tekst

Wymagane – ustaw jedną z tych wartości:

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

Wymagany (w stosownych przypadkach) – w przypadku platform Android, Android TV lub iOS obowiązujący podaj go jako link do swojej aplikacji w App Store i Sklepie Play.

W przypadku wszystkich innych platform nie jest to wymagana właściwość.

application.installUrl Adres URL

Wymagane, jeśli dotyczy – jeśli dostawca oferuje odtwarzanie multimediów za pomocą W aplikacji AndroidTV musisz podać ten link jako link do pliku APK AndroidaTV.

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

application.identifier

Tekst

Wymagany, jeśli dotyczy – w przypadku platform odpowiadających jednej z tych kategorii: należy ustawić odpowiednie wartości. W innych przypadkach ta właściwość nie jest wymagana:

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

Wymagane – nadrzędny dostawca usługi.

parentOrganization.@type Tekst

Wymagane – zawsze ma wartość Organization.

parentOrganization.name Tekst

Wymagane – nazwa organizacji.

subscriptions MediaSubscription

Opcjonalny – lista dostępnych MediaSubscriptions przez dostawcę zegarka.

baseSubscriptionTier MediaSubscription

Wymagany, jeśli dotyczy – jeśli dostawca zegarków i dostawca mają pakietu subskrypcji, musisz ustawić tę opcję na instancję subskrypcji dla dostępnych treści do wszystkich subskrybentów. W innych przypadkach ta właściwość nie jest wymagana.

userRequestsFulfilledBy Tekst

Opcjonalny – ustaw jedną z tych firm, które realizują użytkownik żądania:

  • Google: wszystkie prośby są rozpatrywane przez Google. Zasadniczo Google zwraca precyzyjny link dla żądanej treści.
  • Provider: wszystkie prośby są realizowane przez dostawcę treści, Cloud Provider. Zasadniczo dostawca zwraca precyzyjny link do żądanej treści. lub rozpoczyna odtwarzanie bezpośrednio na urządzeniu.

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

mediaOffered Tekst

Wymagane – ustaw jedną z poniższych wartości, które odpowiadają typom treści w w katalogu uwzględnionych w pliku danych:

  • ["VoD"] – dostawca umieszcza tylko treści wideo na żądanie (VoD) w kanału. Treści VoD obejmują Filmy oraz Programy telewizyjne.
  • ["LiveTV"] – dostawca obejmuje tylko telewizję na żywo, w tym: Kanały oraz BroadcastEvent treści w kanale.
  • ["VoD", "LiveTV"] – dostawca uwzględni treści VoD i TV na żywo w kanału.
  • ["Music"] – dostawca umieszcza w kanale tylko elementy muzyczne. Ten zawiera Album, wykonawcy, utwory i Playlista treści.
  • ["Radio"] – dostawca umieszcza w kanale tylko elementy Radio.
  • ["Music", "Radio"] – dostawca umieszcza w kanale treści muzyczne i radiowe. Ten zawiera Album, wykonawcy, utwory, Playlista, i stacja radiowa treści.

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