Всем объектам в вашем каталоге требуются следующие свойства:
-
@id
: глобальный идентификатор контента. -
url
: канонический URL-адрес содержимого. -
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).
- Если локальный идентификатор (ID) вашего контента не имеет формата URI, добавьте к идентификатору свой домен, чтобы удовлетворить этому требованию; например, если идентификатор вашего контента — 1234abc , а ваш домен — https://example.com ,
@id
может быть https://example.com/1234abc. -
@id
не обязательно должен быть рабочим URL-адресом; он должен быть только в формате URI. - Домен, используемый в
@id
(например, https://example.com ), должен принадлежать вашей организации.
- Если локальный идентификатор (ID) вашего контента не имеет формата URI, добавьте к идентификатору свой домен, чтобы удовлетворить этому требованию; например, если идентификатор вашего контента — 1234abc , а ваш домен — https://example.com ,
Поскольку url
объекта соответствует всем требованиям в качестве идентификатора (то есть является глобально уникальным, статическим и имеет форму URI), мы рекомендуем использовать url
объекта как @id
.
Канонический URL-адрес
Канонический URL-адрес ( url
) помогает Google точно согласовать контент вашего каталога с контентом в базах данных Google.
«Канонический URL-адрес — это URL-адрес страницы, которая, по мнению Google, является наиболее репрезентативной из набора повторяющихся страниц вашего сайта. Например, если у вас есть URL-адреса одной и той же страницы (например: example.com?dress=1234 и example. .com/dresses/1234 ), Google выбирает одно из них как каноническое». (Источник: объединить повторяющиеся URL-адреса )
Ниже приведены требования к каноническому URL-адресу:
-
url
должен быть глобально уникальным. -
url
должен содержать работающий канонический URL-адрес, который может сканировать Google. - (Только для действий прослушивания)
url
должен указывать на страницу описания контента, которая не заблокирована платным доступом.
Соберите идентификатор, URL-адрес и имя.
Сделайте следующее:
- Соберите названия контента в вашем каталоге.
- Определите канонические URL-адреса контента. (Мы рекомендуем использовать
url
контента в качестве@id
.)