Wszystkie elementy w katalogu wymagają tych właściwości:
@id
: globalny identyfikator treści.url
: kanoniczny adres URL treści.name
: nazwa treści.
Przykłady właściwości @id
, url
i name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identyfikator
Identyfikator (@id
) musi spełniać te wymagania:
- Produkt unikalny w całym katalogu
- Nie używaj na przykład tego samego atrybutu
@id
w atrybutachTVSeries
iTVSeason
.
- Nie używaj na przykład tego samego atrybutu
- Statyczna
@id
nie możesz później zmienić.
- W formacie URI (Unified Resource Identifier)
- Jeśli lokalny identyfikator Twoich treści nie ma formatu URI, to aby spełnić to wymaganie, dołącz do identyfikatora swoją domenę na początku. Jeśli na przykład identyfikator treści to 1234abc, a domena to https://example.com,
@id
może mieć postać https://example.com/1234abc. @id
nie musi być działającym adresem URL. musi być w formacie URI.- Domena użyta w domenie
@id
(na przykład https://example.com) musi należeć do Twojej organizacji.
- Jeśli lokalny identyfikator Twoich treści nie ma formatu URI, to aby spełnić to wymaganie, dołącz do identyfikatora swoją domenę na początku. Jeśli na przykład identyfikator treści to 1234abc, a domena to https://example.com,
Parametr url
elementu spełnia wszystkie wymagania dotyczące identyfikatora (czyli jest on unikalny globalnie, statyczny i ma postać identyfikatora URI), dlatego zalecamy użycie właściwości url
elementu jako @id
.
Kanoniczny URL
Kanoniczny URL (url
) pomaga Google dokładnie uzgodnić zawartość Twojego katalogu z zawartością w bazach danych Google.
„Kanoniczny URL to adres strony, którą Google uznaje za najbardziej reprezentatywną spośród zbioru duplikatów stron w Twojej witrynie. Jeśli masz na przykład adresy URL tej samej strony (np. example.com?dress=1234 i example.com?dress=1234), Google wybiera jeden z nich jako kanoniczny”. (źródło: Konsolidacja zduplikowanych adresów URL)
Oto wymagania dotyczące kanonicznego adresu URL:
- Pole
url
musi być unikalne globalnie. - Plik
url
musi zawierać działający kanoniczny URL, który Google może zindeksować. - (Tylko funkcje Listen Actions)
url
musi wskazywać stronę z opisem treści, która nie jest blokowana przez paywall.
Uzyskaj identyfikator, adres URL i nazwę
Wykonaj te czynności:
- Zbierz nazwy treści z katalogu.
- Wskaż kanoniczne adresy URL treści. (Zalecamy użycie atrybutu
url
treści jako elementu@id
).