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 ustawiony na WatchAction.
target EntryPoint Wymagany – obiekt docelowy, który zawiera mapowanie linków bezpośrednich na różne platformy Google.
target.@type Text Wymagany – zawsze ustawiony na EntryPoint.
target.urlTemplate Adres URL Wymagany – precyzyjny link, który kieruje użytkowników do Twojej aplikacji lub platformy i rozpoczyna odtwarzanie treści.
target.inLanguage Text Opcjonalnie – oryginalny język serialu w formacie BCP 47.
target.actionPlatform Text Wymagane – platformy zmapowane na urlTemplate. Usługa Media Actions obsługuje te funkcje:
  • http://schema.org/DesktopWebPlatform: platforma wyszukiwania w przeglądarkach na komputerach.
  • http://schema.org/MobileWebPlatform: platforma wyszukiwania w mobilnych przeglądarkach internetowych.
  • http://schema.org/AndroidPlatform: wyszukiwanie i platformy Przewodnika po grach w aplikacji na Androida.
  • http://schema.org/AndroidTVPlatform: platforma Android TV w aplikacji Android TV.
  • http://schema.org/IOSPlatform: wyszukiwanie platformy w aplikacji na iOS.
  • http://schema.googleapis.com/GoogleVideoCast: platformy Cast i Home na urządzeniu Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: platformy Cast i Home na urządzeniu Chromecast (tylko działania związane ze słuchaniem).
Wymagania znajdziesz w sekcji Typy platform.
target.additionalProperty PropertyValue Wymagane w odpowiednich przypadkach – lista par właściwość-wartość reprezentujących dodatkowe właściwości linku do konkretnego miejsca w aplikacji. Może to obejmować:
  • contentLanguage: język transmisji (dubbing) w formacie BCP 47. Ta właściwość jest wymagana, jeśli treść jest dubbingowana w innym języku. W przypadku wielu kodów języka użyj tablicy.
  • subtitleLanguage: języki napisów w formacie BCP 47. W przypadku wielu kodów języka użyj tablicy.
  • cameraAngle: kąt kamery, pod jakim nagrano treści, np. „na poziomie oczu” lub „z góry”; Ta właściwość jest wymagana, jeśli treść jest dostępna z różnych perspektyw. Użyj tablicy dla wielu kątów kamery.
  • videoFormat: Format pliku używany do przechowywania danych cyfrowego wideo, np. „SD” w przypadku standardowej rozdzielczości i „HD” w przypadku wysokiej rozdzielczości. Prawidłowe formaty wideo to SD, HD, 2K, 4K i 8K. W przypadku wielu formatów wideo użyj tablicy.
  • audioDescriptionLanguage: tablica obsługiwanych języków audio w formacie BCP 47, które obsługują audiodeskrypcję. Jest to podzbiór tablicy contentLanguage.
Zobacz przykład additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Wymagany – obiekt specyfikacji dostępu do działania, który opisuje wymagania dotyczące dostępu do treści. Zobacz właściwości specyfikacji dostępu do działania.

Tematy związane z tymi usługami znajdziesz na tych stronach:

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

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

Wymagane – wymagania dotyczące dostępu do treści. Więcej informacji znajdziesz w artykule Rodzaj paywalla.

Jeśli encja reprezentuje grupę treści, musisz ustawić category na najmniej restrykcyjne wymaganie dostępu do jej treści. Jeśli na przykład TVSeries ma niektóre treści TVEpisode ustawione na nologinrequired, a kilka na subscription, ustaw ten parametr TVSeries na nologinrequired.
actionAccessibilityRequirement.availabilityStarts Data

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

  • Datę można ustawić w przyszłości.

Odpowiedni element musi być podany w pliku danych co najmniej 7 dni przed datą availabilityStarts. Zwiększy to szanse na to, że treści będą wyświetlane w usługach Google na czas.

actionAccessibilityRequirement.availabilityEnds Data Wymagane – 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 są zawsze dostępne po opublikowaniu, ustaw datę na 20 lat od daty bieżącej.

Wszelkie zmiany daty availabilityEnds w pliku danych muszą być wprowadzane co najmniej 7 dni przed datą availabilityEnds. Zwiększy to szanse, że treści przestaną się wyświetlać w usługach Google w dniu zakończenia dostę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 specjalnego 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 wszędzie w eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Wymagane 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 element category ma wartość subscription lub externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Wymagany, jeśli treści wymagają zakupu – szczegóły oferty powiązanej z treściami. Podaj informacje o cenie w tych przypadkach:
  • Treści kupione 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, usuń cały obiekt Offer i ustaw wartość category z obiektu ActionAccessSpecification na free. Zobacz właściwości oferty.
actionAccessibilityRequirement.additionalProperty PropertyValue Wymagany, jeśli ma zastosowanie – odniesienie do pakietu subskrypcji, który będzie wyświetlany w ramach usługi.
actionAccessibilityRequirement.additionalProperty.name Text Wymagany – zawsze ustawiony na „DisplaySubscriptionIdentifier”
actionAccessibilityRequirement.additionalProperty.value Text Wymagane – requiresSubscription.@id, które będzie wyświetlane w przypadku podmiotu.

Właściwości subskrypcji mediów

Wymagane, jeśli actionAccessibilityRequirement.category ma wartość 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 z nich musi mieć unikalny identyfikator.
requiresSubscription.name Text Wymagany – nazwa subskrypcji. Zwróć uwagę na te kwestie:
  • Jeśli treści są dostępne w ramach różnych subskrypcji, ta nazwa musi być zgodna z nazwą w systemie uwierzytelniania użytkowników. Jeśli na przykład użytkownik ma dostęp do treści w ramach subskrypcji o nazwie Pakiet 1, ale system uwierzytelniania używa nazwy PKG1a, użyj wartości PKG1.
  • W przypadku dostawców TVE jest to nazwa uwierzytelniania zarejestrowana w uwierzytelnianiu TVE. Jest to ciąg znaków, który jednoznacznie identyfikuje nazwę usługi w systemie uwierzytelniania TVE.
  • Jeśli subskrypcja ma wiele nazw, podaj je w postaci tablicy wartości. W tym przykładzie znajdziesz instrukcje dodawania tablicy nazw z wieloma tłumaczeniami.
requiresSubscription.sameAs Adres URL Strona z opisem subskrypcji.
requiresSubscription.identifier Text Wymagany, jeśli category to subscription ORAZ commonTier to false – unikalny ciąg znaków dla tej subskrypcji, który reprezentuje dostęp do grupy treści w katalogu multimediów.
  • Google zaleca używanie w przypadku identyfikatora tej składni:
    nazwa domeny + dwukropek (:) + poziom dostępu do treści, np. example.com:basic, example.com:premium, example.com:sports
  • Jeśli udostępniasz interfejs API uprawnień, ta właściwość będzie taka sama jak identyfikator uprawnienia.
requiresSubscription.authenticator Organizacja Wymagany, jeśli category to externalsubscription – kontener zawierający szczegóły uwierzytelniania zewnętrznego dostawcy.
requiresSubscription.authenticator.@type Text Wymagany, jeśli category to externalsubscription – zawsze ustawiony na Organization.
requiresSubscription.authenticator.name Text Wymagany, jeśli category to externalsubscription – nazwa usługi uwierzytelniania. W przypadku dostawców TVE ustaw wartość TVE.
requiresSubscription.commonTier Wartość logiczna Wymagany, jeśli ma zastosowanie – wymagany, jeśli kategoria ma wartość subskrypcja. Więcej informacji o poziomie common znajdziesz w dokumentacji wymagań dotyczących poziomu common.

Wymagania dotyczące interfejsu Entitlement API

Interfejs API uprawnień jest wymagany, jeśli actionAccessibilityRequirement.category ma wartość subscription lub externalSubscription, a oferta subskrypcji obejmuje wiele pakietów lub poziomów albo obsługuje dodatki. Nie uwzględniaj tego, jeśli Twoja subskrypcja jest jednostopniowa i zapewnia dostęp do wszystkich treści w katalogu.

  • Firma A ma jedną ofertę subskrypcji, która zapewnia subskrybentom dostęp do wszystkich dostępnych treści: identyfikator uprawnienia / 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:Identyfikator uprawnień / 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: Identyfikator uprawnienia / API jest wymagany

Tematy związane z tymi usługami znajdziesz na tych stronach:

Właściwości oferty

Właściwość Oczekiwany typ Opis
expectsAcceptanceOf.@type Text Wymagany – zawsze ustawiony na Offer.
expectsAcceptanceOf.price Number Wymagany – cena zakupu treści. Cena musi być niezerową wartością dodatnią. W przypadku produktów o cenie 0, 00 określ kategorię jako „free”.
expectsAcceptanceOf.priceCurrency Text Wymagany – waluta, w której podano cenę, przedstawiona w 3-literowym 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 Nazwa sprzedawcy.
expectsAcceptanceOf.seller.sameAs Text Adres URL strony internetowej, która identyfikuje sprzedawcę, np. jego strona główna.

Strona powiązana z ofertą

Tematy związane z tymi usługami znajdziesz na tych stronach:

Identyfikatory

Pliki danych działań związanych z multimediami akceptują różne identyfikatory, które mogą pomóc w jednoznacznym zidentyfikowaniu podmiotu. Te identyfikatory mogą przyspieszyć proces uzgadniania zawartości pliku danych z zawartością baz danych Google. Większość tych identyfikatorów można dodać do pliku danych za pomocą właściwości identifier w przypadku różnych typów jednostek, ale identyfikatory EIDR mają własną właściwość reprezentatywną. Oba te aspekty omówimy poniżej.

Właściwości identyfikatora

Właściwość Oczekiwany typ Opis
identifier Text Zalecane – identyfikator, zwykle zewnętrzny, który jednoznacznie identyfikuje daną encję. Dozwolonych jest kilka identyfikatorów.

Ta właściwość jest dostępna we wszystkich typach działań związanych z oglądaniem.

W tabeli poniżej znajdziesz listę akceptowanych identyfikatorów i właściwości podrzędnych właściwości identifier. Zobacz przykład identyfikatora/EIDR w sekcji przykładowych plików danych Działań dotyczących oglądania.
Właściwość Oczekiwany typ Opis
@type Text Wymagany – zawsze ustawiony na PropertyValue.
propertyID Text Wymagany – obsługujemy te typy identyfikatorów:
  • TMS_ROOT_ID: główny identyfikator Gracenote (TMS) (np. 15829).
    • Nie dotyczy to encji Organization i BroadcastService, w przypadku których 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: identyfikator japońskich talentów w bazie Japan VIPTimes (Nihon Tarento Meikan).
  • DMA_ID: kod wyznaczonego obszaru marketingowego w Stanach Zjednoczonych, używany w obiekcie GeoShape.
  • _PARTNER_ID_: ta właściwość musi zawierać ciąg znaków „_PARTNER_ID_”. 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 Wymagane – wartość określonego systemu identyfikatorów.

Właściwości EIDR

EIDR (skrót od The Entertainment Identifier Registry) to globalny system 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 znajdziesz właściwości powiązane z EIDR i ich zastosowanie.

Właściwość Oczekiwany typ Opis
titleEIDR Text Wysoce zalecane – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje na najbardziej ogólnym/abstrakcyjnym poziomie dzieło filmowe lub telewizyjne.

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

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

Więcej informacji znajdziesz w sekcji Przykład identyfikatora/EIDR w przykładach plików danych o działaniach związanych z oglądaniem.
editEIDR Text Zalecane – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje konkretną wersję utworu filmowego lub telewizyjnego.

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

Na przykład film „Pogromcy duchów”, którego identyfikator EIDR to „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”.

Właściwość titleEIDR jest wymagana, gdy podana jest właściwość editEIDR.

Zobacz przykład identyfikatora EIDR w sekcji przykłady plików danych działań związanych z oglądaniem.

Agencje oceniające treści

Użyj wartości z tej tabeli dla BroadcastService.contentRating, Movie.contentRating i TVSeries.contentRating. Przed wartością oceny należy podać nazwę agencji ratingowej. Przykłady:

  • Film z oceną „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/RUSSIA
Aruba (AW) Niedostępne Niedostępne
Australia (AU) ACB TV ACB Movies
Austria (AT) FSK FSK
Azerbejdżan (AZ) Niedostępne MKRF/RUSSIA
Bahrajn (BH) Niedostępne MPAA
Białoruś (BY) Niedostępne MKRF/RUSSIA
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/RUSSIA
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/RUSSIA MKRF/RUSSIA
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/RUSSIA
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/RUSSIA
Uganda (UG) Niedostępne MPAA
Ukraina (UA) Niedostępne Niedostępne
Zjednoczone Emiraty Arabskie (AE) Niedostępne MPAA
Wielka Brytania (GB) BBFC BBFC
Stany Zjednoczone TV_PG MPAA
Urugwaj (UY) Niedostępne MPAA
Uzbekistan (UZ) Niedostępne MKRF/RUSSIA
Wenezuela (VE) Niedostępne RESORTEVIOLENCIA
Wietnam (VN) Niedostępne MCST
Zambia (ZM) Niedostępne MPAA
Zimbabwe (ZW) Niedostępne MPAA

Właściwości 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 ustawiony na GeoShape.
addressCountry Text Wymagany – dwuliterowy kod kraju w formacie ISO 3166-1 alfa-2.
postalCode Text Opcjonalny – lista co najmniej jednego kodu pocztowego lub kodu FSA (strefy sortowania).
identifier PropertyValue Opcjonalny – identyfikator rynku docelowego (DMA), czyli identyfikator regionu w Stanach Zjednoczonych, w którym ludzie odbierają te same kanały i programy telewizyjne.
identifier.@type Text Wymagany – zawsze ustawiony na PropertyValue.
identifier.propertyID Text Wymagany – zawsze ustawiony na 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ę strefy sortowania (FSA) 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"
    }
  ]
}