Kumpulkan ID, URL, dan nama konten Anda

Entitas konten dalam katalog Anda umumnya memerlukan properti berikut:

  • @id: ID global untuk entity.
  • url: URL kanonis untuk konten. Jangan gunakan url pada BroadcastEvent, SportsEvent, atau entitas grup channel (TelevisionChannel dan CableOrSatelliteService).
  • 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 @id yang sama untuk TVSeries dan TVSeason.
  • Statis
    • Anda tidak dapat mengubah @id nanti.
  • 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, @id dapat berupa https://example.com/1234abc.
    • @id tidak 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.

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:

  • url harus unik secara global.
  • url harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.
  • (Khusus Tindakan Dengarkan) url harus mengarah ke halaman deskripsi konten yang tidak diblokir oleh penghalang konten berbayar.
  • (TV Live) Jangan sertakan url di entitas BroadcastEvent. Untuk siaran TV dan film, berikan url pada entitas Movie, TVSeries, atau TVEpisode yang mendasarinya.
  • (Olahraga) Jangan sertakan url di entitas SportsEvent. Berikan link pemutaran menggunakan SportsEvent.potentialAction.
  • (TV Live dan Olahraga) Pastikan BroadcastEvent.@id berbeda dengan @id entitas Movie, TVSeries, TVEpisode, atau SportsEvent yang dirujuk.

Mengumpulkan ID, URL, dan nama

Lakukan hal berikut:

  1. Kumpulkan nama konten dalam katalog Anda.
  2. Identifikasi URL kanonis konten. (Sebaiknya gunakan url konten sebagai @id-nya.)