Entitas konten dalam katalog Anda umumnya memerlukan properti berikut:
@id: ID global untuk entity.url: URL kanonis untuk konten. Jangan gunakanurlpadaBroadcastEvent,SportsEvent, atau entitas grup channel (TelevisionChanneldanCableOrSatelliteService).name: Nama konten.
Contoh @id, url, dan name:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
ID
ID (@id) harus memenuhi persyaratan berikut:
- Unik secara global di seluruh katalog Anda
- Misalnya, jangan gunakan
@idyang sama untukTVSeriesdanTVSeason.
- Misalnya, jangan gunakan
- Statis
- Anda tidak dapat mengubah
@idnanti.
- Anda tidak dapat mengubah
- Dalam bentuk Unified Resource Identifier (URI)
- Jika ID lokal konten Anda tidak dalam format URI, tambahkan domain Anda ke ID untuk memenuhi persyaratan ini; misalnya, jika ID konten Anda adalah 1234abc dan domain Anda adalah https://example.com,
@iddapat berupa https://example.com/1234abc. @idtidak harus berupa URL yang berfungsi; URL hanya perlu dalam format URI.- Domain yang digunakan di
@id(misalnya, https://example.com) harus dimiliki oleh organisasi Anda.
- Jika ID lokal konten Anda tidak dalam format URI, tambahkan domain Anda ke ID untuk memenuhi persyaratan ini; misalnya, jika ID konten Anda adalah 1234abc dan domain Anda adalah https://example.com,
Karena url entitas memenuhi semua persyaratan sebagai ID (yaitu, unik secara global, statis, dan dalam bentuk URI), sebaiknya gunakan url entitas sebagai @id.
URL Kanonis
URL kanonis (url) membantu Google merekonsiliasi konten dalam katalog Anda secara akurat dengan konten dalam database Google.
"URL kanonis adalah URL halaman yang dianggap Google sebagai URL paling representatif dari sekumpulan halaman duplikat di situs Anda. Misalnya, jika Anda memiliki beberapa URL untuk halaman yang sama (misalnya: example.com?dress=1234 dan example.com/dresses/1234), Google akan memilih salah satu URL sebagai kanonis." (Sumber: Menggabungkan URL duplikat)
Berikut adalah persyaratan untuk URL kanonis:
urlharus unik secara global.urlharus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.- (Khusus Tindakan Dengarkan)
urlharus mengarah ke halaman deskripsi konten yang tidak diblokir oleh penghalang konten berbayar. - (TV Live) Jangan sertakan
urldi entitasBroadcastEvent. Untuk siaran TV dan film, berikanurlpada entitasMovie,TVSeries, atauTVEpisodeyang mendasarinya. - (Olahraga) Jangan sertakan
urldi entitasSportsEvent. Berikan link pemutaran menggunakanSportsEvent.potentialAction. - (TV Live dan Olahraga) Pastikan
BroadcastEvent.@idberbeda dengan@identitasMovie,TVSeries,TVEpisode, atauSportsEventyang dirujuk.
Mengumpulkan ID, URL, dan nama
Lakukan hal berikut:
- Kumpulkan nama konten dalam katalog Anda.
- Identifikasi URL kanonis konten. (Sebaiknya gunakan
urlkonten sebagai@id-nya.)