Collecter l'ID, l'URL et le nom de votre contenu
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Toutes les entités de votre catalogue doivent inclure les propriétés suivantes:
Exemple de @id, url et name :
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identifiant
Un identifiant (@id) doit respecter les conditions suivantes:
- Unique au niveau mondial dans l'ensemble de votre catalogue
- Par exemple, n'utilisez pas le même
@id pour un TVSeries et un TVSeason.
- Statique
- Vous ne pourrez plus modifier
@id par la suite.
- Au format URI (Uniform Resource Identifier)
- Si l'identifiant local (ID) de votre contenu n'est pas au format URI, ajoutez votre domaine à l'ID pour répondre à cette exigence. Par exemple, si l'ID de votre contenu est 1234abc et que votre domaine est https://example.com,
@id peut être https://example.com/1234abc.
@id ne doit pas nécessairement être une URL fonctionnelle. Il doit simplement être au format URI.- Le domaine utilisé dans
@id (par exemple, https://example.com) doit appartenir à votre organisation.
Étant donné que l'url d'une entité répond à toutes les exigences en tant qu'identifiant (c'est-à-dire qu'il est globalement unique, statique et au format d'un URI), nous vous recommandons d'utiliser l'url d'une entité comme @id.
URL canonique
Une URL canonique (url) permet à Google de faire le rapprochement entre le contenu de votre catalogue et celui de ses bases de données.
"Une URL canonique est l'URL de la page considérée par Google comme la plus représentative de l'ensemble de pages en double sur votre site. Par exemple, si vous avez plusieurs URL pour une même page (par exemple, example.com?dress=1234 et example.com/dresses/1234), Google en choisit une comme URL canonique." (Source: Consolider les URL en double)
Voici les conditions requises pour l'URL canonique:
url doit être unique.url doit contenir une URL canonique fonctionnelle que Google peut explorer.- (Actions d'écoute uniquement)
url doit rediriger vers une page de description de contenu qui n'est pas bloquée par un mur payant.
Collecter l'ID, l'URL et le nom
Procédez comme suit :
- Récupérez les noms des contenus de votre catalogue.
- Identifiez les URL canoniques du contenu. (Nous vous recommandons d'utiliser le
url du contenu comme @id.)
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
[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`.)"]]
