شناسه، URL و نام محتوای خود را جمع آوری کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
همه موجودیت های موجود در کاتالوگ شما به ویژگی های زیر نیاز دارند:
-
@id : یک شناسه جهانی برای محتوا. -
url : یک URL متعارف برای محتوا. -
name : نام محتوا.
مثالی از @id ، url و name :
"@id": "http://www.example.com/episode/video/432432432",
"url": "http://www.example.com/episode/video/432432432",
"name": "My example episode",
شناسه
یک شناسه ( @id ) باید شرایط زیر را داشته باشد:
- در سراسر کاتالوگ شما منحصر به فرد است
- به عنوان مثال، از همان
@id برای TVSeries و TVSeason استفاده نکنید.
- استاتیک
- بعداً نمی توانید
@id تغییر دهید.
- در قالب شناسه منبع یکپارچه (URI)
- اگر شناسه محلی محتوای شما (ID) در قالب URI نیست، دامنه خود را به شناسه اضافه کنید تا این نیاز را برآورده کند. برای مثال، اگر شناسه محتوای شما 1234abc و دامنه شما https://example.com باشد،
@id می تواند https://example.com/1234abc باشد. -
@id نباید یک URL کارآمد باشد. فقط باید در قالب URI باشد. - دامنه استفاده شده در
@id (به عنوان مثال https://example.com ) باید متعلق به سازمان شما باشد.
از آنجایی که url موجودیت همه الزامات را به عنوان یک شناسه برآورده می کند (یعنی در سطح جهانی منحصر به فرد، ایستا و به شکل URI)، توصیه می کنیم url یک موجودیت به عنوان @id استفاده کنید.
URL متعارف
یک URL متعارف ( url ) به Google کمک می کند تا محتوای موجود در کاتالوگ شما را با محتوای موجود در پایگاه داده Google به طور دقیق تطبیق دهد.
"URL canonical URL صفحه‌ای است که گوگل فکر می‌کند از مجموعه‌ای از صفحات تکراری در سایت شما نشان‌دهنده‌ترین نشان‌دهنده است. به عنوان مثال، اگر URLهایی برای همان صفحه دارید (به عنوان مثال: example.com?dress=1234 و example.com/dresses/1234 )، گوگل یکی را به عنوان متعارف انتخاب می‌کند." (منبع: ادغام URL های تکراری )
شرایط زیر برای URL متعارف است:
-
url باید در سطح جهانی منحصر به فرد باشد. -
url باید حاوی یک URL معمولی باشد که Google بتواند آن را بخزد. -
url (فقط Listen Actions) باید به صفحه توضیحات محتوا اشاره کند که توسط دیوار پرداخت مسدود نشده است.
شناسه، URL و نام را جمع آوری کنید
موارد زیر را انجام دهید:
- نام مطالب را در کاتالوگ خود جمع آوری کنید.
- URL های متعارف محتوا را شناسایی کنید. (توصیه می کنیم از
url محتوا به عنوان @id آن استفاده کنید.)
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
[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`.)"]]
