جمع رقم تعريف المحتوى وعنوان URL الخاص به واسمه
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تتطلّب جميع الكيانات في الكتالوج السمات التالية:
مثال على @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)
- إذا لم يكن المعرّف المحلي (المعرّف) للمحتوى بتنسيق معرّف الموارد المنتظم (URI)، يمكنك إضافة نطاقك إلى المعرّف لاستيفاء هذا الشرط. على سبيل المثال، إذا كان المعرّف الخاص بالمحتوى هو 1234abc وكان نطاقك هو https://example.com، يمكن أن يكون
@id هو https://example.com/1234abc.
- ولا يُشترط أن يكون
@id عنوان URL صالحًا، بل يجب أن يكون بتنسيق معرّف موارد منتظم فقط.
- يجب أن يكون النطاق المستخدَم في
@id (على سبيل المثال، https://example.com) مملوكًا لمؤسستك.
بما أنّ url الخاص بالكيان يستوفي جميع المتطلبات كمعرّف (أي أنّه فريد عالميًا وثابت ويكون في شكل عنوان URL)، ننصحك باستخدام url الخاص بالكيان كـ @id.
عنوان URL الأساسي
يساعد عنوان URL الأساسي (url) محرّك بحث Google في التوفيق بدقة بين المحتوى في قائمتك والمحتوى في قواعد بيانات Google.
"عنوان URL الأساسي هو عنوان URL للصفحة التي يرى محرّك بحث Google أنّها الأكثر تمثيلاً من بين مجموعة من الصفحات المكرّرة على موقعك الإلكتروني. على سبيل المثال، إذا كان لديك عناوين URL للصفحة نفسها (مثل: example.com?dress=1234 وexample.com/dresses/1234)، سيختار محرّك بحث Google عنوان URL واحدًا فقط بصفته أساسيًا. (المصدر: دمج عناوين URL المكرّرة)
في ما يلي متطلبات عنوان URL الأساسي:
- يجب أن يكون
url فريدًا على مستوى العالم.
- يجب أن يحتوي
url على عنوان URL أساسي صالح يمكن لمحرّك بحث Google الزحف إليه.
- (إجراءات الاستماع فقط) يجب أن يشير العنصر
url إلى صفحة وصف محتوى غير محظورة بواسطة جدار دفع.
جمع رقم التعريف وعنوان URL والاسم
فعليك إجراء ما يلي:
- اجمع أسماء المحتوى في قائمتك.
- حدِّد عناوين URL الأساسية للمحتوى. (ننصحك باستخدام
url المحتوى ك@id له).
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة 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`.)"]]
