לאסוף את המזהה, כתובת ה-URL והשם של התוכן.

באופן כללי, ישויות תוכן בקטלוג צריכות לכלול את המאפיינים הבאים:

• ‫@id: מזהה גלובלי של הישות.
• ‫url: כתובת URL קנונית של התוכן. אל תשתמשו ב-url בישויות של BroadcastEvent,‏ SportsEvent או חבילות ערוצים (TelevisionChannel ו-CableOrSatelliteService).
• ‫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) עוזרת ל-Google להתאים בצורה מדויקת בין התוכן בקטלוג לבין התוכן במסדי הנתונים של Google.

"כתובת URL קנונית היא כתובת ה-URL של הדף שלדעת Google מייצג בצורה הטובה ביותר קבוצה של דפים משוכפלים באתר שלכם. לדוגמה, אם יש לכם כתובות URL לאותו דף (למשל: example.com?dress=1234 ו-example.com/dresses/1234), Google תבחר באחת מהן ככתובת הקנונית. (מקור: איחוד כתובות URL כפולות)

אלה הדרישות לגבי כתובת ה-URL הקנונית:

• הערך של url חייב להיות ייחודי באופן גלובלי.
• המאפיין url חייב להכיל כתובת URL קנונית תקינה ש-Google יכולה לסרוק.
• (פעולות האזנה בלבד) url צריך להפנות לדף תיאור תוכן שלא חסום על ידי חומת תשלום.
• (טלוויזיה בשידור חי) אל תכללו ישויות של url ב-BroadcastEvent. בשידורי טלוויזיה וסרטים, צריך לציין את url בישות הבסיסית של Movie, TVSeries או TVEpisode.
• (ספורט) אל תכללו את url בישויות של SportsEvent. צריך לספק קישורים להפעלה באמצעות SportsEvent.potentialAction.
• (טלוויזיה בשידור חי וספורט) צריך לוודא שהערך של BroadcastEvent.@id שונה מהערך של @id בישות Movie,‏ TVSeries,‏ TVEpisode או SportsEvent שאליה מפנים.

איסוף המזהה, כתובת ה-URL והשם

בצע את הפעולות הבאות:

1. אוספים את שמות התכנים בקטלוג.
2. מזהים את כתובות ה-URL הקנוניות של התוכן. (מומלץ להשתמש ב-url של התוכן בתור @id.)