Ta sekcja zawiera szczegółowe informacje o właściwościach znaczników treści podcastów.
Specyfikacja PodcastSeries
PodcastSeries
reprezentuje serię podcastów, nazywaną też „programem”.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@context |
Wymagany | Tekst | Kontekst schema.org. Zawsze powinna być ustawiona na [http://schema.googleapis.com,{@language}:xx}] , gdzie xx powinno być w kodzie języka. Określa domyślny język wartości tekstowych elementu. |
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość PodcastSeries . |
@id |
Wymagany | Tekst | Unikalny w skali globalnej identyfikator serii podcastów w formacie URI. Identyfikator musi być stabilny i nie może się zmieniać w czasie. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. Domena użyta w wartości @id musi należeć do Twojej organizacji.
|
url |
Wymagany | Tekst | Kanoniczny adres URL w Twojej witrynie, pod którym opisano lub opisano serię podcastów. Nie może się powtarzać. Ten link pomaga dokładnie uzgodnić zawartość pliku danych z danymi w bazach danych Google. Na potrzeby odtwarzania korzystaj z target.urlTemplate określonego w sekcji ListenAction dokumentacji. |
name |
Wymagany | Tekst | Nazwa serii podcastów. Podaj tylko jedną nazwę w danym języku. Użyj tablicy do oznaczenia opisu w wielu językach. Zobacz przykład wielu regionów i języków. |
description |
Wymagany | Tekst | Streszczenie serii podcastów Użyj tablicy do oznaczenia opisu w wielu językach. Zobacz przykład wielu regionów i języków. |
alternativeHeadline |
Opcjonalny | Tekst | Napisy do serii podcastów |
author |
Wymagany | powtórzone |
Osoba lub grupa, która tworzy lub dostarcza program. Często oznacza hosta. Przykłady i szczegóły znajdziesz w artykule Organizacja, osoba (autor/wydawca). |
publisher |
Opcjonalny | powtórzone |
Oryginalna grupa lub sieć odpowiedzialna za publikację programu. Odnosi się często do organizacji odpowiedzialnej za publikowanie/produkcję kilku podcastów. Przykłady i szczegóły znajdziesz w artykule Organizacja, osoba (autor/wydawca). Pole to jest zdecydowanie zalecane w przypadku ujednoznaczniania i należy je podawać w stosownych przypadkach. |
actor |
Opcjonalny | powtórzone |
Aktor podcastu. Przykłady i szczegóły znajdziesz w sekcji Użytkownik, który wykonał czynność . |
logo |
Opcjonalny | powtórzone |
Obraz logo serii. Podaj go jako pełny opis ImageObject . Udostępnij najwyższą dostępną rozdzielczość. Preferowany jest format JPEG lub PNG. Szczegółowe informacje i przykłady znajdziesz w sekcji ImageObject (logo). |
image |
Wymagany | powtórzone |
Obraz grafiki z serii. Podaj pełne opisy ImageObject . Udostępnij najwyższą dostępną rozdzielczość. Preferowany jest format JPEG lub PNG. Szczegółowe informacje i przykłady znajdziesz w sekcji ImageObject (logo). |
isFamilyFriendly |
Wymagany | Wartość logiczna | Wskazuje, czy treści są odpowiednie dla całej rodziny (tzn. czy są odpowiednie dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą pomóc w określeniu treści do odtworzenia, używając isFamilyFriendly . Wartością musi być true lub false . |
inLanguage |
Wymagany | Tekst | Język treści podcastu w formacie ISO 639-1. Tej wartości można używać do wykonywania zapytań użytkowników żądających treści w określonym języku. |
genre |
Wymagany | Tekst powtórzone |
Kategoria lub gatunek serii podcastów. Możesz na przykład użyć standardowych kategorii podcastów. |
endDate |
Opcjonalny | Data | Data premiery ostatniego odcinka podcastu. Wypełnij to pole tylko wtedy, gdy seria jest już ukończona. |
rssFeed |
Wymagany | URL | Adres URL kanału RSS serii podcastów. |
potentialAction |
Wymagany | ListenAction |
Działanie wywoływane przez użytkowników w celu odsłuchania treści. Szczegółowe informacje znajdziesz w sekcji ListenAction (słuchanie). |
popularityScore
| Opcjonalny | PopularityScoreSpecification |
Wynik popularności pomaga określić priorytet wyświetlania, gdy jest wielu kandydatów. Szczegółowe informacje i przykłady znajdziesz w sekcji PopularityScoreSpecification (popularityScore) . |
keywords |
Opcjonalny | Tekst powtórzone |
Lista słów kluczowych, które zostaną powiązane z serią podcastów. Te słowa kluczowe mogą służyć do poszerzania zakresu zapytań użytkowników, które mogą aktywować serię podcastów. Na przykład imiona i nazwiska gości, tematy itd. |
sameAs |
Opcjonalny | URL | Adres URL strony internetowej innej firmy (nienależącej do Twojej domeny), która jednoznacznie identyfikuje produkt. Ta strona jest używana do ujednoznacznienia, gdy istnieje wiele podobnych serii. Na przykład strona w Wikipedii lub strona główna serii podcastów. To pole jest zdecydowanie zalecane na potrzeby ujednoznacznienia serii. |
releasedEvent |
Opcjonalny | PublicationEvent lub bardziej szczegółowe podtypy – FeatureEvent lub WyłączEvent |
Zdarzenie oznaczające publikację lub wydanie serii podcastów. W przypadku publikacji wydawcy możemy poinformować o początkowej wersji podcastu przez wydawcę, a bardziej zaawansowane typy mogą wskazywać, że jest ona dostępna publicznie. Szczegółowe informacje i przykłady znajdziesz w sekcji PublicationEvent, FeatureEvent, WyłączEvent (releasedEvent). Pamiętaj, że oznaczenie serialu jako wyjątkowego lub polecanego oznacza, że wszystkie odcinki programu są wyjątkowe lub wyjątkowe. |
countryOfOrigin |
Opcjonalny | Kraj | Kraj biura głównej firmy produkcyjnej lub osoby odpowiedzialnej za podcast. |
Specyfikacja odcinków podcastu
PodcastEpisode
to schema.org reprezentujący odcinek w obrębie znaczników PodcastSeries
.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@context |
Wymagany | Tekst | Kontekst schema.org. Zawsze ustawiana jest wartość [http://schema.googleapis.com,{@language:xx}] , gdzie xx jest kodem języka. Pozwala to ustawić domyślny język znaków używany w wartościach tekstowych w pliku danych. |
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość PodcastEpisode . |
@id |
Wymagany | Tekst | Unikalny globalnie identyfikator odcinka podcastu w formacie URI. Identyfikator musi być stabilny i nie może się zmieniać w czasie. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. Twoja organizacja musi być właścicielem domeny używanej w wartości @id . |
url |
Wymagany | Tekst | Kanoniczny adres URL witryny, w którym prezentujesz lub opisujesz odcinek podcastu. Ta wartość musi być globalnie niepowtarzalna. Ten link pomaga pomóc w uzgodnieniu zawartości pliku danych z danymi w bazach danych Google. Do odtwarzania używana jest właściwość target.urlTemplate opisana w sekcji ListenAction dokumentacji. |
name
| Wymagany | Tekst | Nazwa odcinka podcastu. W każdym języku musi być tylko jedna nazwa. Użyj tablicy do oznaczenia opisu w wielu językach. Zobacz przykład wielu regionów i języków. |
description |
Wymagany | Tekst | Opis odcinka podcastu. |
alternativeHeadline |
Wymagany | Tekst | Podtytuł odcinka podcastu. |
author |
Wymagany | powtórzone |
Osoba lub grupa, która opracowuje lub dostarcza odcinek. Ta wartość często odnosi się do hosta. Jeśli autor jest tym samym programem, możesz ponownie wykorzystać informacje zawarte w elemencie PodcastSeries . Przykłady i szczegółowe informacje znajdziesz w sekcji Organizacja, osoba (autor/wydawca). |
publisher |
Wymagany | powtórzone |
Oryginalna grupa lub sieć odpowiedzialna za publikację programu. Odnosi się często do organizacji odpowiedzialnej za publikowanie lub produkowanie kilku podcastów. Przykłady i szczegóły znajdziesz na stronie Organizacja, osoba (autor/wydawca). Zdecydowanie zalecamy skorzystanie z tego pola i zalecamy zdefiniowanie go w razie potrzeby. |
actor |
Wymagany | powtórzone |
Aktor podcastu. Przykłady i szczegółowe informacje znajdziesz w sekcji Użytkownik, który wykonał czynność (host/gość). |
datePublished |
Wymagany | Data/godzina | Data premiery odcinka podcastu. Ta wartość służy do sortowania sekwencji odcinków i ujednoznacznienia. |
episodeNumber |
Wymagany | Liczba całkowita | Numer odcinka. |
partOfSeries |
Wymagany | Serie podcastów | PodcastSeries , w którym znajduje się ten odcinek podcastu. Więcej informacji i przykłady znajdziesz na stronie PodcastSeries(częśćSeria). |
partOfSeason |
Opcjonalny | Sezon podcast | W przypadku serii kilku sezonów ta usługa zawiera informacje o sezonie, numer sezonu i nazwę sezonu. Więcej informacji i przykładów znajdziesz na stronie PodcastSeason(częśćSeason). |
timeRequired |
Wymagany | Czas trwania | Długość odcinka w formacie ISO 8601. |
image |
Opcjonalny | powtórzone |
Obraz grafiki z serii. Musi to być pełny opis ImageObject . Udostępnij najwyższą dostępną rozdzielczość. Preferowany jest format JPEG lub PNG. Szczegółowe informacje i przykłady znajdziesz w sekcji ImageObject (logo). |
isFamilyFriendly |
Wymagany | Wartość logiczna | Wskazuje, czy treści są odpowiednie dla całej rodziny (tzn. czy są odpowiednie dla wszystkich członków rodziny, w tym dzieci). Usługi Google mogą używać isFamilyFriendly do określania treści do odtwarzania.
Musi to być wartość true lub false . |
inLanguage |
Wymagany | Tekst | Język treści odcinka podcastu w formacie ISO 639-1. Używaj tej wartości w przypadku zapytań użytkowników, które wysyłają żądanie o treści w określonym języku. Jeśli treści są w wielu językach, wymień tylko jeden język główny. |
genre |
Wymagany | Tekst powtórzone |
Kategoria lub gatunek serii podcastów. Możesz na przykład przestrzegać standardowych kategorii podcastów. |
associatedMedia |
Opcjonalny | AudioObject | Plik audio odcinka podcastu. Szczegółowe informacje i przykłady znajdziesz w sekcji AudioObject(relateddMedia). |
potentialAction |
Wymagany | ListenAction (słuchanie) | Działanie wywoływane przez użytkowników w celu odsłuchania treści. Więcej informacji znajdziesz w sekcji ListenAction (słuchanie). |
popularityScore |
Opcjonalny | SpecyfikacjaWynika popularności | Wynik popularności, który określa priorytet wyświetlania w przypadku wielu kandydatów. Szczegółowe informacje i przykłady znajdziesz w sekcji PopularityScoreSpecification. |
keywords |
Opcjonalny | Tekst powtórzone |
Lista słów kluczowych powiązanych z serią podcastów. Te słowa kluczowe mogą służyć do poszerzania zakresu zapytań użytkowników, które mogą prowadzić do danego odcinka podcastu. na przykład news , sports lub history . |
identifier |
Wymagany | PropertyValue powtórzone |
W przypadku Przykład znajdziesz w sekcji PropertyValue (identifier). |
sameAs |
Opcjonalny | URL | Adres URL strony internetowej innej firmy (nienależącej do Twojej domeny), która jednoznacznie identyfikuje produkt. Google używa tej strony na potrzeby ujednoznacznienia, jeśli istnieje wiele podobnych serii. Na przykład strona w Wikipedii lub strona główna odcinków podcastów. Pamiętaj, że nie możesz tu podać strony z informacjami na poziomie serii. Zdecydowanie zalecamy, aby to pole było ujemne. |
releasedEvent |
Opcjonalny | PublicationEvent lub bardziej szczegółowe podtypy – FeatureEvent lub WyłączEvent | Zdarzenie, które oznacza publikację lub wydanie odcinka podcastu. O publikacji może wskazywać początkowa wersja odcinka podcastu przez wydawcę, a bardziej szczegółowe podtypy mogą oznaczać, że jest ona dostępna tylko dla subskrybentów. Szczegółowe informacje i przykłady znajdziesz w sekcji PublicationEvent, FeatureEvent, ExceptionEvent (releasedEvent). Pamiętaj, że oznaczenie serialu jako wyjątkowego lub polecanego powyżej oznacza, że wszystkie odcinki programu są wyjątkowe i polecane. Zalecamy oznaczanie ich na najbardziej szczegółowym poziomie. |
countryOfOrigin |
Opcjonalny | Kraj | Kraj głównej siedziby firmy produkcyjnej lub osoby odpowiedzialnej za podcast. |
PodcastSeries (część Seria)
Użyj tagu partOfSeries
, aby utworzyć relację między tagiem PodcastEpisode
a jego elementem nadrzędnym PodcastSeries
. Pełne szczegóły elementu PodcastSeries
są opisane w oddzielnym elemencie PodcastSeries
, więc nie musisz podawać wszystkich szczegółów w partOfSeries
. Wystarczy, że podasz te właściwości:
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość PodcastSeries . |
@id |
Wymagany | URL | Unikalny globalnie identyfikator serii w identyfikatorze URI. Identyfikator musi być zgodny z identyfikatorem kompletnej encji PodcastSeries w pliku danych. |
name |
Wymagany | Tekst | Nazwa serii podcastów.
|
Przykład 1
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=1",
"name": "Radiolab"
},
Sezon Podcast (część strefy)
PodcastSeason
reprezentuje informacje o sezonie (PodcastEpisode
), a najważniejszy jest numer sezonu. Ta właściwość jest potrzebna tylko wtedy, gdy seria podcastów ma wiele sezonów.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiona na PodcastSeason |
@id |
Wymagany | URL | Unikalny globalnie identyfikator sezonu w identyfikatorze URI. Ten identyfikator musi być stały i nie może się zmieniać. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. |
seasonNumber |
Wymagany | Liczba całkowita | Numer sezonu serii podcastów. |
name |
Opcjonalny | Tekst | Nazwa sezonu podcastu. |
Przykład 1
"partOfSeason": {
"@type": "PodcastSeason",
"@id": "http://www.tjpodcast.org/seriesx/season?id=1",
"seasonNumber": 1,
"name": "Radiolab Season 1"
},
Organizacja, osoba (autor lub wydawca)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość Organization lub Person . |
@id |
Wymagany | URL | Unikalny w skali globalnej identyfikator organizacji lub osoby w formacie URI. Identyfikator musi być stały i nie może się zmieniać w czasie. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. |
name |
Wymagany | Tekst | Nazwa organizacji lub osoby. |
sameAs |
Opcjonalny | URL | Adres URL strony internetowej innej firmy (nienależącej do Twojej domeny), która jednoznacznie identyfikuje produkt. Google używa tej strony na potrzeby ujednoznacznienia, jeśli istnieje wiele podobnych serii. Może to być np. strona organizacji w Wikipedii lub jej oficjalna witryna. |
Przykład 1
"author": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
Przykład 2
"author": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/jad_abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
"name": "Jad Abumrad"
},
Użytkownik, który wykonał czynność (gospodarz lub gość)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość Organization lub Person . |
@id |
Wymagany | URL | Unikalny w skali globalnej identyfikator organizacji lub osoby w formacie URI. Identyfikator musi być stały i nie może się zmieniać w czasie. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. |
name |
Wymagany | Tekst | Nazwa organizacji lub osoby. |
roleName |
Wymagany | Tekst | „Host” lub „Gość”. |
sameAs |
Opcjonalny | URL | Adres URL strony internetowej innej firmy (nienależącej do Twojej domeny), która jednoznacznie identyfikuje produkt. Google używa tej strony na potrzeby ujednoznacznienia, jeśli istnieje wiele podobnych serii. Może to być np. strona organizacji w Wikipedii lub jej oficjalna witryna. |
Przykład 1
"actor":[{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language":"en",
"@value": "Roman Mars"
},
"roleName": "Host"
"sameAs": "https://en.wikipedia.org/wiki/Roman",
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name":{
"@language":"en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
},
}]
ImageObject (logo lub obraz)
ImageObject
jest potrzebny jako logo lub grafika do treści.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość ImageObject . |
height |
Opcjonalny | Liczba całkowita | Wysokość obrazu w pikselach. |
width |
Opcjonalny | Liczba całkowita | Szerokość obrazu w pikselach. |
contentUrl |
Wymagany | URL | Adres URL, pod którym może znajdować się obraz. |
regionsAllowed |
Opcjonalny | Kraj powtórzone |
Kraje, w których można używać multimediów:
|
Kraj (image.regionsAllowed)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiona na Country. |
name |
Wymagany | Tekst | Kod kraju w formacie ISO 3166-1 alfa-2. na przykład GB , US . |
Przykład 1
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/67890.jpg",
},
Przykład 2
"logo": [
{
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/67890.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.foo.com/img/12345.jpg",
"regionsAllowed": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "PK"
}
]
},
],
Element PropertyValue (identifier)
Jeśli masz identyfikatory GUID swoich treści, możesz w tym polu podać identifier
, by zwiększyć dokładność uzgodnienia Twoich treści. Pamiętaj, że w przypadku konta PodcastEpisode
wymagany jest identyfikator GUID.
Ta wartość musi się różnić od pola @id
odcinka (nie w Twojej domenie) i musi reprezentować go globalnie oraz w unikalny sposób z upływem czasu niezależnie od źródła.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość „PropertyValue”. |
propertyID |
Wymagany | Tekst | Zawsze ustawiana jest wartość GUID . |
value |
Wymagany | Tekst | Identyfikator GUID serii lub odcinka. |
Przykład 1
"identifier": {
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},
Parametr(lub)popularność(wynik)
popularityScore
może pomóc użytkownikom w wyświetlaniu najodpowiedniejszych treści w sytuacjach, gdy kryteria zapytania użytkownika pasują do wielu elementów z kanału. Treści z najwyższym wynikiem popularności dostępne w regionie użytkownika są wyświetlane, gdy ta wartość jest dostępna. W przypadku wszystkich treści bez tego pola domyślnie ustawiany jest wynik popularności 0
. Porównywanie wyników odbywa się w obrębie całego katalogu, więc upewnij się, że skala jest taka sama we wszystkich plikach danych.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość PopularityScoreSpecification . |
value |
Wymagany | Wartość liczbowa | Dodatnia wartość liczbowa do porównania z innymi elementami z Twojego katalogu pod kątem priorytetu wyświetlania. Większa liczba oznacza większą popularność. |
eligibleRegion |
Opcjonalny | Kraj lub tekst powtórzone |
Jeden region lub lista regionów, do których ma zastosowanie ten wynik popularności. Jeśli wynik popularności jest stosowany na całym świecie, jako wartości tekstowej użyj Jeśli chcesz uwzględnić konkretne regiony, użyj typu „Kraj”. Jeśli pozostawisz to pole wyłączone, |
Kraj (popularityScore.EligibleRegion)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość Country . |
name |
Wymagany | Tekst | Kod kraju w formacie ISO 3166-1 alfa-2. na przykład GB , US . |
Przykład 1
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.3,
"eligibleRegion": "Earth"
},
Przykład 2
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 2,
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
},
Przykład 3
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 101,
"eligibleRegion": [
{
"@type": "Country",
"name": "US"
},
{
"@type": "Country",
"name": "GB"
}
]
},
PublicationEvent, FeatureEvent, WyłączEvent (releasedEvent)
- Zdarzenie publikacji
- Ten obiekt reprezentuje datę i miejsce publikacji programu lub odcinka (nazywanego też „datą premiery” serii lub odcinka).
Pole
publishedBy
oznacza też publikację lub dystrybucję elementu serii lub odcinków podcastu. - Zdarzenie niepowtarzalne
- Użyj tego obiektu, aby wskazać, że usługodawca ma wyłączne prawa do dystrybucji podcastu. Wyłączność zależy od regionu i jest ograniczona czasowo. Musi zawierać pole organizacji wskazujące ekskluzywnego dostawcę treści.
- Polecane wydarzenie
- Użyj tego obiektu, aby wskazać, że usługodawca poleca podcast klientom (na przykład jako oryginał).
- Oryginalne treści różnią się od tych na wyłączność
- Termin „oryginalne (polecane)” często oznacza wyłączne prawa do danego podmiotu, co przeciąża jego termin. W związku z tym znaczenie należy podzielić na dwie kategorie wymienione powyżej. Pierwotna encja może być także wyjątkowa – w tym przypadku
releasedEvent
może pobierać tablicę z oboma typami zdarzeń związanymi z tym samym elementem.
Wyłączność lub wyróżnianie treści może mieć podobne znaczenie w katalogu dostawcy, ale zasada PublicationEvent
jest bardziej przydatna w przypadku ujednoznacznienia jednostek i dostarczania dodatkowych metadanych dotyczących tego samego materiału, takich jak data premiery serii lub odcinka.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiaj jedną z tych wartości: PublicationEvent , ExclusiveEvent lub FeaturedEvent . |
location |
Wymagany | Kraj | Region, w którym wystąpiło zdarzenie publikacji. Możesz też użyć tego atrybutu, aby uwzględnić ograniczenia dotyczące wyłączności i dystrybucji danej jednostki. Użyj kodów ISO 3166 dla danego kraju. Jeśli chcesz zastosować semantykę globalną, ustaw wartość EARTH . Jawnie ustaw wartość location na EARTH , na wypadek, gdyby ograniczenia lokalne nie były stosowane. |
startDate |
Zalecane (wymagane w przypadku niepowtarzalnych zdarzeń) | Data lub data i godzina | Data rozpoczęcia publikacji elementów. W przypadku obiektu PublicationEvent oznacza początkową datę wydania tej encji. W przypadku znaczników ExclusiveEvent lub FeaturedEvent jest to data rozpoczęcia wyłączności lub funkcji jednostki. |
endDate |
Zalecane (wymagane w przypadku niepowtarzalnych zdarzeń) | Data lub data i godzina | Data zakończenia publikacji elementów. W przypadku obiektu PublicationEvent oznacza ostateczną datę publikacji tego elementu. W przypadku znaczników ExclusiveEvent lub FeaturedEvent jest to data zakończenia wyłączności lub funkcji jednostki. |
publishedBy |
Wymagany | Organizacja lub osoba | Element Organization lub Person , który publikuje tę jednostkę i ma zastosowanie do tego zdarzenia publikacji. Użyj tego samego schematu co opisano w sekcji Organizacja (autor/wydawca). |
Przykład 1
"releasedEvent": [ {
"@type": "PublicationEvent",
"location": "EARTH",
"startDate": "2016-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/wnyc",
"sameAs": "https://en.wikipedia.org/wiki/WNYC",
"name": "WNYC"
},
}, {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
},
]
Przykład 2
"releasedEvent": [ {
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}, {
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast",
},
}
]
AudioObject (relateddMedia)
AudioObject
jest używany do przesyłania nieprzetworzonego pliku multimedialnego na potrzeby odcinka podcastu.
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość AudioObject . |
contentUrl |
Wymagany | URL | Adres URL pliku multimedialnego. |
contentSize |
Wymagany | Liczba całkowita | Rozmiar pliku multimedialnego w bajtach. |
encodingFormat |
Wymagany | Tekst | Typy mediów IANA pliku multimedialnego. na przykład audio/mpeg . |
duration |
Wymagany | Czas trwania | Długość multimediów w formacie ISO 8601. |
transcript |
Opcjonalny | Tekst | Transkrypcja odcinka. |
bitrate |
Opcjonalny | Tekst | Szybkość transmisji pliku multimedialnego. |
name |
Opcjonalny | Tekst | Nazwa pliku multimedialnego. |
Przykład 1
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT5M32S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"name": "radiolab_podcast19.mp3",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
ListenAction (potentialAction)
Element ListenAction
określa precyzyjne linki do odtwarzania oraz kryteria dostępu użytkowników do treści (np. stan geograficzny, niestandardowy, stan subskrypcji lub subskrypcji).
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość ListenAction . |
target |
Wymagany |
powtórzone |
Specyfikacja precyzyjnego linku z informacjami o obsługiwanej platformie. Aby zdefiniować różne precyzyjne linki dla różnych zestawów platform, możesz użyć wielu pól EntryPoint . |
actionAccessibilityRequirement |
Wymagany |
powtórzone |
Definicja wymagań, jakie musi spełnić użytkownik, by mieć dostęp do tego elementu. Jeśli istnieje wiele elementów ActionAccessSpecification , użytkownik, który spełnia kryteria specyfikacji, ma dostęp do treści. |
Punkt wejścia (potentialAction.target)
@type
Wymagany
Tekst
Zawsze ustawiany na EntryPoint
.
urlTemplate
Wymagany adres URL używany do inicjowania odtwarzania Twoich treści.
actionPlatform
Wymagane
Tekst
powtórzone
Platforma, do której należy link precyzyjny. Oto dostępne wartości:
"http://schema.org/DesktopWebPlatform"
"http://schema.org/MobileWebPlatform"
"http://schema.org/AndroidPlatform"
"http://schema.org/AndroidTVPlatform"
"http://schema.org/IOSPlatform"
"http://schema.googleapis.com/GoogleAudioCast"
"http://schema.googleapis.com/GoogleVideoCast"
ActionAccessSpecification (potentialAction.actionAccessibilityRequirement)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość ActionAccessSpecification . |
category |
Wymagany | Tekst |
Typ wymagania dostępu. Musi to być jedna z tych wartości:
|
availabilityStarts |
Opcjonalny | Data/godzina | Godzina rozpoczęcia okresu dostępności. Za pomocą tej opcji możesz kontrolować, kiedy dokładnie te treści mogą być widoczne dla użytkowników. |
availabilityEnds |
Opcjonalny | Data/godzina | Godzina zakończenia okresu dostępności. Za pomocą tej opcji możesz kontrolować, kiedy dokładnie te treści stają się widoczne dla użytkowników. |
eligibleRegion |
Wymagany | Kraj powtórzone |
Kraj, w którym dostępna jest ta oferta. Tutaj możesz określić kraj lub region, w którym te treści muszą być dostępne. |
requiresSubscription |
Wymagany, jeśli ma zastosowanie | MediaSubscription | Pakiet subskrypcyjny wymagany do uzyskania dostępu do treści. To pole jest wymagane, jeśli Twoja usługa oferuje wiele pakietów subskrypcji. Jeśli Twoja usługa jest bezpłatna lub masz tylko jeden poziom subskrypcji, możesz pominąć to pole. |
Kraj (potentialAction.actionAccessibilityRequirement.EligibleRegion)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość Country . |
name |
Wymagany | Tekst | Kod kraju w formacie ISO 3166-1 alfa 2. |
MediaSubscription (potentialAction.actionAccessibilityRequirement.requiresSubscription)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość MediaSubscription . |
@id |
Wymagany | URL | Unikalny globalnie identyfikator pakietu subskrypcji w formacie URI. Identyfikator musi być stały i nie może się zmieniać w czasie. Jest traktowany jako nieprzejrzysty ciąg znaków i nie musi być działającym linkiem. |
name |
Wymagany | Tekst | Nazwa pakietu subskrypcji. na przykład Premium , Basic . |
expectsAcceptanceOf |
Zalecane | Oferta | Oferta powiązana z zakupem subskrypcji mediów. Możesz w nim podać cenę subskrypcji. |
Oferta (potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf)
Właściwość | Priorytet | Typ | Opis |
---|---|---|---|
@type |
Wymagany | Tekst | Zawsze ustawiana jest wartość Offer . |
price |
Wymagany | Liczba | Cena subskrypcji. |
priceCurrency |
Wymagany | Tekst | Waluta ceny (w 3-literowym formacie ISO 4217). |
seller |
Zalecane | Organizacja | Organizacja, która oferuje subskrypcję lub zakup działania. Użyj tego samego schematu co w sekcji Organizacja (autor/wydawca). |
Przykład 1
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
},
Przykład 2
"potentialAction": {
"@type": "ListenAction",
"target": [
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.org/AndroidPlatform",
"http://schema.org/AndroidTVPlatform",
"http://schema.org/IOSPlatform"
]
},
{
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/castlink?streamStationId=170",
"actionPlatform": [
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
}
],
"actionAccessibilityRequirement": [
{
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": [
{
"@type": "Country",
"name": "IN"
},
{
"@type": "Country",
"name": "GB"
}
]
},
{
"@type": "ActionAccessSpecification",
"category": "Subscription",
"requiresSubscription": {
"@type": "MediaSubscription",
"@id": "http://www.example.com/packages/basic-pack",
"name": "Basic Pack",
"expectsAcceptanceOf": {
"@type": "Offer",
"price": 8.99,
"priceCurrency": "USD"
}
},
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2018-06-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "US"
}
}
]
},
Dodatek
Pełny przykład
{
"@context": "http://schema.org",
"@type": "DataFeed",
"dateModified": "2018-09-10T13:58:26.892Z",
"dataFeedElement": [
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"url": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"description": "A two-time Peabody Award-winner...",
"alternativeHeadline": "Radiolab - Powered by WNYC",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2.jpg"
},
"logo": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
},
"keywords": [
"Science",
"Technology",
"Philosophy",
"Education"
],
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"inLanguage": "en",
"genre": [
"Science & Medicine",
"Natural Sciences"
],
"endDate": "2017-12-22T08:59:00",
"rssFeed": "http://feeds.wnyc.org/radiolab",
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 4.2
}
},
{
"@context": [
"http://schema.googleapis.com",
{
"@language": "en"
}
],
"@type": "PodcastEpisode",
"@id": "http://www.tjpodcast.org/episode?id=1",
"url": "http://www.tjpodcast.org/episode?id=1",
"name": "A Clockwork Miracle",
"description": "As legend goes, in 1562, King Philip II...",
"sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
"image": {
"@type": "ImageObject",
"height": "100",
"width": "800",
"contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
},
"keywords": [
"Education",
"Philosophy",
"Science",
],
"partOfSeries": {
"@type": "PodcastSeries",
"@id": "http://www.tjpodcast.org/series?id=2",
"name": "Radiolab",
"sameAs": "https://en.wikipedia.org/wiki/Radiolab",
},
"episodeNumber": 101,
"inLanguage": "en",
"author": [
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/jad_abumrad",
"name": "Jad Abumrad",
"sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
},
{
"@type": "Person",
"@id": "https://www.tjpodcast.org/author/robert_krulwich",
"name": "Robert Krulwich",
"sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
}
],
"publisher": {
"@type": "Organization",
"name": "WNYC",
"@id": "https://www.tjpodcast.org/network/wnyc_studios",
"sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
},
"isFamilyFriendly": "True",
"genre": [
"Science",
"Philosophy",
"Fiction"
],
"datePublished": "2018-12-27T23:23:00Z",
"timeRequired": "PT22M",
"associatedMedia": {
"@type": "AudioObject",
"contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
"duration": "PT21M45S",
"contentSize": "53616000",
"encodingFormat": "audio/mpeg",
"transcript": "Transcript of the episode",
"bitrate": "64Kbps"
},
"potentialAction": {
"@type": "ListenAction",
"target": {
"@type": "EntryPoint",
"urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
"actionPlatform": [
"http://schema.org/DesktopWebPlatform",
"http://schema.org/MobileWebPlatform",
"http://schema.googleapis.com/GoogleAudioCast",
"http://schema.googleapis.com/GoogleVideoCast"
]
},
"actionAccessibilityRequirement": {
"@type": "ActionAccessSpecification",
"category": "nologinrequired",
"availabilityStarts": "2018-04-01T11:01:00-04:00",
"availabilityEnds": "2019-12-30T23:59:00-04:00",
"eligibleRegion": {
"@type": "Country",
"name": "FR"
}
}
},
"popularityScore": {
"@type": "PopularityScoreSpecification",
"value": 3.8
},
"identifier": [
{
"@type": "PropertyValue",
"propertyID": "GUID",
"value": "53ff386e-e768-40b5-8854-1b7415826ded"
}
]
}
],
"actor": [
{
"@type": "PerformanceRole",
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/Roman",
"name": {
"@language": "en",
"@value": "Roman Mars"
},
"roleName": "Host",
"sameAs": "https://en.wikipedia.org/wiki/Roman"
},
"actor": {
"@type": "Person",
"@id": "https://www.tjpodcast.org/person/guest",
"name": {
"@language": "en",
"@value": "Kurt Kohlstedt"
},
"roleName": "Guest"
}
}
],
"releasedEvent": [
{
"@type": "FeaturedEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-05-21T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "US",
"startDate": "2020-04-18T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
},
{
"@type": "ExclusiveEvent",
"location": "CA",
"startDate": "2020-04-21T20:00",
"endDate": "2020-04-24T20:00",
"publishedBy": {
"@type": "Organization",
"@id": "https://www.tjpodcast.org/organization/tjpodcast",
"sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
"name": "TJPodcast"
}
}
]
}