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 | Wymagany – obiekt docelowy, który mapuje precyzyjne linki na różne platformy Google. |
target.@type |
tekstowy. | Wymagany – zawsze ustawiony na EntryPoint . |
target.urlTemplate |
Adres URL | Wymagane – precyzyjny 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:
|
target.additionalProperty |
PropertyValue | Wymagany – lista par właściwość-wartość, które reprezentują dodatkowe właściwości precyzyjnego linku. Może to obejmować:
|
actionAccessibilityRequirement |
ActionAccessSpecification | Wymagany – obiekt 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. |
Strony powiązane ze znacznikami działań
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ć
|
actionAccessibilityRequirement.availabilityStarts |
Date | Wymagane – data, po której działanie jest dostępne, w formacie ISO 8601 (z uwzględnieniem strefy czasowej).
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).
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.
|
actionAccessibilityRequirement.expectsAcceptanceOf |
Oferta | Wymagane, jeśli treści wymagają zakupu – szczegóły oferty powiązanej z treścią. Podaj ceny w tych przypadkach:
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:
|
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.
|
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.
Strony powiązane z subskrypcją mediów
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. |
Strona powiązana z ofertą
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:
|
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:
- listę kodów pocztowych (np. Stany Zjednoczone, Kanada lub inne kody pocztowe);
- Lista 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 | 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 | Opcjonalny – identyfikator 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"
}
]
}