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 | Wymagany – obiekt 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:
|
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ć:
:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Wymagane – działanie obiekt specyfikacji dostępu, który opisuje wymagany dostęp treści. Zobacz Działanie Dostęp do właściwości specyfikacji. |
Strony powiązane ze znacznikami działań
Na tych stronach znajdziesz informacje o tematach związanych z tymi usługami:
- Omówienie znaczników działań
- Identyfikowanie precyzyjnych linków na określonej platformie do Twoich treści
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ć
|
actionAccessibilityRequirement.availabilityStarts |
Data | Wymagane – data, po której działanie będzie dostępne, podana w formacie ISO Format 8601 (wraz ze strefą czasową).
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ą).
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.
|
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:
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:
|
requiresSubscription.sameAs |
Adres URL | Strona z opisem subskrypcji. |
requiresSubscription.identifier |
Tekst | Wymagany, jeśli category to subscription ORAZ
commonTier – false
–
Unikalny ciąg znaków dla tej subskrypcji, który reprezentuje dostęp do grupy treści w Twoim katalogu multimediów.
|
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
Strony powiązane z subskrypcją multimediów
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. |
Strona związana z ofertą
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:
|
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:
- lista kodów pocztowych (na przykład z Kanady, Kanady lub innych krajów);
- listę Kanadyjskich obszarów sortowania
- Identyfikator rynku docelowego (DMA) – identyfikator regionu w Stanach Zjednoczonych, w którym użytkownicy otrzymują te same kanały telewizyjne i programy.
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"
}
]
}