Uzyskaj identyfikator, adres URL i nazwę swoich treści
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Wszystkie elementy w katalogu wymagają tych właściwości:
Przykłady znaczników @id, url i name:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
Identyfikator
Identyfikator (@id) musi spełniać te wymagania:
- Musi być unikalny na całym świecie w katalogu.
- Nie używaj na przykład tego samego atrybutu
@id w przypadku atrybutów TVSeries i TVSeason.
- Statyczny
- Nie możesz później zmienić
@id.
- W formie ujednoliconego identyfikatora zasobu (URI)
- Jeśli lokalny identyfikator (identyfikator) treści nie jest w formacie URI, przed identyfikatorem należy umieścić domenę, aby spełnić ten wymóg. Na przykład, jeśli identyfikator treści to 1234abc, a domena to https://example.com,
@id może być https://example.com/1234abc.
@id nie musi być działającym adresem URL; musi mieć tylko format URI.- Domena użyta w wartości
@id (np. https://example.com) musi należeć do Twojej organizacji.
Identyfikator url spełnia wszystkie wymagania dotyczące identyfikatorów (czyli jest niepowtarzalny na całym świecie, statyczny i ma postać identyfikatora URI), dlatego zalecamy użycie url jako @id.
Kanoniczny URL
Kanoniczny URL (url) pomaga Google dokładnie uzgodnić zawartość Twojego katalogu z zawartością baz danych Google.
„Kanoniczny URL to adres strony, którą Google uznaje za najbardziej reprezentatywną spośród zbioru duplikatów stron w Twojej witrynie. Jeśli masz na przykład kilka adresów URL tej samej strony (załóżmy example.com?dress=1234 i example.com/dresses/1234), Google wybiera 1 z nich jako kanoniczny. (źródło: skonsolidować duplikaty adresów URL)
Wymagania dotyczące kanonicznego adresu URL:
url musi być globalnie niepowtarzalny.url musi zawierać działający kanoniczny adres URL, który Google może zindeksować.- (dotyczy tylko akcji związanych z słuchaniem)
url musi wskazywać stronę z opisem treści, która nie jest zablokowana przez paywall.
Zbieranie identyfikatora, adresu URL i nazwy
Wykonaj te czynności:
- Zbierz nazwy treści w katalogu.
- Określ kanoniczne adresy URL treści. (zalecamy użycie
url jako @id).
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
[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`.)"]]
