Kumpulkan ID, URL, dan nama konten Anda
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Semua entitas dalam katalog Anda memerlukan properti berikut:
@id
: ID global untuk konten.
url
: URL kanonis untuk konten.
name
: Nama konten.
Contoh @id
, url
, dan name
:
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
ID
ID (@id
) harus memenuhi persyaratan berikut:
- Unik secara global di seluruh katalog Anda
- Misalnya, jangan gunakan
@id
yang sama untuk TVSeries
dan TVSeason
.
- Statis
- Anda tidak dapat mengubah
@id
nanti.
- Dalam bentuk Unified Resource Identifier (URI)
- Jika ID lokal (ID) konten Anda tidak dalam format URI, tambahkan domain Anda ke ID untuk memenuhi persyaratan ini; misalnya, jika ID konten Anda adalah 1234abc dan domain Anda adalah https://example.com,
@id
dapat berupa https://example.com/1234abc.
@id
tidak harus berupa URL yang berfungsi; hanya perlu dalam format URI.
- Domain yang digunakan di
@id
(misalnya, https://example.com) harus dimiliki oleh organisasi Anda.
Karena url
entitas memenuhi semua persyaratan sebagai ID (yaitu, unik secara global, statis, dan dalam bentuk URI), sebaiknya gunakan url
entitas sebagai @id
.
URL Kanonis
URL kanonis (url
) membantu Google merekonsiliasi konten di katalog Anda dengan konten di database Google secara akurat.
"URL kanonis adalah URL halaman yang dianggap Google sebagai URL paling representatif dari sekumpulan halaman duplikat di situs Anda. Misalnya, jika Anda memiliki URL untuk halaman yang sama (misalnya: example.com?dress=1234 dan example.com/dresses/1234), Google akan memilih salah satu URL sebagai kanonis." (Sumber: Mengonsolidasikan URL duplikat)
Berikut adalah persyaratan untuk URL kanonis:
url
harus unik secara global.
url
harus berisi URL kanonis yang berfungsi dan dapat di-crawl oleh Google.
- (Khusus Tindakan Mendengarkan)
url
harus mengarah ke halaman deskripsi konten yang tidak diblokir oleh paywall.
Mengumpulkan ID, URL, dan nama
Lakukan hal berikut:
- Kumpulkan nama konten di katalog Anda.
- Identifikasi URL kanonis konten. (Sebaiknya gunakan
url
konten sebagai @id
-nya.)
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
[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`.)"]]