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

Ta sekcja zawiera szczegółowe informacje na temat właściwości wspólnych dla działań związanych z zegarkiem.

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

Właściwość Oczekiwany typ Opis
@type Tekst Wymagane – zawsze ma wartość WatchAction.
target EntryPoint Wymaganyobiekt docelowy, który zapewnia mapowanie głębokie linki do różnych platform Google.
target.@type Tekst Wymagane – zawsze ma wartość EntryPoint.
target.urlTemplate Adres URL Wymagany – A głębokie , który przekierowuje użytkowników do Twojej aplikacji lub platformy i zainicjuje odtwarzania treści.
target.inLanguage Tekst Opcjonalny – oryginalny język serii BCP 47 .
target.actionPlatform Tekst Wymagane – platformy, które są zmapowane urlTemplate Działania związane z multimediami obsługują te funkcje:
  • http://schema.org/DesktopWebPlatform: platforma wyszukiwania w przeglądarkach na komputerach.
  • http://schema.org/MobileWebPlatform: platforma wyszukiwania włączona przeglądarek mobilnych.
  • http://schema.org/AndroidPlatform: wyszukiwarka i PlayGuide platform w aplikacji na Androida.
  • http://schema.org/AndroidTVPlatform: Android TV w aplikacji na Androida TV.
  • http://schema.org/IOSPlatform: platforma wyszukiwania w iOS aplikacji.
  • http://schema.googleapis.com/GoogleVideoCast: Przesyłaj i Platformy domowe na urządzeniu Chromecast.
  • http://schema.googleapis.com/GoogleAudioCast: Przesyłaj i Platformy główne na urządzeniu Chromecast (tylko działania związane z słuchaniem).
Zobacz Platforma typów, aby poznać wymagania.
target.additionalProperty PropertyValue Wymagane, jeśli dotyczy – lista par właściwość-wartość przedstawiają dodatkowe właściwości precyzyjnego linku. Może to obejmować: :
  • contentLanguage: język transmisji (dub) w języku: BCP 47 . Jeśli treści są zdubbingowane w innym języku, właściwość jest wymagana. Używaj tablicy dla wielu kodów języków.
  • subtitleLanguage: język napisów lub (w języku angielskim) BCP 47 . Używaj tablicy dla wielu kodów języków.
  • cameraAngle: kąt kamery, pod którym oglądana jest treść; w przypadku na przykład "Eye-Level" i „Wysoki kąt”. Jeśli treści są dostępne w pod różnymi kątami, ta właściwość jest wymagana. Użyj tablicy jako pod różnymi kątami.
  • videoFormat: format pliku używany do przechowywania treści cyfrowych data filmu; na przykład „SD” w przypadku rozdzielczości standardowej i „HD” w przypadku w wysokiej rozdzielczości. Prawidłowe formaty filmów to SD, HD, 2K, 4K i 8K. Używaj tablicy w przypadku różnych formatów wideo.
Zobacz additionalProperty przykład.
actionAccessibilityRequirement ActionAccessSpecification Wymaganedziałanie obiekt specyfikacji dostępu, który opisuje wymagany dostęp treści. Zobacz Działanie Dostęp do właściwości specyfikacji.

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami:

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

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

Wymagany – wymaga dostępu do treści. Więcej Więcej informacji zawiera Typ paywalla.

Jeśli jednostka reprezentuje grupę treści, musisz określić category do najmniej restrykcyjnego wymogu dostępu: jej treści. Jeśli na przykład TVSeries ma pewne Ustawiono treść: TVEpisode na: nologinrequired a kilka ma ustawienie subscription, ustaw to TVSeriesnologinrequired.

actionAccessibilityRequirement.availabilityStarts Data

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

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

W pliku danych należy podać odpowiedni element na stronie co najmniej 7 dni przed datą jego dostępności. Pozwoli to ulepszyć szansę na pojawienie się treści w usługach Google na czas.

actionAccessibilityRequirement.availabilityEnds Data Wymagane – data, po której działanie nie będzie już dostępne. w formacie ISO Format 8601 (wraz ze strefą czasową).
  • Wartość nie może być mniejsza niż 72 godziny po availabilityStarts
  • Jeśli treść jest zawsze dostępna po opublikowaniu, ustaw tę wartość musi przypadać 20 lat od bieżącej daty.

Wszelkie zmiany daty atrybutu dostępność [availabilityEnds] muszą być dokonywane w pliku danych co najmniej 7 dni przed datą „availabilityEnds”. Ten zwiększy szanse na to, że treści przestaną się pojawiać w Google w dniu dostępności.

actionAccessibilityRequirement.eligibleRegion Country (Kraj), Miasto, Stan, GeoShape lub Tekst Wymagany – regiony, w których treść jest dostępna. Użyj specjalny ciąg EARTH, jeśli treść jest dostępna na całym świecie.
actionAccessibilityRequirement.ineligibleRegion Country (Kraj), Miasto, State lub GeoShape Wymagany (w stosownych przypadkach) – regiony, w których treści są ograniczony. Nie musisz podawać tej właściwości, jeśli treść dostępne wszędzie w domenie eligibleRegion.
actionAccessibilityRequirement.requiresSubscription MediaSubscription

Wymagane, jeśli dotyczy – szczegóły których użytkownicy potrzebują, aby mieć dostęp do treści. Zobacz Właściwości subskrypcji multimediów.

  • Podaj tę właściwość, jeśli właściwość category jest subscription lub externalSubscription.
actionAccessibilityRequirement.expectsAcceptanceOf Oferta Wymagany, jeśli treść wymaga zakupu – szczegóły atrybutu oferty powiązanej z treścią. Podaj informacje o cenie dla w następujących przypadkach:
  • Treści kupowane raz (rental lub purchase).
  • treści w subskrypcji, które wymagają dodatkowego zakupu od subskrybenci (subscription lub externalsubscription).
Jeśli cena wynosi 0,00, usuń całkowicie obiekt Offer i ustaw wartość category obiektu ActionAccessSpecification na free. Zobacz Właściwości oferty.

Właściwości subskrypcji multimediów

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

Właściwość Oczekiwany typ Opis
requiresSubscription.@type Tekst Wymagany – zawsze ma wartość MediaSubscription.
requiresSubscription.@id Adres URL Wymagany – unikalny identyfikator subskrypcji. Jeśli treść jest dostępna w ramach różnych subskrypcji, każda z nich musi mieć unikalny identyfikator.
requiresSubscription.name Tekst Wymagane – nazwa subskrypcji. Uwaga:
  • Jeśli treści są dostępne w ramach różnych subskrypcji, nazwa musi być zgodna z nazwą w Twoim systemie uwierzytelniania użytkowników. Dla: Na przykład jeśli użytkownik ma dostęp do treści w ramach subskrypcji o nazwie Pakiet 1, ale system uwierzytelniania używa nazwy PKG1a – użyj PKG1.
  • W przypadku dostawców TVE jest to nazwa uwierzytelniania zarejestrowana w za pomocą aplikacji uwierzytelniającej TVE. Jest to ciąg jednoznacznie identyfikujący Twoją firmę, nazwę usługi za pomocą aplikacji TVE Authenticator.
requiresSubscription.sameAs Adres URL Strona z opisem subskrypcji.
requiresSubscription.identifier Tekst Wymagany, jeśli category to subscription ORAZ commonTierfalse – Unikalny ciąg znaków dla tej subskrypcji, który reprezentuje dostęp do grupy treści w Twoim katalogu multimediów.
  • Google zaleca używanie tej składni identyfikatora:
    nazwa domeny + dwukropek (:) + poziom dostępu do treści, przykłady : example.com:podstawowy, example.com:premium, example.com:sport
  • Ta usługa będzie taka sama jak identyfikator uprawnień jeśli udostępniasz interfejs entitlement API
requiresSubscription.authenticator Organizacja Wymagany, jeśli category to externalsubscription – kontener zawierający szczegóły modułu uwierzytelniającego dostawcy zewnętrznego.
requiresSubscription.authenticator.@type Tekst Wymagany, jeśli category to externalsubscription – zawsze ustawiono na: Organization.
requiresSubscription.authenticator.name Tekst Wymagany, jeśli category to externalsubscription – nazwa uwierzytelniania. posprzedażna. W przypadku dostawców TVE ustaw wartość TVE.
requiresSubscription.commonTier Wartość logiczna Wymagane, jeśli dotyczy – jest wymagane, jeśli kategoria jest ustawiona na subskrypcji. Więcej informacji o CommonTier w wspólny .

Wymagania interfejsu Entitlement API

Interfejs entitlement API jest: wymagane, jeśli actionAccessibilityRequirement.category to subscription lub externalSubscription i Twoja subskrypcja obejmuje wiele pakiety lub poziomy albo oferuje dodatkową obsługę. Nie podawaj tego, jeśli subskrypcja jest jednopoziomowa i daje dostęp do wszystkich treści z katalogu.

  • Firma A oferuje 1 subskrypcję, która obejmuje subskrybentów dostęp do wszystkich dostępnych treści: Identyfikator uprawnień / interfejs API nie wymagane
  • Firma B ma subskrypcję podstawową, która zapewnia dostęp do niektórych treści oraz subskrypcję premium, która daje dostęp do treści premium: Wymagany jest identyfikator uprawnień / interfejs API
  • Firma C ma subskrypcję podstawową, która zapewnia dostęp do niektórych treści oraz dodaj pakiety zapewniające dostęp do treści osób trzecich: Wymagany jest identyfikator uprawnień / interfejs API

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami:

Właściwości oferty

Właściwość Oczekiwany typ Opis
expectsAcceptanceOf.@type Tekst Wymagane – zawsze ma wartość Offer.
expectsAcceptanceOf.price Number Wymagane – cena zakupu treści. Cena musi być niezerową wartością dodatnią. W przypadku elementów w cenie 0, 00 USD określ kategorię jako „bezpłatna”.
expectsAcceptanceOf.priceCurrency Tekst Wymagany – waluta ceny wyrażonej w trzyliterowym tekście. ISO Format 4217.
expectsAcceptanceOf.seller Organizacja Organizacja, która oferuje zakup treści.
expectsAcceptanceOf.seller.@type Tekst Zawsze ustawiona na Organization.
expectsAcceptanceOf.seller.name Tekst Nazwa sprzedawcy.
expectsAcceptanceOf.seller.sameAs Tekst adres URL strony internetowej, która identyfikuje sprzedawcę; Na przykład stronie głównej sprzedawcy.

Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami:

Identyfikatory

Pliki danych typu Media Action akceptują różne identyfikatory, które pomagają identyfikować w jednoznaczny sposób. Identyfikatory te mogą pomóc przyspieszyć uzgadnianie treści w pliku danych z treścią w baz danych. Chociaż większość z tych identyfikatorów można dodać do kanału za pomocą właściwość identifier w różnych typach elementów, identyfikatory EIDR mają własne. reprezentatywną. Omówimy oba te kwestie.

Właściwości identyfikatora

Właściwość Oczekiwany typ Opis
identifier Tekst Zdecydowanie zalecany – identyfikator, zwykle zewnętrzny, jednoznacznie identyfikujący dany podmiot. Dozwolonych jest wiele identyfikatorów.

Ta właściwość jest dostępna w przypadku wszystkich typów elementów zachęcających do oglądania.

W tabeli poniżej znajdziesz listę akceptowanych identyfikatorów i właściwości podrzędnych usługi identifier. Zapoznaj się z przykładem identyfikatora/identyfikatora EIDR w sekcji z przykładami pliku danych działań związanych z oglądaniem.
Właściwość Oczekiwany typ Opis
@type Tekst Wymagane – zawsze ma wartość PropertyValue.
propertyID Tekst Wymagany – obsługujemy te typy identyfikatorów:
  • TMS_ROOT_ID: identyfikator główny Gracenote (TMS), np. 15829).
  • , Nie dotyczy to organizacji encje BroadcastService, w których należy używać tylko TMS_ID.
  • TMS_ID: identyfikator wariantu Gracenote (TMS), np. MV000398520000).
  • WIKIDATA_ID: identyfikator WikiData (np. Q134773).
  • IMDB_ID: identyfikator w IMDB (np. tt0109830).
  • OPTA_ID: identyfikator sportowy OPTA.
  • STATS_ID: STATYSTYKI – identyfikator wykonania.
  • VIP_TIMES_ID: Japan VIPTimes (Nihon Tarento Meikan) reprezentujące japońskie talenty.
  • DMA_ID: przeznaczony do celów marketingowych numer kierunkowy w USA, używany w Obiekt GeoForm.
  • _PARTNER_ID_: ta właściwość musi zawierać ciąg znaków „_PARTNER_ID_”, wartością musi być unikalny identyfikator używany przez usługodawcy (wewnętrznie lub zewnętrznie) w celu identyfikacji jednostki. (na przykład 12345 lub a5c604e2-e9e5-4ff3-b728-245799dc37f1).
value Tekst Wymagane – wartość określonego systemu identyfikatorów.

Właściwości EIDR

EIDR (Entertainment Identifier Registry) to globalnie unikalny system identyfikatorów dla szerokiego zakresu treści multimedialnych, w tym filmów i programów telewizyjnych. System identyfikacji identyfikuje identyfikator do rekordu metadanych powiązanego z tytułami, edycją i innymi elementami najwyższego poziomu. W tabeli poniżej znajdziesz właściwości powiązane z EIDR oraz ich zastosowanie.

Właściwość Oczekiwany typ Opis
titleEIDR Tekst Zdecydowanie zalecany – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje, najbardziej ogólny lub abstrakcyjny, utwór filmowy lub telewizyjny.

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

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

Zobacz przykładowy identyfikator/identyfikator EIDR w sekcji Przykładowe kanały działań związanych z oglądaniem.
editEIDR Tekst Zdecydowanie zalecane – identyfikator EIDR (Entertainment Identifier Registry) reprezentuje konkretną edycję lub edycję utworu filmowego bądź telewizyjnego.

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

Przykładowo: film o nazwie „Pogromcy duchów” którego nazwa EIDR to „10.5240/7EC7-228A-510A-053E-CBB8-J”, ma kilka zmian, np. "10.5240/1F2A-E1C5-680A-14C6-E76B-I" i „10.5240/8A35-3BEE-6497-5D12-9E4F-3”.

Jeśli podano parametr editEIDR, wymagana jest właściwość titleEIDR.

Zobacz przykładowe identyfikatory/EIDR w sekcji z przykładami na kanale działań związanych z oglądaniem.

Agencje oceny treści

Użyj wartości z tej tabeli dla BroadcastService.contentRating, Movie.contentRating i TVSeries.contentRating. Do wartości oceny należy dodać agencję oceniającą. Przykłady:

  • Film z oceną „R” w Stanach Zjednoczonych powinna mieć wartość Movie.contentRating „MPAA R”.
  • serial telewizyjny z oceną „TV-MA”, w Stanach Zjednoczonych powinna mieć wartość TVSeries.contentRating „TVPG TV-MA”.

Kraj Agencja oceniająca reklamy 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 Filmy ACB
Austria (AT) FSK FSK
Azerbejdżan (Arizona) 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) KLASYFIKACJA KLASYFIKACJA
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 (Nebraska) Niedostępne CNC
Norwegia (NO) Niedostępne MEDIETILSYNET
Oman 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 (Rwanda) Niedostępne CNC
Arabia Saudyjska (SA) Niedostępne MPAA
Senegal (Chiny) 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 (ZEA) 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 GeoForm

Obiekt GeoForm zawiera jeden z tych typów danych:

Właściwość Oczekiwany typ Opis
@id Adres URL Wymagany – identyfikator regionu geograficznego w formacie URI.
@type Tekst Wymagane – zawsze ma wartość GeoShape.
addressCountry Tekst Wymagany – dwuliterowy kod ISO Kod kraju 3166-1 alfa-2.
postalCode Tekst Opcjonalnie – lista co najmniej jednego kodu pocztowego lub kodu FSA (powszechnego sortowania).
identifier PropertyValue Opcjonalny – A Identyfikator rynku docelowego (DMA), którym jest identyfikatora regionu w Stanach Zjednoczonych, w którym użytkownicy otrzymują te same kanały i programy telewizyjne.
identifier.@type Tekst Wymagane – zawsze ma wartość PropertyValue.
identifier.propertyID Tekst Wymagane – zawsze ma wartość DMA_ID.
identifier.value Tekst Wymagany – kod DMA dla 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ę kodu FSA (obszaru sortowania do przodu) 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"
    }
  ]
}