Соберите идентификаторы, URL и названия вашего контента

Для объектов контента в каталоге обычно требуются следующие свойства:

  • @id – глобальный идентификатор объекта.
  • url – канонический URL контента. Не используйте свойство url для объектов BroadcastEvent, SportsEvent и объектов, связанных с телепрограммой (TelevisionChannel и CableOrSatelliteService).
  • name – название контента.

Пример для @id, url и name:

"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",

Идентификатор

Идентификатор (@id) должен отвечать следующим требованиям:

  • Уникальный идентификатор в каталоге.
    • Например, не используйте один и тот же идентификатор @id для объектов TVSeries и TVSeason.
  • Статическое
    • Вы не сможете изменить @id позже.
  • В виде унифицированного идентификатора ресурса (URI).
    • Если локальный идентификатор вашего контента не имеет формата URI, добавьте перед ним домен, чтобы выполнить это требование. Например, если идентификатор контента – 1234abc, а домен – https://example.com, то в качестве @id можно указать https://example.com/1234abc.
    • @id не обязательно должен быть рабочим URL, достаточно, чтобы он был в формате URI.
    • Домен, указанный в идентификаторе @id (например, https://example.com), должен принадлежать вашей организации.

Поскольку свойство url объекта соответствует всем требованиям к идентификатору (то есть является глобально уникальным, статическим и имеет формат URI), мы рекомендуем использовать свойство url объекта в качестве @id.

Канонический URL

Канонический URL (url) помогает Google точно сопоставить контент в каталоге с контентом в базах данных Google.

Каноническим называется URL страницы, которую роботы Google считают главной среди нескольких ее вариантов на вашем сайте. Например, если одна и та же страница размещена по двум URL, таким как example.com?dress=1234 и example.com/dresses/1234, один из них будет выбран Google в качестве канонического. (Источник: Консолидация повторяющихся URL)

Канонический URL должен соответствовать следующим требованиям:

  • url должен быть уникальным.
  • url должен содержать работающий канонический URL, который Google может просканировать.
  • (Только для действий прослушивания.) Свойство url должно указывать на страницу с описанием контента, которая не заблокирована платным доступом.
  • (Онлайн-телевидение) Не добавляйте объекты url в BroadcastEvent. Для теле- и кинотрансляций укажите свойство url в базовом объекте Movie, TVSeries или TVEpisode.
  • (Спорт) Не добавляйте свойство url в объекты SportsEvent. Укажите ссылки на воспроизведение с помощью свойства SportsEvent.potentialAction.
  • (Онлайн-телевидение и спорт) Убедитесь, что свойство BroadcastEvent.@id отличается от свойства @id объекта Movie, TVSeries, TVEpisode или SportsEvent, на который указывает ссылка.

Сбор идентификатора, URL и названия

Выполните следующие действия:

  1. Соберите названия контента в вашем каталоге.
  2. Определите канонические URL контента. Рекомендуем использовать url контента в качестве @id.