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