כל הישויות בקטלוג צריכות לכלול את המאפיינים הבאים:
@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
שלו).