בקטע הזה מפורטים המאפיינים של רכיבי ה-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 מפורט. יש לספק את התמונה ברזולוציה הגבוהה ביותר שזמינה. מומלץ להשתמש בפורמט JPEG או PNG. לפרטים נוספים ולדוגמאות, ראו הקטע ImageObject (לוגו). |
image |
חובה | חוזרות |
תמונה של הגרפיקה של הסדרה. יש לספק את הפרטים האלה כ-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 שמתואר במלואו. יש לספק את התמונה ברזולוציה הגבוהה ביותר שזמינה. מומלץ להשתמש בפורמט 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 חוזרות |
בשדה לדוגמה, ראו את הקטע 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 |
אופציונלי | מדינה חוזרות |
המדינות שבהן מותר להציג את המדיה:
|
מדינה (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 |
אופציונלי | מדינה או טקסט חוזרות |
אזור אחד או רשימה של האזורים שבהם דירוג הפופולריות הזה רלוונטי. אם דירוג הפופולריות רלוונטי ברמה הגלובלית, צריך להשתמש ב- אם צריך לציין אזורים ספציפיים, יש להשתמש בסוג 'מדינה'. אם השדה הזה לא יהיה מוגדר, הערך שמוגדר כברירת מחדל בשדה |
מדינה (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 כדי להגדיר קישורי עומק שונים לקבוצות שונות של פלטפורמות. |
actionAccessibilityRequirement |
חובה |
חוזרות |
ההגדרה של דרישות המשתמשים לגישה לישות הזו. אם יש כמה ActionAccessSpecification , כל משתמש שעומד בקריטריונים כלשהם של המפרט יכול לגשת לתוכן. |
נקודת כניסה (potentialAction.target)
@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 |
חובה | טקסט |
סוג דרישת הגישה. הערך צריך להיות אחד מהערכים הבאים:
|
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"
}
}
]
}