Соберите идентификатор, URL-адрес и название вашего контента.
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Всем объектам в вашем каталоге требуются следующие свойства:
Пример @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 ), должен принадлежать вашей организации.
Поскольку 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
.)
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
[null,null,[],[[["\u003cp\u003eAll catalog entities must have an \u003ccode\u003e@id\u003c/code\u003e, \u003ccode\u003eurl\u003c/code\u003e, and \u003ccode\u003ename\u003c/code\u003e property for identification and discoverability.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003e@id\u003c/code\u003e should be a globally unique, static URI, preferably the same as the \u003ccode\u003eurl\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eurl\u003c/code\u003e must be a working canonical URL for Google to crawl and reconcile content effectively, pointing to a public content description page for Listen Actions.\u003c/p\u003e\n"],["\u003cp\u003eYou need to collect and provide the \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003eurl\u003c/code\u003e (recommended for \u003ccode\u003e@id\u003c/code\u003e), and canonical \u003ccode\u003eurl\u003c/code\u003e for each entity in your catalog.\u003c/p\u003e\n"]]],["Entities require `@id`, `url`, and `name` properties. `@id` must be a globally unique, static URI, which can be a prepended domain to a local ID. `url` must be a globally unique, working canonical URL, crawlable by Google. It's recommended to use the `url` as the `@id` because it satisfies the identifier requirements. The process involves collecting content names and identifying their canonical URLs.\n"],null,["# Collect the ID, URL, and name of your content\n\nAll the entities in your catalog require the following properties:\n\n- `@id`: A global [identifier](#identifier) for the content.\n- `url`: A [canonical URL](#canonical_url) for the content.\n- `name`: The name of the content.\n\nExample of `@id`, `url`, and `name`: \n\n \"@id\": \"http://www.example.com/episode/video/432432432\",\n \"url\": \"http://www.example.com/episode/video/432432432\",\n \"name\": \"My example episode\",\n\nIdentifier\n----------\n\nAn identifier (`@id`) must meet the following requirements:\n\n- Globally unique across your catalog\n - For instance, don't use the same `@id` for a `TVSeries` and a `TVSeason`.\n- Static\n - You cannot change `@id` later.\n- In the form of Unified Resource Identifier (URI)\n - If your content's local identifier (ID) is not in a URI format, prepend your domain to the ID to satisfy this requirement; for example, if your content's ID is *1234abc* and your domain is *https://example.com* , `@id` can be *https://example.com/1234abc.*\n - `@id` does not have to be a working URL; it only needs to be in a URI format.\n - The domain used in `@id` (for example, *https://example.com*) must be owned by your organization.\n\nBecause an entity's `url` meets all the requirements as an identifier (that is, globally unique, static, and in the form of a URI), we recommend you use an entity's `url` as `@id`.\n\nCanonical URL\n-------------\n\nA canonical URL (`url`) helps Google accurately reconcile the content in your catalog with the content in Google's databases.\n\n\"A canonical URL is the URL of the page that Google thinks is most representative from a set of duplicate pages on your site. For example, if you have URLs for the same page (for example: *example.com?dress=1234* and *example.com/dresses/1234* ), Google chooses one as canonical.\" (Source: [Consolidate duplicate URLs](https://support.google.com/webmasters/answer/139066))\n\nThe following are the requirements for the canonical URL:\n\n- `url` must be globally unique.\n- `url` must contain a working canonical URL that Google can crawl.\n- (Listen Actions only) `url` needs to point to a content description page that is not blocked by a paywall.\n\nCollect the ID, URL, and name\n-----------------------------\n\nDo the following:\n\n1. Gather the names of the content in your catalog.\n2. Identify the canonical URLs of the content. (We recommend you use the content's `url` as its `@id`.)"]]