מפרט Schema.org לפודקאסטים

בקטע הזה מפורטים המאפיינים של רכיבי ה-Markup של התוכן בפודקאסטים.

מפרט PodcastSeries

PodcastSeries מייצג סדרת פודקאסטים, שנקראת גם 'תוכנית' של פודקאסט.

נכס עדיפות סוג תיאור
@context חובה טקסט ההקשר של Schema.org. תמיד מוגדר לערך [http://schema.googleapis.com,{@language}:xx}], כאשר xx צריך להיות בקוד השפה. כך מגדירים את שפת ברירת המחדל שתהיה בשימוש בערכי הטקסט של הישות.
@type חובה טקסט הערך תמיד מוגדר ל-PodcastSeries.
@id חובה טקסט מזהה ייחודי גלובלי של סדרת הפודקאסט בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל. הדומיין שמשמש לערך @id חייב להיות בבעלות הארגון.
url חובה טקסט כתובת ה-URL הקנונית באתר שלכם שבה מתוארת או מוצגת סדרת הפודקאסטים. השם חייב להיות ייחודי בהיקף גלובלי. הקישור הזה עוזר להתאים בצורה מדויקת את התוכן בפיד לתוכן במסדי הנתונים של Google. להפעלה, משתמשים ב-target.urlTemplate שמתואר בקטע ListenAction במסמכי העזרה.
name חובה טקסט

שם סדרת הפודקאסטים. מותר לכלול רק שם אחד לכל שפה.

משתמשים במערך כדי לסמן את התיאור בכמה שפות. לדוגמה: מספר אזורים ושפות

description חובה טקסט

סיכום של סדרת הפודקאסט.

משתמשים במערך כדי לסמן את התיאור בכמה שפות. דוגמה לשימוש בכמה שפות ובכמה אזורים

alternativeHeadline אופציונלי טקסט הכתוביות של סדרת הפודקאסט.
author חובה

אדם או ארגון

חוזרות

האדם או הקבוצה שמפתחים או מעבירים את התוכנית. לרוב מתייחס למארח. דוגמאות ופרטים נוספים זמינים במאמר ארגון, אדם (מחבר/בעלים).
publisher אופציונלי

אדם או ארגון

חוזרות

הקבוצה או הערוץ המקוריים שאחראים לפרסום התוכנית. בדרך כלל מתייחס לארגון שאחראי לפרסום או להפקה של כמה פודקאסטים. דוגמאות ופרטים נוספים זמינים במאמר ארגון, אדם (מחבר/בעלים). מומלץ מאוד למלא את השדה הזה לצורך הסרת עמימות, וצריך לספק אותו בכל מקרה שבו הוא רלוונטי.
actor אופציונלי

אדם או ארגון

חוזרות

המשתמש בפודקאסט. דוגמאות ופרטים נוספים זמינים בקטע שחקן (מארח/אורח) .
logo אופציונלי

ImageObject

חוזרות

תמונת לוגו של הסדרה. יש לספק את הפרטים האלה כ-ImageObject מפורט. יש לספק את התמונה ברזולוציה הגבוהה ביותר שזמינה. מומלץ להשתמש בפורמט JPEG או PNG. לפרטים נוספים ולדוגמאות, ראו הקטע ImageObject (לוגו).
image חובה

ImageObject

חוזרות

תמונה של הגרפיקה של הסדרה. יש לספק את הפרטים האלה כ-ImageObject מפורט. יש לספק את התמונה ברזולוציה הגבוהה ביותר שזמינה. עדיף להשתמש בפורמט JPEG או PNG. פרטים ודוגמאות מופיעים בקטע ImageObject (logo).
isFamilyFriendly חובה בוליאני מציין אם התוכן הזה ידידותי לכל המשפחה (כלומר, אם התוכן מתאים לכל בני המשפחה, כולל ילדים). ייתכן שמוצרי Google ישתמשו ב-isFamilyFriendly כדי לקבוע איזה תוכן להפעיל. הערך חייב להיות true או false.
inLanguage חובה טקסט השפה של תוכן הפודקאסט בפורמט ISO 639-1. אפשר להשתמש בערך הזה כדי לענות על שאילתות של משתמשים שמבקשות תוכן בשפה ספציפית.
genre חובה

טקסט

חוזרות

הקטגוריה או הז'אנר של סדרת הפודקאסט. לדוגמה, תוכלו לפעול לפי הקטגוריות הסטנדרטיות של פודקאסטים.
endDate אופציונלי תאריך התאריך שבו פרסמו את הפרק האחרון בסדרת הפודקאסט. יש לכלול את השדה הזה רק כשהסדרה כבר הסתיימה.
rssFeed חובה כתובת URL כתובת ה-URL של פיד ה-RSS של סדרת הפודקאסטים.
potentialAction חובה ListenAction הפעולה שתופעל כדי לאפשר למשתמשים להאזין לתוכן. פרטים נוספים זמינים במאמר ListenAction.
popularityScore אופציונלי PopularityScoreSpecification דירוג פופולריות שעוזר לקבוע את העדיפות להצגה כשיש כמה מועמדים. פרטים ודוגמאות מופיעים בקטע PopularityScoreSpecification (popularityScore).
keywords אופציונלי

טקסט

חוזרות

רשימה של מילות מפתח שיהיו משויכות לסדרת הפודקאסט. יכול להיות שנשתמש במילות המפתח האלה כדי להרחיב את שאילתות המשתמשים שיכולות להפעיל את סדרת הפודקאסטים הזו. לדוגמה, שמות של אורחים, נושאים שנדונים וכו'.
sameAs אופציונלי כתובת URL כתובת ה-URL של דף אינטרנט של צד שלישי (לא בדומיין שלכם) שמציין בבירור את הזהות של הפריט. דף האינטרנט הזה משמש לצורך הסרת עמימות כשיש כמה סדרות דומות. לדוגמה, דף בוויקיפדיה או דף הבית של סדרת הפודקאסט. מומלץ מאוד למלא את השדה הזה כדי להבהיר את הסדרה.
releasedEvent אופציונלי PublicationEvent, או תת-סוגים ספציפיים יותר – FeaturedEvent או ExclusiveEvent האירוע שמסמל את הפרסום או השקת סדרת הפודקאסט. אירוע פרסום יכול לציין את ההשקה הראשונית של פודקאסט על ידי בעל תוכן דיגיטלי, והסוגים המיוחדים יותר יכולים לשמש לציון הבלעדיות או החשיפה של ההשקה. לפרטים ולדוגמאות, ראו הקטע PublicationEvent,‏ FeaturedEvent, ‏ ExclusiveEvent (releasedEvent). חשוב לזכור: סימון סדרה כתוכנית בלעדית או כתוכנית נבחרת מתייחס לכל הפרקים של התוכנית.
countryOfOrigin אופציונלי מדינה המדינה שבה נמצאים המשרדים הראשיים של חברת ההפקה או האדם הפרטי שאחראי ל-podcast.

PodcastEpisode Spec

PodcastEpisode הוא הייצוג של פרק ב-schema.org בתוך PodcastSeries.

נכס עדיפות סוג תיאור
@context חובה טקסט ההקשר של Schema.org. תמיד מגדירים את הערך [http://schema.googleapis.com,{@language:xx}] כאשר xx הוא קוד השפה. ההגדרה הזו קובעת את שפת ברירת המחדל של התווים שתשמשנה לערכי הטקסט בפיד.
@type חובה טקסט הערך תמיד מוגדר ל-PodcastEpisode.
@id חובה טקסט מזהה ייחודי גלובלי של פרק הפודקאסט בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל. הארגון שלכם צריך להיות הבעלים של הדומיין שמשמש לערך @id.
url חובה טקסט כתובת ה-URL הקנונית באתר שלכם שבה אתם מציגים או מתארים את הפרק של הפודקאסט. הערך הזה חייב להיות ייחודי ברמת האתר. הקישור הזה משמש לצורך התאמה מדויקת של התוכן בפיד לתוכן במסדי הנתונים של Google. להפעלה, נעשה שימוש ב-target.urlTemplate שמתואר בקטע ListenAction במסמכים.
name חובה טקסט

השם של פרק הפודקאסט.

לכל שפה צריך להיות שם אחד בלבד. משתמשים במערך כדי לסמן את התיאור בכמה שפות. דוגמה למספר אזורים ושפות

description חובה טקסט תיאור של פרק הפודקאסט.
alternativeHeadline חובה טקסט כותרת המשנה של פרק הפודקאסט.
author חובה

אדם או ארגון

חוזרות

האדם או הקבוצה שמפתחים או מספקים את הפרק. בדרך כלל הערך הזה מתייחס למארח. אם המחבר זהה לתוכנית, תוכלו לעשות שימוש חוזר במידע מהישות PodcastSeries. דוגמאות ופרטים נוספים זמינים במאמר ארגון, אדם (מחבר/בעל תוכן דיגיטלי).
publisher חובה

אדם או ארגון

חוזרות

הקבוצה או הערוץ המקוריים שאחראים לפרסום התוכנית. בדרך כלל הכוונה לארגון שאחראי לפרסום או להפקה של כמה פודקאסטים. דוגמאות ופרטים נוספים זמינים במאמר ארגון, אדם (מחבר/בעלים). מומלץ מאוד להשתמש בשדה הזה כדי להסיר עמימות, ואנחנו ממליצים להגדיר אותו בכל מקרה שבו הוא רלוונטי.
actor חובה

אדם או ארגון

חוזרות

המשתמש בפודקאסט. דוגמאות ופרטים נוספים זמינים בקטע שחקן (מארח/אורח).
datePublished חובה תאריך ושעה תאריך ושעת הפרסום של פרק הפודקאסט. הערך הזה משמש למיון של רצף הפרקים ולפתרון עמימות.
episodeNumber חובה מספר שלם מספר הפרק.
partOfSeries חובה PodcastSeries ה-PodcastSeries שבו נמצא פרק הפודקאסט הזה. פרטים נוספים ודוגמאות זמינים במאמר PodcastSeries(partOfSeries).
partOfSeason אופציונלי PodcastSeason בסדרות עם כמה עונות, המאפיין הזה מספק את פרטי העונה, יחד עם מספר העונה ושם העונה. לפרטים ולדוגמאות, אפשר לעיין במאמר PodcastSeason(partOfSeason).
timeRequired חובה משך אורך הפרק בפורמט משך זמן של ISO 8601.
image אופציונלי

ImageObject

חוזרות

תמונה של הגרפיקה של הסדרה. זה חייב להיות ImageObject שמתואר במלואו. יש לספק את התמונה ברזולוציה הגבוהה ביותר שזמינה. מומלץ להשתמש בפורמט JPEG או PNG. פרטים ודוגמאות מופיעים בקטע ImageObject (logo).
isFamilyFriendly חובה בוליאני מציין אם התוכן הזה מתאים לכל המשפחה (כלומר, אם התוכן מתאים לכל חברי המשפחה, כולל ילדים). מוצרים של Google עשויים להשתמש ב-isFamilyFriendly כדי לקבוע את התוכן להפעלה. הערך חייב להיות true או false.
inLanguage חובה טקסט שפת התוכן של פרק הפודקאסט בפורמט ISO 639-1. משתמשים בערך הזה כדי לענות לשאילתות של משתמשים שמבקשים תוכן בשפה ספציפית. אם התוכן זמין בכמה שפות, יש לציין רק שפה ראשית אחת.
genre חובה

טקסט

חוזרות

הקטגוריה או הז'אנר של סדרת הפודקאסט. לדוגמה, אתם יכולים לעקוב אחרי קטגוריות רגילות של פודקאסטים.
associatedMedia אופציונלי AudioObject קובץ האודיו של פרק הפודקאסט. לפרטים נוספים ולעיון בדוגמאות, ראו AudioObject(associatedMedia).
potentialAction חובה ListenAction הפעולה שתופעל כדי לאפשר למשתמשים להאזין לתוכן. פרטים נוספים זמינים בקטע ListenAction.
popularityScore אופציונלי PopularityScoreSpecification דירוג פופולריות כדי לקבוע את העדיפות להצגה כשיש כמה מועמדים. לפרטים נוספים ולעיון בדוגמאות, ראו הקטע PopularityScoreSpecification.
keywords אופציונלי

טקסט

חוזרות

רשימה של מילות מפתח שמשויכות לסדרת הפודקאסט. יכול להיות שמילות המפתח האלה ישמשו להרחבת שאילתות המשתמשים שיכולות להפעיל את פרק הפודקאסט הזה. לדוגמה, news, sports או history.
identifier חובה

PropertyValue

חוזרות

בשדה PodcastEpisode, משתמשים במאפיין הזה כדי לספק מזהה GUID. ה-GUID צריך להיות מזהה שיכול לזהות באופן ייחודי וגלובלי את הפרקים של הפודקאסט. הוא שונה מהשדה @id בפרק.

לדוגמה, ראו את הקטע PropertyValue (מזהה).

sameAs אופציונלי כתובת URL כתובת ה-URL של דף אינטרנט של צד שלישי (לא בדומיין שלכם) שמציין בבירור את הזהות של הפריט. Google משתמשת בדף האינטרנט הזה כדי לבצע הסרת עמימות כשיש כמה סדרות דומות. לדוגמה, דף בוויקיפדיה או דף הבית של פרקי הפודקאסט. חשוב לזכור שאין לספק כאן את דף העזרה ברמת הסדרה. אנחנו מומלצים מאוד למלא את השדה הזה כדי להבדיל בין פרקים בעלי שמות דומים.
releasedEvent אופציונלי PublicationEvent, או תת-סוגים ספציפיים יותר – FeaturedEvent או ExclusiveEvent האירוע שמסמל את הפרסום או השקת הפרק של הפודקאסט. אירוע פרסום יכול לציין את הפרסום הראשוני של פרק פודקאסט על ידי בעל התוכן הדיגיטלי, וסוגים משניים ספציפיים יותר יכולים לציין את הבלעדיות או את העובדה שהפרק מוצג בתכונה. לפרטים נוספים ולדוגמאות, ראו הקטע PublicationEvent, ‏ FeaturedEvent, ‏ ExclusiveEvent (releasedEvent). חשוב לזכור: סימון סדרה כ'בלעדית' או כ'מומלצת' כפי שמתואר למעלה מתייחס לכל הפרקים של התוכנית. מומלץ לסמן נכסים כאלה ברמה המפורטת ביותר.
countryOfOrigin אופציונלי מדינה המדינה שבה נמצאים המשרדים הראשיים של חברת ההפקה או האדם הפרטי שאחראים על הפודקאסט.

PodcastSeries‏ (partOfSeries)

משתמשים ב-partOfSeries כדי ליצור את הקשר בין PodcastEpisode לבין ההורה שלו PodcastSeries. מכיוון שהפרטים המלאים של PodcastSeries מתוארים בישויות PodcastSeries הנפרדות, אין צורך לספק פרטים מלאים ב-partOfSeries. צריך לספק רק את המאפיינים הבאים:

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-PodcastSeries.
@id חובה כתובת URL המזהה הייחודי והגלובלי של הסדרה בפורמט URI. המזהה צריך להתאים למזהה של הישות המלאה PodcastSeries בפיד.
name חובה טקסט השם של סדרת הפודקאסטים.

דוגמה 1

"partOfSeries": {
  "@type": "PodcastSeries",
  "@id": "http://www.tjpodcast.org/series?id=1",
  "name": "Radiolab"
},

PodcastSeason‏ (partOfSeason)

השדה PodcastSeason מייצג את פרטי העונה של PodcastEpisode, והחשוב שבהם הוא מספר העונה. צריך לציין את המאפיין הזה רק אם לסדרת הפודקאסט יש כמה עונות.

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד מוגדר כ-PodcastSeason
@id חובה כתובת URL מזהה ייחודי וגלובלי של העונה בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל.
seasonNumber חובה מספר שלם מספר העונה של סדרת הפודקאסט.
name אופציונלי טקסט שם העונה של הפודקאסט.

דוגמה 1

"partOfSeason": {
  "@type": "PodcastSeason",
  "@id": "http://www.tjpodcast.org/seriesx/season?id=1",
  "seasonNumber": 1,
  "name": "Radiolab Season 1"
},

ארגון, אדם (מחבר או בעל תוכן דיגיטלי)

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד צריך להגדיר את הערך Organization או Person.
@id חובה כתובת URL מזהה ייחודי גלובלי של הארגון או האדם, בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל.
name חובה טקסט השם של הארגון או של האדם.
sameAs אופציונלי כתובת URL כתובת ה-URL של דף אינטרנט של צד שלישי (לא בדומיין שלכם) שמציין בבירור את זהות הפריט. Google משתמשת בדף האינטרנט הזה כדי לבצע הסרת עמימות כשיש כמה סדרות דומות. דוגמאות לכך יכולות להיות דף של ארגון בוויקיפדיה או האתר הרשמי של הארגון.

דוגמה 1

"author": {
  "@type": "Organization",
  "@id": "https://www.tjpodcast.org/organization/wnyc",
  "sameAs": "https://en.wikipedia.org/wiki/WNYC",
  "name": "WNYC"
},

דוגמה 2

"author": {
  "@type": "Person",
  "@id": "https://www.tjpodcast.org/person/jad_abumrad",
  "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad",
  "name": "Jad Abumrad"
},

משתמש (מארח או אורח)

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד צריך להגדיר את הערך Organization או Person.
@id חובה כתובת URL מזהה ייחודי גלובלי של הארגון או האדם, בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה ולא חייב להיות קישור פעיל.
name חובה טקסט השם של הארגון או האדם.
roleName חובה טקסט 'מארח' או 'אורח'.
sameAs אופציונלי כתובת URL כתובת ה-URL של דף אינטרנט של צד שלישי (לא בדומיין שלכם) שמציין בבירור את הזהות של הפריט. Google משתמשת בדף האינטרנט הזה כדי לבצע הסרת עמימות כשיש כמה סדרות דומות. דוגמאות לכך יכולות להיות דף של ארגון בוויקיפדיה או האתר הרשמי של הארגון.

דוגמה 1

"actor":[{
  "@type": "PerformanceRole",
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/Roman",
    "name": {
      "@language":"en",
      "@value": "Roman Mars"
    },
    "roleName": "Host"
    "sameAs": "https://en.wikipedia.org/wiki/Roman",
  },
  "actor": {
    "@type": "Person",
    "@id": "https://www.tjpodcast.org/person/guest",
    "name":{
      "@language":"en",
      "@value": "Kurt Kohlstedt"
    },
    "roleName": "Guest"
   },
}]

ImageObject (לוגו או תמונה)

השדה ImageObject משמש כדי לספק את הלוגו או את הגרפיקה של התוכן.

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-ImageObject.
height אופציונלי מספר שלם גובה התמונה בפיקסלים.
width אופציונלי מספר שלם רוחב התמונה בפיקסלים.
contentUrl חובה כתובת URL כתובת URL שבה אפשר למצוא את התמונה.
regionsAllowed אופציונלי

מדינה

חוזרות

המדינות שבהן מותר להציג את המדיה:

  • אם לא צוין לוקאל, המערכת תשתמש בלוקאל שמוגדר למסמך.
  • כדי לשלוח תמונות שונות לכל אזור, מוסיפים כמה נכסי ImageObject, לכל אחד מהם קבוצה משלו של מדינות וכתובת URL מתאימה של תמונה.

מדינה (image.regionsAllowed)

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד מוגדר כ-Country.
name חובה טקסט קוד המדינה לפי תקן ISO 3166-1 alpha-2. לדוגמה, GB,‏US.

דוגמה 1

"logo": {
  "@type": "ImageObject",
  "height": "100",
  "width": "800",
  "contentUrl": "http://www.foo.com/img/67890.jpg",
},

דוגמה 2

"logo": [
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/67890.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "US"
      },
      {
        "@type": "Country",
        "name": "GB"
      }
    ]
  },
  {
    "@type": "ImageObject",
    "height": "100",
    "width": "800",
    "contentUrl": "http://www.foo.com/img/12345.jpg",
    "regionsAllowed": [
      {
        "@type": "Country",
        "name": "IN"
      },
      {
        "@type": "Country",
        "name": "PK"
      }
    ]
  },
],

PropertyValue (מזהה)

אם יש לכם מזהי GUID לתוכן, תוכלו לספק את המזהים האלה באמצעות השדה identifier כדי לשפר את הדיוק של התאמת התוכן על ידי Google. חשוב לזכור שה-GUID נדרש עבור PodcastEpisode. השדה הזה חייב להיות שונה מהשדה @id של הפרק (לא בתוך הדומיין שלכם) ומייצג את פרק המקור באופן גלובלי וייחודי לאורך זמן, במגוון מקורות.

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד מוגדר ל-'PropertyValue'.
propertyID חובה טקסט הערך תמיד מוגדר ל-GUID.
value חובה טקסט מזהה ה-GUID של הסדרה או הפרק.

דוגמה 1

"identifier": {
  "@type": "PropertyValue",
  "propertyID": "GUID",
  "value": "50204fe4-bc68-4b34-aae6-e73c700cc5ca"
},

PopularityScoreSpecification‏ (popularityScore)

השדה popularityScore יכול לעזור למשתמשים להגיע לתוכן המתאים ביותר, בתרחישים שבהם הקריטריונים משאילתת המשתמש תואמים לכמה ישויות מהפיד. כשהערך הזה זמין, המערכת מציגה למשתמש את התוכן עם דירוג הפופולריות הגבוה ביותר שזמין לאזור שלו. כל התוכן ללא השדה הזה מוגדר כברירת מחדל עם ציון פופולריות 0. ההשוואה של הציונים מתבצעת בהיקף הקטלוג המלא, לכן חשוב לוודא שהסולם זהה בכל הפידים.

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-PopularityScoreSpecification.
value חובה Numeric ערך מספרי חיובי שישמש להשוואה עם ישויות אחרות מהקטלוג לצורך קביעת תעדוף הצגה. ככל שהמספר גבוה יותר, כך הפופולריות גבוהה יותר.
eligibleRegion אופציונלי

מדינה או טקסט

חוזרות

אזור אחד או רשימה של האזורים שבהם דירוג הפופולריות הזה רלוונטי.

אם דירוג הפופולריות רלוונטי ברמה הגלובלית, צריך להשתמש ב-earth בתור ערך הטקסט.

אם צריך לציין אזורים ספציפיים, יש להשתמש בסוג 'מדינה'.

אם השדה הזה לא יהיה מוגדר, הערך שמוגדר כברירת מחדל בשדה eligibleRegion הוא earth.

מדינה (popularityScore.eligibleRegion)

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-Country.
name חובה טקסט קוד המדינה לפי תקן ISO 3166-1 alpha-2. לדוגמה, GB,‏US.

דוגמה 1

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 4.3,
  "eligibleRegion": "Earth"
},

דוגמה 2

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 2,
  "eligibleRegion": {
    "@type": "Country",
    "name": "US"
  }
},

דוגמה 3

"popularityScore": {
  "@type": "PopularityScoreSpecification",
  "value": 101,
  "eligibleRegion": [
    {
      "@type": "Country",
      "name": "US"
    },
    {
      "@type": "Country",
      "name": "GB"
    }
  ]
},

PublicationEvent, ‏ FeaturedEvent, ‏ ExclusiveEvent (releasedEvent)

PublicationEvent
משתמשים באובייקט הזה כדי לייצג את התאריך והמיקום של פרסום תוכנית או פרק (נקרא גם 'תאריך ההשקה' של הסדרה או הפרק). בנוסף, השדה publishedBy מציין את הישות שמפרסמת או מפיצה את הסדרה או את הפרק של הפודקאסט.
ExclusiveEvent
משתמשים באובייקט הזה כדי לציין שלספק יש זכויות הפצה בלעדיות על הפודקאסט. הבלעדיות יכולה להיות ספציפית לאזור ומותנית בזמן, וצריך לכלול את השדה 'ארגון' שמצביע על הספק הבלעדי של התוכן.
FeaturedEvent
השתמשו באובייקט הזה כדי לציין שהספק מציג את הפודקאסט לצרכנים (לדוגמה, כתוכן 'מקורי').
'תוכניות מקור' שונה מ'תוכניות בלעדיות'
המונח 'תוכן מקורי (מומלץ)' מציין בדרך כלל זכויות בלעדיות על ישות מסוימת, מה שמעמיס על המונח. לכן, צריך לפצל את המשמעות המיועדת לשתי הקטגוריות שלמעלה. ישות מקורית יכולה גם להיות בלעדית, ובמקרה כזה, ה-releasedEvent יכול לקבל מערך עם שני סוגי האירועים באותה ישות.

חשוב לזכור שלמרות שלתכונות 'בלעדי' ו'מומלץ' יכולות להיות משמעויות דומות בקטלוג של ספק, הערך PublicationEvent רלוונטי באופן כללי יותר כדי לאפשר הסרת עמימות של ישויות ולספק מטא-נתונים נוספים לגביהן, כמו תאריך הפרסום של סדרה או פרק.

נכס עדיפות סוג תיאור
@type חובה טקסט תמיד מגדירים את הערך לאחד מהערכים הבאים: PublicationEvent,‏ ExclusiveEvent או FeaturedEvent.
location חובה מדינה האזור שבו מתרחש אירוע הפרסום. אפשר גם להשתמש בו כדי לייצג את הגבלות הבלעדיות וההפצה של הישות. צריך להשתמש בקודים של המדינה לפי תקן ISO 3166. אם צריך להחיל סמנטיקה גלובלית, מגדירים את הערך EARTH. מגדירים במפורש את הערך של location כ-EARTH, במקרה שהמגבלות הספציפיות ללוקאל לא רלוונטיות.
startDate מומלץ (חובה ל-ExclusiveEvent) תאריך או DateTime תאריך ההתחלה של פרסום הישות. במקרה של PublicationEvent, זהו תאריך הפרסום הראשוני של הישות הזו. במקרה של ExclusiveEvent או FeaturedEvent, זהו תאריך ההתחלה של הבלעדיות או של החשיפה של הישות.
endDate מומלץ (חובה ל-ExclusiveEvent) תאריך או DateTime תאריך הסיום של פרסום הישות. במקרה של PublicationEvent, זהו תאריך הפרסום הסופי של הישות הזו. במקרה של ExclusiveEvent או FeaturedEvent, זהו תאריך הסיום של הבלעדיות או של החשיפה של הישות.
publishedBy חובה ארגון או אדם הישות מסוג Organization או Person שמפרסמת את הישות הזו שחלה על אירוע הפרסום הזה. צריך להשתמש באותה סכימה שמתוארת בקטע ארגון (מחבר/בעל תוכן דיגיטלי).

דוגמה 1

"releasedEvent": [ {
  "@type": "PublicationEvent",
  "location": "EARTH",
  "startDate": "2016-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/wnyc",
    "sameAs": "https://en.wikipedia.org/wiki/WNYC",
    "name": "WNYC"
  },
 }, {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 },
]

דוגמה 2

"releasedEvent": [ {
  "@type": "FeaturedEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-05-21T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "US",
  "startDate": "2020-04-18T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }, {
  "@type": "ExclusiveEvent",
  "location": "CA",
  "startDate": "2020-04-21T20:00",
  "endDate": "2020-04-24T20:00",
  "publishedBy": {
    "@type": "Organization",
    "@id": "https://www.tjpodcast.org/organization/tjpodcast",
    "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
    "name": "TJPodcast",
  },
 }
]

AudioObject‏ (associatedMedia)

השדה AudioObject משמש לספק את קובץ המדיה הגולמי של פרק הפודקאסט.

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-AudioObject.
contentUrl חובה כתובת URL כתובת ה-URL של קובץ המדיה.
contentSize חובה מספר שלם הגודל של קובץ המדיה בבייטים.
encodingFormat חובה טקסט סוגי המדיה של IANA בקובץ המדיה. לדוגמה audio/mpeg.
duration חובה משך אורך המדיה בפורמט משך זמן של ISO 8601.
transcript אופציונלי טקסט תמליל של הפרק.
bitrate אופציונלי טקסט קצב הנתונים של קובץ המדיה.
name אופציונלי טקסט השם של קובץ המדיה.

דוגמה 1

"associatedMedia": {
    "@type": "AudioObject",
    "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
    "duration": "PT5M32S",
    "contentSize": "53616000",
    "encodingFormat": "audio/mpeg",
    "name": "radiolab_podcast19.mp3",
    "transcript": "Transcript of the episode",
    "bitrate": "64Kbps"
},

ListenAction‏ (potentialAction)

הישות ListenAction מגדירה את הקישורים העמוקים להפעלה ואת הקריטריונים של המשתמשים (למשל, מיקום גיאוגרפי, כרונולוגיה, התחברות או סטטוס מינוי) כדי לגשת לתוכן.

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-ListenAction.
target חובה

EntryPoint

חוזרות

המפרטים של קישור העומק עם פרטי הפלטפורמה הנתמכת. אפשר להשתמש במספר שדות EntryPoint כדי להגדיר קישורי עומק שונים לקבוצות שונות של פלטפורמות.
actionAccessibilityRequirement חובה

ActionAccessSpecification

חוזרות

ההגדרה של דרישות המשתמשים לגישה לישות הזו. אם יש כמה ActionAccessSpecification, כל משתמש שעומד בקריטריונים כלשהם של המפרט יכול לגשת לתוכן.

נקודת כניסה (potentialAction.target)

table class="fixed"> נכס תעדוף סוג תיאור @type חובה טקסט תמיד מוגדר לערך EntryPoint. urlTemplate חובה כתובת URL הקישור שמשמש להפעלת התוכן. actionPlatform חובה

טקסט

חוזרות

הפלטפורמה שבה קישור העומק הזה תקף. הערכים הבאים אפשריים:

  • "http://schema.org/DesktopWebPlatform"
  • "http://schema.org/MobileWebPlatform"
  • "http://schema.org/AndroidPlatform"
  • "http://schema.org/AndroidTVPlatform"
  • "http://schema.org/IOSPlatform"
  • "http://schema.googleapis.com/GoogleAudioCast"
  • "http://schema.googleapis.com/GoogleVideoCast"

ActionAccessSpecification‏ (potentialAction.actionAccessibilityRequirement)

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-ActionAccessSpecification.
category חובה טקסט

סוג דרישת הגישה. הערך צריך להיות אחד מהערכים הבאים:

  • nologinrequired: הפעולה זמינה למשתמש ללא צורך ברכישה או בהתחברות כדי לגשת לתוכן.
  • free: הפעולה זמינה ללא רכישה או מינוי בתשלום. כדי לבצע את הפעולה, המשתמש צריך להתחבר לחשבון.
  • subscription: הפעולה כלולה במינוי בתשלום לשירות.
availabilityStarts אופציונלי תאריך ושעה שעת ההתחלה של חלון הזמינות. כך תוכלו לקבוע את המועד המדויק שבו התוכן הזה יוצג למשתמשים.
availabilityEnds אופציונלי תאריך ושעה שעת הסיום של חלון הזמינות. כך תוכלו לקבוע את המועד המדויק שבו התוכן הזה יפסיק להיות מוצג למשתמשים.
eligibleRegion חובה

מדינה

חוזרות

המדינה שעומדת בדרישות של המבצע הזה. בעזרת המאפיין הזה תוכלו לקבוע את המדינה או האזור שבהם התוכן הזה חייב להיות זמין.
requiresSubscription חובה אם רלוונטי MediaSubscription חבילת המינוי הנדרשת כדי לגשת לתוכן הזה. אם השירות שלכם מציע כמה חבילות מינויים, השדה הזה הוא חובה. אם השירות שלכם בחינם או שיש רק רמה אחת של מינוי, אפשר לדלג על השדה הזה.

מדינה (potentialAction.actionAccessibilityRequirement.eligibleRegion)

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-Country.
name חובה טקסט קוד המדינה לפי תקן ISO 3166-1 alpha 2.

MediaSubscription‏ (potentialAction.actionAccessibilityRequirement.requiresSubscription)

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-MediaSubscription.
@id חובה כתובת URL מזהה ייחודי וגלובלי לחבילת המינוי בפורמט URI. המזהה צריך להיות יציב ולא להשתנות לאורך זמן. הוא מטופל כמחרוזת אטומה, ולא חייב להיות קישור פעיל.
name חובה טקסט השם של חבילת המינוי. לדוגמה: Premium, Basic.
expectsAcceptanceOf מומלץ ההצעה המבצע שמשויך לרכישה של מינוי המדיה. אפשר להשתמש בו כדי לציין את מחיר המינוי.

מבצע (potentialAction.actionAccessibilityRequirement.requiresSubscription.expectsAcceptanceOf)

נכס עדיפות סוג תיאור
@type חובה טקסט הערך תמיד מוגדר ל-Offer.
price חובה מספר מחיר המינוי.
priceCurrency חובה טקסט המטבע (בפורמט ISO 4217 בן 3 אותיות) של המחיר.
seller מומלץ ארגון הארגון שמציע את המינוי או את הרכישה של הפעולה. משתמשים באותה סכימה שמתוארת בקטע ארגון (מחבר/בעל תוכן דיגיטלי).

דוגמה 1

"potentialAction": {
    "@type": "ListenAction",
    "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
        "actionPlatform": [
            "http://schema.org/DesktopWebPlatform",
            "http://schema.org/MobileWebPlatform",
            "http://schema.org/AndroidPlatform",
            "http://schema.org/AndroidTVPlatform",
            "http://schema.org/IOSPlatform",
            "http://schema.googleapis.com/GoogleAudioCast",
            "http://schema.googleapis.com/GoogleVideoCast"
        ]
    },
    "actionAccessibilityRequirement": {
        "@type": "ActionAccessSpecification",
        "category": "nologinrequired",
        "availabilityStarts": "2018-04-01T11:01:00-04:00",
        "availabilityEnds": "2018-06-30T23:59:00-04:00",
        "eligibleRegion": {
            "@type": "Country",
            "name": "US"
        }
    }
},

דוגמה 2

"potentialAction": {
    "@type": "ListenAction",
    "target": [
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/?streamStationId=170",
            "actionPlatform": [
                "http://schema.org/DesktopWebPlatform",
                "http://schema.org/MobileWebPlatform",
                "http://schema.org/AndroidPlatform",
                "http://schema.org/AndroidTVPlatform",
                "http://schema.org/IOSPlatform"
            ]
        },
        {
            "@type": "EntryPoint",
            "urlTemplate": "https://www.tjpodcast.org/castlink?streamStationId=170",
            "actionPlatform": [
                "http://schema.googleapis.com/GoogleAudioCast",
                "http://schema.googleapis.com/GoogleVideoCast"
            ]
        }
    ],
    "actionAccessibilityRequirement": [
        {
            "@type": "ActionAccessSpecification",
            "category": "nologinrequired",
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": [
                {
                    "@type": "Country",
                    "name": "IN"
                },
                {
                    "@type": "Country",
                    "name": "GB"
                }
            ]
        },
        {
            "@type": "ActionAccessSpecification",
            "category": "Subscription",
            "requiresSubscription": {
                "@type": "MediaSubscription",
                "@id": "http://www.example.com/packages/basic-pack",
                "name": "Basic Pack",
                "expectsAcceptanceOf": {
                    "@type": "Offer",
                    "price": 8.99,
                    "priceCurrency": "USD"
                }
            },
            "availabilityStarts": "2018-04-01T11:01:00-04:00",
            "availabilityEnds": "2018-06-30T23:59:00-04:00",
            "eligibleRegion": {
                "@type": "Country",
                "name": "US"
            }
        }
    ]
},

נספח

דוגמה מלאה

{
    "@context": "http://schema.org",
    "@type": "DataFeed",
    "dateModified": "2018-09-10T13:58:26.892Z",
    "dataFeedElement": [
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastSeries",
            "@id": "http://www.tjpodcast.org/series?id=2",
            "url": "http://www.tjpodcast.org/series?id=2",
            "name": "Radiolab",
            "description": "A two-time Peabody Award-winner...",
            "alternativeHeadline": "Radiolab - Powered by WNYC",
            "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2.jpg"
            },
            "logo": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/logo/2/1.jpg"
            },
            "keywords": [
                "Science",
                "Technology",
                "Philosophy",
                "Education"
            ],
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "inLanguage": "en",
            "genre": [
                "Science & Medicine",
                "Natural Sciences"
            ],
            "endDate": "2017-12-22T08:59:00",
            "rssFeed": "http://feeds.wnyc.org/radiolab",
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamSeriesId=2",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 4.2
            }
        },
        {
            "@context": [
                "http://schema.googleapis.com",
                {
                    "@language": "en"
                }
            ],
            "@type": "PodcastEpisode",
            "@id": "http://www.tjpodcast.org/episode?id=1",
            "url": "http://www.tjpodcast.org/episode?id=1",
            "name": "A Clockwork Miracle",
            "description": "As legend goes, in 1562, King Philip II...",
            "sameAs": "https://www.wnycstudios.org/story/radiolab-clockwork-miracle",
            "image": {
                "@type": "ImageObject",
                "height": "100",
                "width": "800",
                "contentUrl": "http://www.tjpodcast.org/img/2/1.jpg"
            },
            "keywords": [
                "Education",
                "Philosophy",
                "Science",
            ],
            "partOfSeries": {
                "@type": "PodcastSeries",
                "@id": "http://www.tjpodcast.org/series?id=2",
                "name": "Radiolab",
                "sameAs": "https://en.wikipedia.org/wiki/Radiolab",
            },
            "episodeNumber": 101,
            "inLanguage": "en",
            "author": [
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/jad_abumrad",
                    "name": "Jad Abumrad",
                    "sameAs": "https://en.wikipedia.org/wiki/Jad_Abumrad"
                },
                {
                    "@type": "Person",
                    "@id": "https://www.tjpodcast.org/author/robert_krulwich",
                    "name": "Robert Krulwich",
                    "sameAs": "https://en.wikipedia.org/wiki/Robert_Krulwich"
                }
            ],
            "publisher": {
                "@type": "Organization",
                "name": "WNYC",
                "@id": "https://www.tjpodcast.org/network/wnyc_studios",
                "sameAs": "https://en.wikipedia.org/wiki/WNYC_Studios"
            },
            "isFamilyFriendly": "True",
            "genre": [
                "Science",
                "Philosophy",
                "Fiction"
            ],
            "datePublished": "2018-12-27T23:23:00Z",
            "timeRequired": "PT22M",
            "associatedMedia": {
                "@type": "AudioObject",
                "contentUrl": "https://www.tjpodcast.org/media_files/mp3/radiolab_podcast19.mp3",
                "duration": "PT21M45S",
                "contentSize": "53616000",
                "encodingFormat": "audio/mpeg",
                "transcript": "Transcript of the episode",
                "bitrate": "64Kbps"
            },
            "potentialAction": {
                "@type": "ListenAction",
                "target": {
                    "@type": "EntryPoint",
                    "urlTemplate": "https://www.tjpodcast.org/?streamEpisodeId=1",
                    "actionPlatform": [
                        "http://schema.org/DesktopWebPlatform",
                        "http://schema.org/MobileWebPlatform",
                        "http://schema.googleapis.com/GoogleAudioCast",
                        "http://schema.googleapis.com/GoogleVideoCast"
                    ]
                },
                "actionAccessibilityRequirement": {
                    "@type": "ActionAccessSpecification",
                    "category": "nologinrequired",
                    "availabilityStarts": "2018-04-01T11:01:00-04:00",
                    "availabilityEnds": "2019-12-30T23:59:00-04:00",
                    "eligibleRegion": {
                        "@type": "Country",
                        "name": "FR"
                    }
                }
            },
            "popularityScore": {
                "@type": "PopularityScoreSpecification",
                "value": 3.8
            },
            "identifier": [
                {
                    "@type": "PropertyValue",
                    "propertyID": "GUID",
                    "value": "53ff386e-e768-40b5-8854-1b7415826ded"
                }
            ]
        }
    ],
    "actor": [
        {
            "@type": "PerformanceRole",
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/Roman",
                "name": {
                    "@language": "en",
                    "@value": "Roman Mars"
                },
                "roleName": "Host",
                "sameAs": "https://en.wikipedia.org/wiki/Roman"
            },
            "actor": {
                "@type": "Person",
                "@id": "https://www.tjpodcast.org/person/guest",
                "name": {
                    "@language": "en",
                    "@value": "Kurt Kohlstedt"
                },
                "roleName": "Guest"
            }
        }
    ],
    "releasedEvent": [
        {
            "@type": "FeaturedEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-05-21T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "US",
            "startDate": "2020-04-18T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        },
        {
            "@type": "ExclusiveEvent",
            "location": "CA",
            "startDate": "2020-04-21T20:00",
            "endDate": "2020-04-24T20:00",
            "publishedBy": {
                "@type": "Organization",
                "@id": "https://www.tjpodcast.org/organization/tjpodcast",
                "sameAs": "https://en.wikipedia.org/wiki/tjpodcast",
                "name": "TJPodcast"
            }
        }
    ]
}