Colete o ID, o URL e o nome do seu conteúdo
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Todas as entidades no seu catálogo exigem as seguintes propriedades:
Exemplo de @id, url e name:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identificador
Um identificador (@id) precisa atender aos seguintes requisitos:
- Exclusivo globalmente no seu catálogo
- Por exemplo, não use o mesmo
@id para um TVSeries e um TVSeason.
- Estáticas
- Não é possível mudar
@id depois.
- No formato de identificador uniforme de recursos (URI, na sigla em inglês)
- Se o identificador local (ID) do conteúdo não estiver em um formato de URI, adicione o domínio ao ID para atender a esse requisito. Por exemplo, se o ID do conteúdo for 1234abc e o domínio for https://example.com,
@id pode ser https://example.com/1234abc.
- O
@id não precisa ser um URL funcional. Ele só precisa estar em um formato de URI.
- O domínio usado em
@id (por exemplo, https://example.com) precisa ser de propriedade da sua organização.
Como o url de uma entidade atende a todos os requisitos como um identificador (ou seja, globalmente exclusivo, estático e na forma de um URI), recomendamos que você use o url de uma entidade como @id.
URL canônico
Um URL canônico (url) ajuda o Google a reconciliar com precisão o conteúdo do seu catálogo com o conteúdo dos bancos de dados do Google.
"Um URL canônico é o URL da página que o Google considera a mais representativa de um conjunto de páginas duplicadas no seu site. Por exemplo, se você tiver URLs para a mesma página (por exemplo, example.com?dress=1234 e example.com/dresses/1234), o Google vai escolher um como canônico." (Fonte: Consolidar URLs duplicados)
Confira a seguir os requisitos para o URL canônico:
- O
url precisa ser globalmente exclusivo.
- O
url precisa conter um URL canônico que funcione e que o Google possa rastrear.
- (Apenas ações de ouvir)
url precisa apontar para uma página de descrição de conteúdo que não esteja bloqueada por um paywall.
Coletar o ID, o URL e o nome
Faça o seguinte:
- Colete os nomes do conteúdo do seu catálogo.
- Identifique os URLs canônicos do conteúdo. Recomendamos que você use o
url do conteúdo como @id.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
[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`.)"]]
