Cómo recopilar el ID, la URL y el nombre de tu contenido
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Todas las entidades de tu catálogo requieren las siguientes propiedades:
@id: Es un identificador global para el contenido.url: Es una URL canónica para el contenido.name: Es el nombre del contenido.
A continuación, se muestra un ejemplo de @id, url y name:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identificador
Un identificador (@id) debe cumplir con los siguientes requisitos:
- Debe ser único a nivel global en todo tu catálogo.
- Por ejemplo, no uses el mismo
@id para un TVSeries y un TVSeason.
- Estático
- No podrás cambiar
@id más adelante.
- En forma de identificador de recursos unificado (URI)
- Si el identificador (ID) local de tu contenido no está en formato URI, agrega tu dominio al ID para cumplir con este requisito. Por ejemplo, si el ID de tu contenido es 1234abc y tu dominio es https://example.com,
@id puede ser https://example.com/1234abc.
@id no tiene que ser una URL que funcione, solo debe estar en formato URI.- El dominio que se usa en
@id (por ejemplo, https://example.com) debe ser propiedad de tu organización.
Como el url de una entidad cumple con todos los requisitos como identificador (es decir, es único a nivel global, estático y tiene el formato de un URI), te recomendamos que uses el url de una entidad como @id.
URL canónica
Una URL canónica (url) ayuda a Google a conciliar con precisión el contenido de tu catálogo con el contenido de las bases de datos de Google.
"Una URL canónica es la URL de la página que Google considera como la más representativa de un conjunto de páginas duplicadas de tu sitio. Por ejemplo, si tienes varias URLs para la misma página (por ejemplo: example.com?vestido=1234 y example.com/vestidos/1234), Google seleccionará una de ellas como canónica. (Fuente: Consolida las URLs duplicadas)
Los siguientes son los requisitos para la URL canónica:
url debe ser único a nivel global.url debe contener una URL canónica que funcione y que Google pueda rastrear.- (Solo acciones de escucha)
url debe dirigir a una página de descripción del contenido que no esté bloqueada por un muro de pago.
Recopila el ID, la URL y el nombre
Puedes hacer lo siguiente:
- Recopila los nombres del contenido de tu catálogo.
- Identifica las URLs canónicas del contenido. (Te recomendamos que uses el
url del contenido como @id).
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
[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`.)"]]
