Czynności „obsługa”; typowe właściwości

W tej sekcji znajdziesz szczegółowe informacje o typowych właściwościach działań zegarka.

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

Właściwość Oczekiwany typ Opis
@type tekstowy. Wymagany – zawsze ustawiony na WatchAction.
target Punkt wejścia Wymaganyobiekt docelowy, który mapuje precyzyjne linki na różne platformy Google.
target.@type tekstowy. Wymagany – zawsze ustawiony na EntryPoint.
target.urlTemplate Adres URL Wymaganeprecyzyjny link prowadzący użytkowników do aplikacji lub platformy, który inicjują odtwarzanie treści.
target.inLanguage tekstowy. Opcjonalny – pierwotny język serii w formacie BCP 47.
target.actionPlatform tekstowy. Wymagane – platformy zmapowane na urlTemplate. Działania związane z multimediami obsługują te elementy:
  • http://schema.org/DesktopWebPlatform: platforma wyszukiwania w przeglądarkach na komputerach.
  • http://schema.org/MobileWebPlatform: platforma wyszukiwania w przeglądarkach mobilnych.
  • http://schema.org/AndroidPlatform: platformy wyszukiwania i przewodników Play w aplikacji na Androida.
  • http://schema.org/AndroidTVPlatform: platforma Androida TV w aplikacji na Androida TV.
  • http://schema.org/IOSPlatform: platforma wyszukiwania w aplikacji na iOS.
  • http://schema.googleapis.com/GoogleVideoCast: platformy Cast i Home na urządzeniu Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Chromecast i platformy główne na urządzeniu Chromecast (tylko słuchanie).
Wymagania znajdziesz w sekcji Typy platform.
target.additionalProperty PropertyValue Wymagany – lista par właściwość-wartość, które reprezentują dodatkowe właściwości precyzyjnego linku. Może to obejmować:
  • contentLanguage: język transmisji (dub), w formacie BCP 47. Jeśli treści są dubbingowane w innym języku, jest to wymagane. W przypadku wielu kodów języków użyj tablicy.
  • subtitleLanguage – języki napisów w formacie BCP 47. W przypadku wielu kodów języków użyj tablicy.
  • cameraAngle: kąt widzenia kamery, np. „Poziom oka” i „kąt kąta”. Jeśli treści są dostępne pod różnymi kątami, musisz użyć tej właściwości. Użyj tablicy, aby uzyskać wiele kątów kamery.
  • videoFormat: format pliku używany do przechowywania cyfrowych treści wideo, np. „SD” w przypadku rozdzielczości standardowej i „HD” w przypadku wysokiej rozdzielczości. Prawidłowe formaty wideo to SD, HD, 2K, 4K i 8K. Użyj tablicy do różnych formatów wideo.
Zobacz przykład additionalProperty.
actionAccessibilityRequirement ActionAccessSpecification Wymaganyobiekt specyfikacji dostępu do działania, który opisuje wymagania dostępu do treści. Zobacz właściwości specyfikacji dostępu do działania.

Przejrzyj te strony dotyczące tematów powiązanych z tymi właściwościami:

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

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

Wymagane – wymaganie dostępu do treści. Więcej informacji znajdziesz w opisie typu PayPal.

Jeśli element reprezentuje grupę treści, musisz ustawić category jako najmniej restrykcyjny wymóg dostępu do treści. Jeśli na przykład w polu TVSeries znajduje się kilka wartości TVEpisode z wartością nologinrequired, a kilka wartości ma wartość subscription, ustaw właściwość TVSeries na nologinrequired.

actionAccessibilityRequirement.availabilityStarts Date

Wymagane – data, po której działanie jest dostępne, w formacie ISO 8601 (z uwzględnieniem strefy czasowej).

  • Możesz ustawić datę w przyszłości.

Wymagany element musi być podany w pliku danych co najmniej 7 dni przed datą jego dostępności. To z kolei zwiększy szansę na to, że treści pojawią się w Google na czas.

actionAccessibilityRequirement.availabilityEnds Date Wymagane – data, po której działanie nie będzie już dostępne, podana w formacie ISO 8601 (z uwzględnieniem strefy czasowej).
  • Musi być równa lub większa niż 72 godziny od availabilityStarts.
  • Jeśli treść jest zawsze dostępna po opublikowaniu, ustaw ją na 20 lat od obecnej daty.

Wymagane są daty aktualizacji dostępności w pliku danych co najmniej 7 dni przed datą dostępności. To zwiększy szanse na to, że treści przestaną się wyświetlać w usługach Google od dnia availabilityEnds.

actionAccessibilityRequirement.eligibleRegion Kraj, Miasto, Stan, Kształt geograficzny lub Tekst Wymagane – regiony, w których treść jest dostępna. Jeśli treść jest dostępna na całym świecie, użyj specjalnego ciągu znaków EARTH.
actionAccessibilityRequirement.ineligibleRegion Country, Miasto, State lub GeoShape Wymagany, jeśli ma zastosowanie – regiony, w których treści są objęte ograniczeniami. Nie musisz udostępniać tej właściwości, jeśli treść jest dostępna wszędzie w eligibleRegion.
actionAccessibilityRequirement.requiresSubscription Subskrypcja mediów

Wymagany – szczegóły subskrypcji wymaganej przez użytkowników do uzyskiwania dostępu do treści. Zobacz Właściwości subskrypcji mediów.

  • Podaj tę właściwość, jeśli właściwość category ma wartość subscription lub externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Wymagane, jeśli treści wymagają zakupu – szczegóły oferty powiązanej z treścią. Podaj ceny w tych przypadkach:
  • Jednorazowy zakup (rental lub purchase)
  • Treści z subskrypcji, które wymagają dodatkowego zakupu od subskrybentów (subscription lub externalsubscription).
Jeśli cena wynosi 0,00, usuń całkowicie obiekt Offer i ustaw category z obiektu ActionAccessSpecification na free. Zobacz Właściwości oferty.

Właściwości subskrypcji mediów

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

Właściwość Oczekiwany typ Opis
requiresSubscription.@type tekstowy. Wymagany – zawsze ustawiony na MediaSubscription.
requiresSubscription.@id Adres URL Wymagane – 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 tekstowy. Wymagane – nazwa subskrypcji. Uwaga:
  • Jeśli treść jest dostępna w ramach różnych subskrypcji, ta nazwa musi być taka sama jak nazwa w systemie uwierzytelniania użytkownika. Jeśli na przykład użytkownik ma dostęp do treści oparty na subskrypcji Pakiet 1, ale system uwierzytelniania używa nazwy PKG1a, wpisz PKG1.
  • W przypadku dostawców usług telewizyjnych jest to nazwa uwierzytelniania zarejestrowana w ramach uwierzytelniania TVE. Jest to ciąg znaków, który jednoznacznie identyfikuje nazwę usługi za pomocą aplikacji Authenticator.
requiresSubscription.sameAs Adres URL Strona opisująca subskrypcję.
requiresSubscription.identifier tekstowy. Wymagany, jeśli category to subscription ORAZ commonTier to false – unikalny ciąg znaków tej subskrypcji, który reprezentuje dostęp do grupy treści w Twoim katalogu multimediów.
  • Google zaleca korzystanie z tej składni identyfikatora:
    nazwa domeny + dwukropek (:) + poziom dostępu do treści, przykłady : example.com:podstawowa, example.com:premium, example.com:sport
  • Ta właściwość będzie taka sama jak identyfikator uprawnienia, jeśli udostępniasz interfejs API uprawnień
requiresSubscription.authenticator Organizacja Wymagany, jeśli category to externalsubscription – kontener zawierający szczegóły uwierzytelniania zewnętrznego dostawcy.
requiresSubscription.authenticator.@type tekstowy. Wymagane, jeśli category ma wartość externalsubscription – zawsze ma wartość Organization.
requiresSubscription.authenticator.name tekstowy. Wymagany, jeśli category to externalsubscription – nazwa usługi uwierzytelniania. W przypadku dostawców usług TVE ustaw TVE.
requiresSubscription.commonTier Wartość logiczna Wymagany, jeśli ma zastosowanie – wymagany, jeśli kategoria ma wartość subskrypcji. Więcej informacji o CommonTier znajdziesz w dokumentacji wymagań dotyczących typowych poziomów.

Wymagania dotyczące uprawnienia dotyczącego interfejsu API

Interfejs API uprawnień jest wymagany, jeśli właściwość actionAccessibilityRequirement.category ma wartość subscription lub externalSubscription, a oferta subskrypcji obejmuje wiele pakietów lub poziomów albo obsługuje dodatkowe funkcje. Nie uwzględniaj go, jeśli Twoja subskrypcja jest wielopoziomowa i daje dostęp do całej zawartości katalogu.

  • Firma A ma jedną ofertę subskrypcji, która daje subskrybentom dostęp do całej dostępnej treści: identyfikator uprawnienia do korzystania z interfejsu API nie jest wymagany.
  • Firma B ma subskrypcję podstawową zapewniającą dostęp do niektórych treści oraz subskrypcję premium, która daje dostęp do treści premium: wymagany jest identyfikator podmiotu / interfejs API.
  • Firma C ma subskrypcję podstawową, która zapewnia dostęp do niektórych treści i dodawana do pakietów, które zapewniają dostęp do treści należących do osób trzecich: wymagany jest identyfikator podmiotu / interfejs API.

Przejrzyj te strony dotyczące tematów powiązanych z tymi właściwościami:

Właściwości oferty

Właściwość Oczekiwany typ Opis
expectsAcceptanceOf.@type tekstowy. Wymagany – zawsze ustawiony na Offer.
expectsAcceptanceOf.price Number Wymagany – cena zakupu treści. Cena musi być dodatnia. W przypadku jednostek ceny 0, 00 wybierz kategorię „bezpłatne”.
expectsAcceptanceOf.priceCurrency tekstowy. Wymagany – waluta ceny podana w 3-literowym formacie ISO 4217.
expectsAcceptanceOf.seller Organizacja Organizacja, która oferuje zakup treści.
expectsAcceptanceOf.seller.@type tekstowy. Zawsze ustawiona na Organization.
expectsAcceptanceOf.seller.name tekstowy. Nazwa sprzedawcy.
expectsAcceptanceOf.seller.sameAs tekstowy. Adres URL strony internetowej sprzedawcy, np. strona główna sprzedawcy.

Przejrzyj te strony dotyczące tematów powiązanych z tymi właściwościami:

Identyfikatory

Pliki danych dotyczące działań związanych z multimediami akceptują różne identyfikatory, które jednoznacznie identyfikują podmiot. Mogą one przyspieszyć proces uzgadniania treści pliku danych z zawartością baz danych Google. Większość z tych identyfikatorów można dodać do pliku danych za pomocą właściwości identifier w różnych typach encji, jednak identyfikatory EIDR mają własną reprezentatywną właściwość. Oba te warunki zostały omówione poniżej.

Właściwości identyfikatora

Właściwość Oczekiwany typ Opis
identifier tekstowy. Zdecydowanie zalecane – zwykle identyfikator zewnętrzny, który jednoznacznie identyfikuje dany podmiot. Dozwolonych jest kilka identyfikatorów.

Ta właściwość jest dostępna we wszystkich typach elementów działań zachęcających do oglądania.

W tabeli poniżej znajdziesz akceptowane identyfikatory i usługi podrzędne właściwości identifier. Zobacz przykład identyfikatora i identyfikatora EIDR w sekcji przykładów kanału aktywności.
Właściwość Oczekiwany typ Opis
@type tekstowy. Wymagany – zawsze ustawiony na PropertyValue.
propertyID tekstowy. Wymagane – obsługujemy te typy identyfikatorów:
  • TMS_ROOT_ID: identyfikator główny Gracenote (TMS), np. 15829.
  • . Nie dotyczy to obiektów organizacji i BroadcastService, w których ma być używany tylko TMS_ID.
  • TMS_ID: identyfikator wariantu Gracenote (TMS) – na przykład MV000398520000.
  • WIKIDATA_ID: identyfikator WikiData (np. Q134773).
  • IMDB_ID: identyfikator IMDB (np. tt0109830).
  • OPTA_ID: identyfikator sportu OPTA.
  • STATS_ID: identyfikator STATS Perform.
  • VIP_TIMES_ID: japońskie adresy VIP VIP (Nihon Tarento Meikan) dla japońskich talentów.
  • DMA_ID: amerykański kod obszaru marketingowego używany w obiekcie GeoShape.
  • _PARTNER_ID_: właściwość musi zawierać ciąg „_PARTNER_ID_”, wartość musi być unikalnym identyfikatorem używanym przez dostawcę usług (wewnętrznie lub zewnętrznie) do identyfikowania jednostki (na przykład 12345 lub a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value tekstowy. Wymagany – wartość dla określonego systemu identyfikatora.

Właściwości EIDR

EIDR (skrót od Entertainment Identifier Registry) to globalnie unikalny system identyfikacji szerokiej gamy treści multimedialnych, w tym filmów ruchomych i programów telewizyjnych. System identyfikacji rozpoznaje identyfikator w rekordzie metadanych, który jest powiązany z tytułami najwyższego poziomu, zmianami i innymi parametrami. Poniższa tabela zawiera listę usług powiązanych z EIDR i ich wykorzystaniem.

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

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

Na przykład tytuł „EIDR” filmu ruchomego o nazwie „Pogromcy duchów” to „10.5240/7EC7-228A-510A-053E-CBB8-J/”.

Zobacz przykład w sekcji samouczki
editEIDR tekstowy. Zdecydowanie zalecane – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje konkretną edycję/wydanie filmu lub programu telewizyjnego.

Ta właściwość jest dostępna na stronach specyfikacji elementu TV i Film.

Na przykład zdjęcie ruchome o nazwie „Pogromcy duchów”, którego tytuł to EIDR „10.5240/7EC7-228A-510A-053E-CBB8-J”, zawiera kilka zmian, np. „10.5240/1-2-a_aktualizacja”.

Agencje oceny treści

Użyj wartości w tej tabeli dla parametrów BroadcastService.contentRating, Movie.contentRating i TVSeries.contentRating. Agencja oceniająca musi dołączyć wartość oceny. Przykłady:

  • Film z oceną „R” w Stanach Zjednoczonych powinien mieć wartość Movie.contentRating „MPAA R”.
  • Seriale i seriale w Stanach Zjednoczonych z oceną „TV-MA” powinny mieć wartość TVSeries.contentRating „TVPG TV-MA”.

Kraj Agencja oceniająca TV Agencja oceniająca filmy
Albania (AL) Niedostępne Niedostępne
Angola (AO) Niedostępne DW
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) Telewizor ACB Filmy ACB
Austria (AT) KWF KWF
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) ZAJĘCIA ZAJĘCIA
Burkina Faso (BF) Niedostępne CNC;
Kambodża (KH) Niedostępne Niedostępne
Kanada (CA) CA_TV CHVR
Republika Zielonego Przylądka (CV) Niedostępne DW
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 GRUPA
Czechy (CZ) Niedostępne CZEK
Dania (DK) Niedostępne MCK
Ekwador (EC) Niedostępne MPAA;
Egipt (EG) Niedostępne MPAA;
Salwador (SV) Niedostępne MPAA;
Estonia (EE) Niedostępne EEEE
Fidżi (FJ) Niedostępne Niedostępne
Finlandia (FI) Niedostępne MEKU
Francja (FR) CSA, CSA,
Gabon (GA) Niedostępne CNC;
Niemcy (DE) KWF KWF
Grecja (GR) ESR, GRUPA
Gwatemala (GT) Niedostępne MPAA;
Haiti (HT) Niedostępne Niedostępne
Honduras (HN) Niedostępne MPAA;
Hongkong (HK) CA Dyrektor ds. technologii
Węgry (HU) Niedostępne MPAA;
Islandia (IS) Niedostępne JJKWIJZER
Indie (IN) CBFC, CBFC,
Indonezja (ID) KPI LSF.
Irlandia (IE) Niedostępne IFCO
Włochy (IT) AGCOM AGCOM
Wybrzeże Kości Słoniowej Niedostępne CNC;
Jamajka (JM) Niedostępne MPAA;
Japonia (JP) Nie dotyczy EIRIN
Jordania (JO) Niedostępne MPAA;
Kazachstan (KZ) Niedostępne MKK
Korea Południowa KMR KMR
Kuwejt (KW) Niedostępne MPAA;
Kirgistan (KG) Niedostępne MKRF/ROSJA
Laos (LA) Niedostępne Niedostępne
Łotwa (LV) Niedostępne Certyfikat NKCLV
Liban (LB) Niedostępne MPAA;
Litwa (LT) Niedostępne Niedostępne
Luksemburg (LU) Niedostępne JJKWIJZER
Macedonia (MK) Niedostępne MPAA;
Malezja (MY) Niedostępne FCBM (FCBM)
Mali (ML) Niedostępne CNC;
Malta (MT) Niedostępne MCKAA
Mauritius (MU) Niedostępne BBFC
Meksyk (MX) RTC RTC
Mołdawia Niedostępne Niedostępne
Namibia (NA) Niedostępne Niedostępne
Nepal (NP) Niedostępne MPAA;
Holandia (NL) JJKWIJZER JJKWIJZER
Nowa Zelandia (NZ) Biura OFLC
Nikaragua (NI) Niedostępne MPAA;
Niger (Nebraska) 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 DW
Katar (QA) Niedostępne MPAA;
Rosja – Rosja MKRF/ROSJA MKRF/ROSJA
Rwanda (RW) Niedostępne CNC;
Arabia Saudyjska (SA) 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) ZBIORY ICAA
Sri Lanka (LK) Niedostępne Niedostępne
Szwecja (SE) Niedostępne SMS-y
Szwajcaria (CH) KWF KWF
Tajwan (TW) Niedostępne MOTYW
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) RTRU EKSPORT
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 ReORTEVIOLENCIA
Wietnam (VN) Niedostępne Certyfikat 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 Wymagane – identyfikator regionu geograficznego w formacie identyfikatora URI.
@type tekstowy. Wymagany – zawsze ustawiony na GeoShape.
addressCountry tekstowy. Wymagany – dwuliterowy kod kraju ISO 3166-1 alfa-2.
postalCode tekstowy. Opcjonalnie – lista co najmniej jednego kodu pocztowego lub kodów FSA (obszar sortowania).
identifier PropertyValue Opcjonalnyidentyfikator rynku docelowego (DMA), czyli identyfikator regionu w Stanach Zjednoczonych, w którym odbiorcy otrzymują te same kanały i programy telewizyjne.
identifier.@type tekstowy. Wymagany – zawsze ustawiony na PropertyValue.
identifier.propertyID tekstowy. Wymagany – zawsze ustawiony na DMA_ID.
identifier.value tekstowy. Wymagane – kod DMA regionu.

Przykład obiektu GeoShape, który zawiera listę kodów pocztowych:

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

Przykład obiektu GeoShape, który zawiera kombinację kodu FSA (obszar sortowania) do przodu i kody pocztowe:

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

Przykład obiektu GeoShape, który zawiera identyfikator DMA:

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