Oglądaj działania wspólne właściwości

Ta sekcja zawiera szczegółowe informacje o wspólnych właściwościach działań związanych z oglądaniem.

Właściwości znaczników działań

Właściwość Oczekiwany typ Opis
@type Text Wymagany – zawsze ma wartość WatchAction.
target EntryPoint Wymagany – obiekt docelowy, który zapewnia mapowanie głębokich linków do różnych platform Google.
target.@type Text Wymagany – zawsze ma wartość EntryPoint.
target.urlTemplate Adres URL Wymagane – precyzyjny link, który przekierowuje użytkowników do aplikacji lub platformy i inicjuje odtwarzanie treści.
target.inLanguage Text Opcjonalnie – oryginalny język serii w formacie BCP 47.
target.actionPlatform Text Wymagany – platformy zmapowane na urlTemplate. Media Actions obsługują te funkcje:
  • http://schema.org/DesktopWebPlatform: platforma wyszukiwania w przeglądarkach internetowych na komputerach.
  • http://schema.org/MobileWebPlatform: platforma wyszukiwania w przeglądarkach mobilnych.
  • http://schema.org/AndroidPlatform: wyszukiwarka i platformy PlayGuide w aplikacji na Androida.
  • http://schema.org/AndroidTVPlatform: platforma Android TV w aplikacji Android TV.
  • http://schema.org/IOSPlatform: platforma wyszukiwania w aplikacji na iOS.
  • http://schema.googleapis.com/GoogleVideoCast: przesyłanie i platformy Home na urządzeniu Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: przesyłanie i platformy domowe na urządzeniu Chromecast (tylko działania związane z słuchaniem).
Zapoznaj się z wymaganiami w sekcji Typy platform.
target.additionalProperty PropertyValue Wymagany w odpowiednich przypadkach – lista par właściwości i wartości, która reprezentuje dodatkowe właściwości linku bezpośredniego. Może to obejmować:
  • contentLanguage: język transmisji (dubbing) w formacie BCP 47. Jeśli treści są zdublowane w innym języku, ta właściwość jest wymagana. Użyj tablicy, aby podać wiele kodów języków.
  • subtitleLanguage: języki napisów w formacie BCP 47. Użyj tablicy, aby podać wiele kodów języków.
  • cameraAngle: kąt ustawienia kamery w przypadku treści, na przykład „Z poziomu oczu” lub „Z góry”. Jeśli treści są dostępne w różnych kątach kamery, ta właściwość jest wymagana. Użyj tablicy, aby przesłać wiele kątów kamery.
  • videoFormat: format pliku używany do przechowywania cyfrowych danych wideo, na przykład „SD” dla standardowej rozdzielczości i „HD” dla wysokiej rozdzielczości. Dozwolone formaty wideo to SD, HD, 2K, 4K i 8K. Użyj tablicy do wielu formatów wideo.
Zobacz przykład additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Wymagany – obiekt specyfikacji dostępu, który opisuje wymagania dotyczące dostępu do treści. Zobacz Właściwości specyfikacji dostępu.

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami:

Właściwości specyfikacji dostępu do działania

Właściwość Oczekiwany typ Opis
actionAccessibilityRequirement.@type Text Wymagany – zawsze ma wartość ActionAccessSpecification.
actionAccessibilityRequirement.category Text

Wymagany – wymagany dostęp do treści. Więcej informacji znajdziesz w artykule Typ paywalla.

Jeśli dana entuzjast reprezentujący reprezentuje grupę treści, musisz ustawić wartość parametru category na najmniej restrykcyjne wymagania dotyczące dostępu do treści. Jeśli na przykład TVSeries ma niektóre treści TVEpisode ustawione jako nologinrequired, a kilka innych jako subscription, ustaw tę wartość TVSeries na nologinrequired.
actionAccessibilityRequirement.availabilityStarts Data

Wymagany – data, po której działanie będzie dostępne, w formacie ISO 8601 (wraz ze strefą czasową).

  • Data może przypadać w przyszłości.

Odpowiednie elementy muszą zostać podane w pliku danych co najmniej 7 dni przed datą rozpoczęcia dostępności. Zwiększy to szanse na to, że treści pojawią się w Google na czas.

actionAccessibilityRequirement.availabilityEnds Data Wymagany – data, po której działanie nie będzie już dostępne, podana w formacie ISO 8601 (wraz ze strefą czasową).
  • Musi być równa lub większa niż 72 godziny po availabilityStarts.
  • Jeśli treści będą zawsze dostępne po opublikowaniu, ustaw tę datę na 20 lat od bieżącej daty.

Wszelkie zmiany daty availabilityEnds należy wprowadzić w pliku danych co najmniej 7 dni przed datą availabilityEnds. Dzięki temu zwiększysz szanse na to, że treści przestaną się wyświetlać w usługach Google w dacie podanej w polu dataZakończeniaDostępności.

actionAccessibilityRequirement.eligibleRegion Country, City, State, GeoShape lub Text Wymagane – regiony, w których treści są dostępne. Jeśli treści są dostępne na całym świecie, użyj ciągu znaków EARTH.
actionAccessibilityRequirement.ineligibleRegion Country, City, State lub GeoShape Wymagane w odpowiednich przypadkach – regiony, w których treści są ograniczone. Nie musisz podawać tej właściwości, jeśli treści są dostępne w eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Wymagany w odpowiednich przypadkach – szczegóły subskrypcji, której użytkownicy potrzebują, aby uzyskać dostęp do treści. Zobacz właściwości subskrypcji mediów.

  • Podaj tę właściwość, jeśli category ma wartość subscription lub externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Offer Wymagany, jeśli treści wymagają zakupu – szczegóły oferty związanej z treściami. Podaj informacje o cenie w tych przypadkach:
  • Treści kupowane jednorazowo (rental lub purchase)
  • treści dostępne w ramach subskrypcji, które wymagają dodatkowego zakupu przez subskrybentów (subscription lub externalsubscription);
Jeśli cena wynosi 0,00, całkowicie usuń obiekt Offer i ustaw wartość category w obiekcie ActionAccessSpecification na free. Zobacz Właściwości oferty.

Właściwości subskrypcji multimediów

Wymagane, jeśli actionAccessibilityRequirement.category to subscription lub externalSubscription.

Właściwość Oczekiwany typ Opis
requiresSubscription.@type Text Wymagany – zawsze ma wartość MediaSubscription.
requiresSubscription.@id Adres URL Wymagany – unikalny identyfikator subskrypcji. Jeśli treści są dostępne w ramach różnych subskrypcji, każda subskrypcja musi mieć unikalny identyfikator.
requiresSubscription.name Text Wymagany – nazwa subskrypcji. Uwaga:
  • Jeśli treści są dostępne w ramach różnych abonamentów, ta nazwa musi być zgodna z nazwą w Twoim systemie uwierzytelniania użytkowników. Jeśli na przykład użytkownik może uzyskać dostęp do treści na podstawie subskrypcji o nazwie Pakiet 1, ale system uwierzytelniania używa nazwy PKG1a, użyj nazwy PKG1.
  • W przypadku dostawców usług uwierzytelniania na podstawie tożsamości jest to nazwa uwierzytelniania zarejestrowana w urządzeniu uwierzytelniającym na podstawie tożsamości. Jest to ciąg tekstowy, który jednoznacznie identyfikuje nazwę usługi w usługach Authenticatora TVE.
requiresSubscription.sameAs Adres URL Strona z opisem subskrypcji.
requiresSubscription.identifier Text Wymagany, jeśli category to subscription, a commonTier to false – unikalny ciąg znaków dla tego abonamentu, który reprezentuje dostęp do grupy treści w katalogu multimediów.
  • Google zaleca używanie w przypadku identyfikatorów tej składni:
    nazwa domeny + dwukropka (:) + poziom dostępu do treści. Przykłady : example.com:basic, example.com:premium, example.com:sports
  • Ta właściwość będzie taka sama jak identyfikator uprawnień, jeśli udostępniasz interfejs API uprawnień.
requiresSubscription.authenticator Organizacja Wymagany, jeśli category jest ustawiony naexternalsubscription – kontener zawierający informacje o uwierzytelnianiu dostawcy zewnętrznego.
requiresSubscription.authenticator.@type Text Wymagany, jeśli category to externalsubscription – zawsze ustawiany na Organization.
requiresSubscription.authenticator.name Text Wymagany, jeśli category to:externalsubscription – nazwa usługi uwierzytelniania. W przypadku dostawców TVE ustaw tę wartość na TVE.
requiresSubscription.commonTier Wartość logiczna Wymagany, jeśli ma zastosowanie – ten atrybut jest wymagany, jeśli kategoria ma wartość subscription. Więcej informacji o commonTier znajdziesz w dokumentacji o wymaganiach dotyczących wspólnego poziomu.

Wymagania dotyczące interfejsu Entitlements API

Interfejs API uprawnień jest wymagany, jeśli actionAccessibilityRequirement.category to subscription lub externalSubscription, a Twoja oferta subskrypcji obejmuje kilka pakietów lub poziomów lub obsługuje dodatki. Nie podawaj tej informacji, jeśli Twoja subskrypcja jest jednopoziomowa i daje dostęp do wszystkich treści w katalogu.

  • Firma A oferuje jedną subskrypcję, która zapewnia subskrybentom dostęp do wszystkich dostępnych treści: identyfikator uprawnień / interfejs API nie jest wymagany
  • Firma B ma subskrypcję podstawową, która zapewnia dostęp do niektórych treści, oraz subskrypcję premium, która zapewnia dostęp do treści premium:Entitlement Identifier / API jest wymagany
  • Firma C ma abonament podstawowy, który zapewnia dostęp do niektórych treści, oraz pakiety dodatkowe, które zapewniają dostęp do treści innych firm: wymagany jest identyfikator uprawnień lub interfejs API.

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami:

Właściwości oferty

Właściwość Oczekiwany typ Opis
expectsAcceptanceOf.@type Text Wymagany – zawsze ma wartość Offer.
expectsAcceptanceOf.price Number Wymagany – cena zakupu treści. Cena musi być niezerową liczbą dodatnią. W przypadku elementów o cenie 0, 00 podaj kategorię „bezpłatne”.
expectsAcceptanceOf.priceCurrency Text Wymagany: waluta, w której podano cenę, przedstawiona w trzyliterowym formacie ISO 4217.
expectsAcceptanceOf.seller Organizacja Organizacja, która oferuje zakup treści.
expectsAcceptanceOf.seller.@type Text Zawsze ustawiona na Organization.
expectsAcceptanceOf.seller.name Text nazwę sprzedawcy;
expectsAcceptanceOf.seller.sameAs Text Adres URL strony internetowej, która identyfikuje sprzedawcę, na przykład jego stronę główną.

Strona powiązana z ofertą

Aby dowiedzieć się więcej o tych usługach, zapoznaj się z tymi stronami:

Identyfikatory

Pliki danych z działaniami dotyczącymi multimediów obsługują różne identyfikatory, które mogą pomóc w jednoznacznym zidentyfikowaniu danego podmiotu. Te identyfikatory mogą przyspieszyć proces porównywania treści z Twojego pliku danych z treściami z baz danych Google. Większość z tych identyfikatorów można dodać do pliku danych za pomocą właściwości identifier w przypadku różnych typów elementów, ale identyfikatory EIDR mają swoją własną reprezentującą je właściwość. Obydwa te tematy omawiamy poniżej.

Właściwości identyfikatora

Właściwość Oczekiwany typ Opis
identifier Text Wysoce zalecane – identyfikator, zwykle zewnętrzny, jednoznacznie identyfikujący dany element. Dozwolone są liczne identyfikatory.

Ta właściwość jest dostępna w przypadku wszystkich typów elementów akcji związanych z oglądaniem.

W tabeli poniżej znajdziesz listę akceptowanych identyfikatorów i podelementów właściwości identifier. Przykład identyfikatora/EIDR znajdziesz w sekcji Przykłady kanałów działań dotyczących oglądania.
Właściwość Oczekiwany typ Opis
@type Text Wymagany – zawsze ma wartość PropertyValue.
propertyID Text Wymagany – obsługujemy te typy dokumentów tożsamości:
  • TMS_ROOT_ID: identyfikator główny Gracenote (TMS) (np. 15829).
    • Nie dotyczy to organizacji ani encji BroadcastService, w których przypadku należy używać tylko identyfikatora TMS_ID.
  • TMS_ID: identyfikator wariantu Gracenote (TMS) (np. MV000398520000).
  • WIKIDATA_ID: identyfikator Wikidata (np. Q134773).
  • IMDB_ID: identyfikator IMDB (np. tt0109830).
  • OPTA_ID: identyfikator OPTA Sports.
  • STATS_ID: identyfikator STATS Perform.
  • VIP_TIMES_ID: japoński identyfikator VIPTimes (Nihon Tarento Meikan) dla japońskich talentów.
  • DMA_ID: kod obszaru marketingowego w Stanach Zjednoczonych, używany w obiekcie GeoShape.
  • _PARTNER_ID_: ta właściwość musi zawierać ciąg „_PARTNER_ID_”, a wartość musi być unikalnym identyfikatorem używanym przez dostawcę usług wewnętrznie lub zewnętrznie do identyfikowania podmiotu (np. 12345 lub a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Text Wymagany – wartość dla określonego systemu identyfikatorów.

Właściwości EIDR

EIDR (skrót od Entertainment Identifier Registry) to system globalnych unikalnych identyfikatorów dla szerokiej gamy treści multimedialnych, w tym filmów i programów telewizyjnych. System identyfikacji przekształca identyfikator w rekord metadanych powiązany z tytułami najwyższego poziomu, zmianami i innymi elementami. W tabeli poniżej wymieniono właściwości powiązane z EIDR i ich zastosowanie.

Właściwość Oczekiwany typ Opis
titleEIDR Text Wysoko zalecane – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje na najbardziej ogólnym/abstrakcyjnym poziomie film lub program telewizyjny.

Ta właściwość jest dostępna na stronach specyfikacji encji TVSeries, TVSeason, TVEpisode i Movie.

Na przykład identyfikator EIDR filmu „Ghostbusters” to „10.5240/7EC7-228A-510A-053E-CBB8-J”.

Zobacz przykład identyfikatora/EIDR w sekcji przykładów plików danych Watch Actions.
editEIDR Text Zalecane – identyfikator EIDR (Entertainment Identifier Registry) odpowiada konkretnej wersji filmu lub programu telewizyjnego.

Ta właściwość jest dostępna na stronach ze specyfikacją encji TVEpisode i Movie.

Na przykład film pt. „Ghostbusters” o identyfikatorze EIDR 10.5240/7EC7-228A-510A-053E-CBB8-J ma kilka wersji, np. 10.5240/1F2A-E1C5-680A-14C6-E76B-I i 10.5240/8A35-3BEE-6497-5D12-9E4F-3.

titleEIDR Właściwość jest wymagana, gdy podano wartość editEIDR.

Zobacz przykład identyfikatora/EIDR w sekcji przykładów w pliku danych Watch Actions.

Agenci oceny treści

Użyj wartości w tej tabeli dla parametrów BroadcastService.contentRating, Movie.contentRating i TVSeries.contentRating. Do wartości oceny należy dodać nazwę agencji, która ją przyznała. Przykłady:

  • Film oceniony jako „R” w Stanach Zjednoczonych powinien mieć wartość Movie.contentRating „MPAA R”.
  • Serial telewizyjny z oceną „TV-MA” w Stanach Zjednoczonych powinien mieć wartość TVSeries.contentRating „TV_PG TV-MA”.

Kraj Agencja oceniająca programy telewizyjne Agencja oceniająca filmy
Albania (AL) Niedostępne Niedostępne
Angola (AO) Niedostępne CCE
Antigua i Barbuda (AG) Niedostępne MPAA
Argentyna (AR) INCAA INCAA
Armenia (AM) Niedostępne MKRF/ROSJA
Aruba (AW) Niedostępne Niedostępne
Australia (AU) ACB TV ACB Movies
Austria (AT) FSK FSK
Azerbejdżan (AZ) Niedostępne MKRF/ROSJA
Bahrajn (BH) Niedostępne MPAA
Białoruś (BY) Niedostępne MKRF/ROSJA
Belgia (BE) Niedostępne MPAA
Belize (BZ) Niedostępne Niedostępne
Benin (BJ) Niedostępne CNC
Boliwia (BO) Niedostępne MPAA
Bośnia i Hercegowina (BA) Niedostępne MPAA
Botswana (BW) Niedostępne MPAA
Brazylia (BR) CLASSIND CLASSIND
Burkina Faso (BF) Niedostępne CNC
Kambodża (KH) Niedostępne Niedostępne
Kanada (CA) CA_TV CHVRS
Republika Zielonego Przylądka (CV) Niedostępne CCE
Chile (CL) Niedostępne MPAA
Kolumbia (CO) Niedostępne MPAA
Kostaryka (CR) Niedostępne MPAA
Chorwacja (HR) Niedostępne Niedostępne
Cypr (CY) Niedostępne GRFILM
Czechy (CZ) Niedostępne CZFILM
Dania (DK) Niedostępne MCCYP
Ekwador (EC) Niedostępne MPAA
Egipt (EG) Niedostępne MPAA
Salwador (SV) Niedostępne MPAA
Estonia (EE) Niedostępne EEFILM
Fidżi (FJ) Niedostępne Niedostępne
Finlandia (FI) Niedostępne MEKU
Francja (FR) CSA CSA
Gabon (GA) Niedostępne CNC
Niemcy (DE) FSK FSK
Grecja (GR) ESR GRFILM
Gwatemala (GT) Niedostępne MPAA
Haiti (HT) Niedostępne Niedostępne
Honduras (HN) Niedostępne MPAA
Hongkong (HK) CA FCO
Węgry (HU) Niedostępne MPAA
Islandia (IS) Niedostępne KIJKWIJZER
Indie (IN) CBFC CBFC
Indonezja (ID) KPI LSF
Irlandia (IE) Niedostępne IFCO
Włochy (IT) AGCOM AGCOM
Wybrzeże Kości Słoniowej (CI) Niedostępne CNC
Jamajka (JM) Niedostępne MPAA
Japonia (JP) Nie dotyczy EIRIN
Jordania (JO) Niedostępne MPAA
Kazachstan (KZ) Niedostępne MRKF
Korea (KR) KMRB KMRB
Kuwejt (KW) Niedostępne MPAA
Kirgistan (KG) Niedostępne MKRF/ROSJA
Laos (LA) Niedostępne Niedostępne
Łotwa (LV) Niedostępne NKCLV
Liban (LB) Niedostępne MPAA
Litwa (LT) Niedostępne Niedostępne
Luksemburg (LU) Niedostępne KIJKWIJZER
Macedonia (MK) Niedostępne MPAA
Malezja (MY) Niedostępne FCBM
Mali (ML) Niedostępne CNC
Malta (MT) Niedostępne MCCAA
Mauritius (MU) Niedostępne BBFC
Meksyk (MX) RTC RTC
Mołdawia (MD) Niedostępne Niedostępne
Namibia (NA) Niedostępne Niedostępne
Nepal (NP) Niedostępne MPAA
Holandia (NL) KIJKWIJZER KIJKWIJZER
Nowa Zelandia (NZ) BSA OFLC
Nikaragua (NI) Niedostępne MPAA
Niger (NE) Niedostępne CNC
Norwegia (NO) Niedostępne MEDIETILSYNET
Oman (OM) Niedostępne MPAA
Panama (PA) Niedostępne MPAA
Papua-Nowa Gwinea (PG) Niedostępne MPAA
Paragwaj (PY) Niedostępne MPAA
Peru (PE) Niedostępne MPAA
Filipiny (PH) MTRCB MTRCB
Polska (PL) Niedostępne MPAA
Portugalia (PT) Niedostępne CCE
Katar (QA) Niedostępne MPAA
Rosja (RU) MKRF/ROSJA MKRF/ROSJA
Rwanda (RW) Niedostępne CNC
Arabia Saudyjska (AS) Niedostępne MPAA
Senegal (SN) Niedostępne MPAA
Singapur (SG) Niedostępne MDA
Słowacja (SK) Niedostępne MPAA
Słowenia (SI) Niedostępne MPAA
Republika Południowej Afryki (ZA) FPB FPB
Hiszpania (ES) SETSI ICAA
Sri Lanka (LK) Niedostępne Niedostępne
Szwecja (SE) Niedostępne SMSA
Szwajcaria (CH) FSK FSK
Tajwan (TW) Niedostępne MOCTW
Tadżykistan (TJ) Niedostępne MKRF/ROSJA
Tanzania (TZ) Niedostępne MPAA
Tajlandia (TH) Niedostępne BFVC
Togo (TG) Niedostępne CNC
Trynidad i Tobago (TT) Niedostępne Niedostępne
Turcja (TR) RTÜK ECBMCT
Turkmenistan (TM) Niedostępne MKRF/ROSJA
Uganda (UG) Niedostępne MPAA
Ukraina (UA) Niedostępne Niedostępne
Zjednoczone Emiraty Arabskie (ZEA) Niedostępne MPAA
Wielka Brytania (GB) BBFC BBFC
Stany Zjednoczone TV_PG MPAA
Urugwaj (UY) Niedostępne MPAA
Uzbekistan (UZ) Niedostępne MKRF/ROSJA
Wenezuela (VE) Niedostępne RESORTEVIOLENCIA
Wietnam (VN) Niedostępne MCST
Zambia (ZM) Niedostępne MPAA
Zimbabwe (ZW) Niedostępne MPAA

Właściwości obiektu GeoShape

Obiekt GeoShape zawiera jeden z tych typów danych:

Właściwość Oczekiwany typ Opis
@id Adres URL Wymagany – identyfikator regionu geograficznego w formacie URI.
@type Text Wymagany – zawsze ma wartość GeoShape.
addressCountry Text Wymagany: dwuliterowy kod kraju w formacie ISO 3166-1 alfa-2.
postalCode Text Opcjonalnie – lista co najmniej 1 kodu pocztowego lub kodu FSA (strefa sortowania przesyłek).
identifier PropertyValue Opcjonalnie – identyfikator rynku docelowego (DMA), czyli identyfikator regionu w Stanach Zjednoczonych, w którym ludzie odbierają te same kanały telewizyjne i programy.
identifier.@type Text Wymagany – zawsze ma wartość PropertyValue.
identifier.propertyID Text Wymagany – zawsze ma wartość DMA_ID.
identifier.value Text Wymagany – kod DMA regionu.

Przykład obiektu GeoShape zawierającego listę kodów pocztowych:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area1",
  "addressCountry": "US",
  "postalCode": [
    "94118",
    "94119"
  ]
}

Przykład obiektu GeoShape zawierającego kombinację FSA (strefa sortowania przesyłek) i kodów pocztowych:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area2",
  "addressCountry": "CA",
  "postalCode": [
    "1A1",
    "K1A",
    "K1AOB1"
  ]
}

Przykład obiektu GeoShape zawierającego identyfikator DMA:

{
  "@type": "GeoShape",
  "@id": "http://example.com/area3",
  "addressCountry": "US",
  "identifier": [
    {
      "@type": "PropertyValue",
      "propertyID": "DMA_ID",
      "value": "501"
    }
  ]
}