לאסוף את המזהה, כתובת ה-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)
- אם המזהה המקומי (ID) של התוכן לא בפורמט URI, צריך להוסיף את הדומיין למזהה כדי לעמוד בדרישות. לדוגמה, אם המזהה של התוכן הוא 1234abc והדומיין הוא https://example.com, הערך של
@id יכול להיות https://example.com/1234abc.
@id לא חייבת להיות כתובת URL שפועלת, היא רק צריכה להיות בפורמט URI.- הדומיין שמצוין ב-
@id (לדוגמה, https://example.com) חייב להיות בבעלות הארגון.
מכיוון שהשדה url של ישות עומד בכל הדרישות כמזהה (כלומר, הוא ייחודי גלובלי, סטטי ובפורמט URI), מומלץ להשתמש בשדה url של הישות בתור @id.
כתובת אתר קנונית
כתובת 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`.)"]]
